# Amharic Phonetic
**System-wide Amharic (አማርኛ) input for Linux** — type Latin letters, get Fidel, in every app.
SERA / GFF phonetic rules · Live underlined preedit · Works with GNOME (and other IBus desktops) · User-level install, no root for the engine
```
selam → ሰላም
amarNa → አማርኛ
kremt → ክረምት
```
---
## Install
**One-time packages** (pick your distro), then the installer:
Fedora / RHEL
```bash
sudo dnf install ibus python3-gobject git
```
Ubuntu / Debian
```bash
sudo apt install ibus python3-gi gir1.2-ibus-1.0 git
```
Arch
```bash
sudo pacman -S ibus python-gobject git
```
**Install the engine** (current user only — no sudo):
```bash
git clone
github.com
cd amharic-keyboard
chmod +x install.sh uninstall.sh
./install.sh
```
Already cloned? Re-run `./install.sh` anytime to upgrade in place.
Check status later:
```bash
./install.sh --status
```
### GNOME (Fedora Workstation, etc.)
The installer:
- Enables “show all input sources”
- Adds **Amharic Phonetic** to your input sources
- Sets **Super+Space** for switching (and clears conflicting IBus grabs)
Then:
1. Click any text field
2. Press **Super+Space** until the top bar shows **Amharic Phonetic**
3. Type `selam` → **ሰላም**
> In **Settings → Keyboard → Input Sources → +**, open the **Amharic** language, then choose **Amharic Phonetic** (IBus).
> Do **not** pick the plain **Amharic** XKB layout — that is a different keyboard.
### After reboot
A small autostart entry re-registers the engine with IBus. If it ever goes missing:
```bash
python3 ~/.local/share/ibus/engine/amharic/register_component.py
./install.sh --status
```
### KDE Plasma / other IBus desktops
1. Run `./install.sh`
2. Set **IBus** as the input method framework in System Settings
3. Add **Amharic Phonetic** and use your desktop’s input-source shortcut
---
## Uninstall
```bash
./uninstall.sh # keep ~/.config/amharic-ibus
./uninstall.sh --purge # remove config …