Bhasini

# Bhasini (भाषिणी)

[![Sponsor via Razorpay](https://img.shields.io/badge/Sponsor-Razorpay-0C2451?style=for-the-badge&logo=razorpay&logoColor=white)](https://razorpay.me/@codegres)
[![Open Bhasini](https://img.shields.io/badge/Open-bhasini.com-f07b2b?style=for-the-badge)](https://bhasini.com)
[![License: MIT](https://img.shields.io/badge/License-MIT-2d3a8c?style=for-the-badge)](LICENSE)

A multilingual Indic typing editor for all **22 scheduled languages of India**, built with
Blazor WebAssembly. Everything runs in the browser; no server round-trips while you type.

It grew out of the Kannada Nudi web editor (`KannadaNudiEditor/KannadaNudiWeb`) and keeps its
shape: a Quill rich-text editor whose keystrokes are transliterated by a C# engine.

## Languages

| Language | Script |
|---|---|
| Assamese | Bengali-Assamese (ৰ, ৱ) |
| Bengali | Bengali |
| Bodo | Devanagari |
| Dogri | Devanagari |
| Gujarati | Gujarati |
| Hindi | Devanagari |
| Kannada | Kannada |
| Kashmiri | Perso-Arabic (RTL), also Devanagari |
| Konkani | Devanagari |
| Maithili | Devanagari |
| Malayalam | Malayalam (chillus, Mozhi-style keys) |
| Manipuri | Meetei Mayek (lonsum letters), also Bengali |
| Marathi | Devanagari (ळ) |
| Nepali | Devanagari |
| Odia | Odia |
| Punjabi | Gurmukhi (tippi, bindi, addak) |
| Sanskrit | Devanagari |
| Santali | Ol Chiki |
| Sindhi | Perso-Arabic (RTL), also Devanagari |
| Tamil | Tamil (ந/ன by context, ற, ழ) |
| Telugu | Telugu |
| Urdu | Perso-Arabic, Nastaliq (RTL) |

Plus English (no transliteration).

## Features

- **Phonetic typing**: type how it sounds (`namaste` → नमस्ते, `vaNakkam` → வணக்கம், `aadaab` → آداب).
  ITRANS/Baraha-style keys: capitals for retroflex/long sounds (`T D N L Sh A I U E O`), `M` anusvara,
  `H` visarga, `.h` explicit virama, `_` to stop letters joining, `|` / `||` danda.
- **InScript**: the government-standard layout for every Brahmic script.
- **F9** switches between the selected language and English.
- **Key map panel** for the current language and method. Tap a letter to insert it, which also helps on phones.
- **Native digits** toggle (१२३, ௧௨௩, ۱۲۳, …).
- **Convert**: rewrite text from one Indian script to another, or turn romanised text into script.
- **Dictation** through the browser's speech recognition (Chrome and Edge, where the locale is supported).
- Open `.txt` / `.docx`, save as `.docx`, `.txt` or `.html`. Settings are remembered per browser.

## How it works

`src/Bhasini.Core` has no web dependencies:

- `Input/BrahmicPhoneticEngine` turns Latin keys into Devanagari, with a per-language
  `PhoneticProfile` (Dravidian short e/o, word-final virama, Tamil nasals, local key conventions).
- `Scripts/OffsetScriptMapper` maps Devanagari into each ISCII-derived Unicode block by offset.
  Letters a script lacks fall back to the nearest letter. Script-specific spelling rules
  (Malayalam chillus, Gurmukhi tippi/addak, Bengali য়) run as post-processing.
- `Scripts/MeeteiMayekMapper` handles Meetei Mayek. `Input/SequenceEngine` handles the alphabetic
  scripts (Perso-Arabic with word-initial/final forms, and Ol Chiki).
- `Input/TypingSession` keeps the Latin keys of the current word and re-renders the whole word
  on every key, returning a minimal `{ delete, insert }` edit for the editor.

`src/Bhasini.Web` is the Blazor WebAssembly app. `wwwroot/js/editor.js` intercepts keys in Quill
and calls the session synchronously.

## Run

Requires the .NET 8 SDK.

```bash
dotnet run --project src/Bhasini.Web
```

```bash
dotnet test
```

Docker (nginx serving the published static files on port 5000):

```bash
docker build -t bhasini .
```

Script fonts come from Google Fonts (Noto). When offline, the editor falls back to system fonts
such as Nirmala UI on Windows.

## Support Bhasini

Bhasini is free to use. If it helps you, please consider sponsoring its development:

[![Sponsor via Razorpay](https://img.shields.io/badge/Sponsor%20via-Razorpay-0C2451?style=for-the-badge&logo=razorpay&logoColor=white)](https://razorpay.me/@codegres)

## Windows app

[`BhasiniWindows/`](BhasiniWindows/README.md) packages Bhasini as a Windows desktop app and Microsoft Store AppX.
It adds **Global mode**: press **F9** to type the selected Indian language in any application.

## License

[MIT](LICENSE) © Codegres