A tray app for Windows, macOS, and Linux that converts selected Nepali text between legacy fonts and Unicode.
Status: repository scaffold. The converter, tray, hotkeys, clipboard layer, and installers are not built yet. The agreed design is in docs/SPEC.md.
- Press
Ctrl+Shift+O(Cmd+Shift+Oon macOS) with text selected. - The app copies the selection, detects legacy or Unicode text, converts it, and pastes the result over the selection.
- The clipboard returns to the original selected text after the paste.
- Rich text keeps bold, italic, color, size, and paragraph formatting.
- Legacy fonts: Preeti, Sagarmatha, Kantipur, FONTASY_HIMALI_TT, PCS NEPALI.
- Unicode target font: Kalimati.
- Legacy output: Sagarmatha by default, Preeti as an option.
- Optional two-hotkey mode:
Ctrl/Cmd+Shift+Ofor legacy to Unicode andCtrl/Cmd+Shift+Ufor Unicode to legacy.
| Platform | Hotkey and selection | Clipboard |
|---|---|---|
| Windows 10/11 x64 | Full | Plain text, HTML, RTF |
| macOS 12+ universal | Full | Plain text, HTML, RTF |
| Linux X11 x64 | Full | Plain text, HTML, RTF |
| Linux Wayland | None | Converter window from the tray |
Wayland blocks global hotkeys and synthetic keystrokes for background apps. The tray command opens a small converter window instead.
Prerequisites:
- Rust 1.90 or newer with
rustfmtandclippy - Node.js 22 or newer and npm
- Tauri 2 platform prerequisites:
- Windows: Microsoft C++ Build Tools and WebView2
- macOS: Xcode Command Line Tools
- Linux: WebKitGTK 4.1, GTK3, librsvg, and libayatana-appindicator
Install dependencies:
npm installRun the desktop app in development:
npm run tauri devRun the Rust tests:
cargo test --workspaceBuild the frontend:
npm run buildThe app currently opens a settings placeholder. It does not register a hotkey, show a tray icon, or convert text yet.
apps/desktop/ Tauri shell and settings frontend
crates/nepali-convert/ Pure Rust conversion engine
crates/rich-clipboard/ Per-OS clipboard snapshot and rich-text rewrite
docs/ Specification, architecture, research, and plans
assets/ Source artwork for app icons
- Specification: product behavior and acceptance criteria
- Architecture: crates, data flow, and platform layers
- Decisions: chosen options and their consequences
- Research: clipboard and keystroke findings
- Fonts: encodings, font handling, and licensing
- Testing: corpus, fixtures, and manual QA
- UI: tray, toast, settings, and first-run flow
- Privacy: data handling and network access
- Roadmap: milestones
- Conversion engine plan
NepaliTools is licensed under GPL-3.0-only. See LICENSE.
The conversion map data comes from casualsnek/npttf2utf, which is GPL-3.0. The Unicode to Preeti engine is ported from globalpolicy/UnicodeToPreeti, which is MIT licensed. See THIRD_PARTY_NOTICES.md.
The Kalimati font is not in the repository yet. Its license will be checked before it is bundled.