README file from
GithubSansConverter for Obsidian
An Obsidian plugin for converting between Sanskrit transliteration encodings. Based on the SansConverter desktop app.
Supported Encodings
- IAST (International Alphabet of Sanskrit Transliteration)
- Balaram (used in many Vaiṣṇava publications, legacy)
- Harvard-Kyoto (ASCII-friendly encoding)
- Velthius (ASCII-friendly encoding using digraphs)
- Ukrainian IAST (Cyrillic-based transliteration)
Available Conversions
| From | To |
|---|---|
| Harvard-Kyoto | IAST |
| Harvard-Kyoto | Ukrainian |
| Velthius | IAST |
| Velthius | Ukrainian |
| Balaram (legacy) | IAST |
| Balaram (legacy) | Ukrainian |
| IAST | Balaram (legacy) |
| IAST | Ukrainian |
| IAST | Harvard-Kyoto |
| Ukrainian | IAST |
Installation
Manual Installation
- Download
main.jsandmanifest.jsonfrom the latest release - Create a folder
<vault>/.obsidian/plugins/sansconverter/and place both files there - Reload Obsidian
- Go to Settings → Community plugins and enable "SansConverter"
Using BRAT (Beta Reviewers Auto-update Tester)
- Install BRAT from Community Plugins
- Open BRAT settings and click "Add Beta plugin"
- Enter this repository URL:
https://github.com/kosperun/obsidian-sansconverter - Enable the plugin in Community plugins
Usage
- Select the text you want to convert
- Open the command palette (
Cmd/Ctrl + P) - Search for "Convert selection" and choose your desired conversion
- The selected text will be replaced with the converted version
Setting Hotkeys
For faster workflow, assign custom hotkeys:
- Go to Settings → Hotkeys
- Search for "SansConverter"
- Assign your preferred key combinations
Suggested hotkeys:
Cmd/Ctrl + Shift + I→ IAST → BalaramCmd/Ctrl + Shift + B→ Balaram → IAST- etc.
Examples
| Input (Balaram, legacy) | Output (IAST) |
|---|---|
| Kåñëa | Kṛṣṇa |
| Input (Harvard-Kyoto) | Output (IAST) |
|---|---|
| KRSNa | Kṛṣṇa |
| Input (Velthius) | Output (IAST) |
|---|---|
| K.r.s.na | Kṛṣṇa |
| Input (IAST) | Output (Ukrainian) |
|---|---|
| Kṛṣṇa | Кр̣шн̣а |
Contributing
Contributions are welcome! Feel free to submit issues or pull requests.
License
MIT License - see LICENSE for details.