The Ajami scripture app for the traditional Ethiopian Sufi scripts
# Harmony Ajam Script
> Part of the **Harmony Projects** series. Digital preservation, AI OCR transcription, and interactive catalog for historical Ethiopian Sufi Ajam manuscripts (*Menzuma*, *Zikr*, *Qasida*, *Tawassul*).
---
## 🌟 Overview
In the Ethiopian Sufi community, **Ajam** (also known as *Ajami*) is a centuries-old writing system that transcribes native Ethiopian languages — including Amharic, Afaan Oromo, Harari, Silte, Argobba, and Afar — into adapted Arabic script with specialized localized diacritics.
**Harmony Ajam Script** is a production-grade web application created to digitize, decipher, and preserve these rare historical manuscripts, providing scholars, researchers, and reciters with AI-powered OCR, bidirectional transliteration, vocal chant audio sync, and community preservation tools.
---
## ✨ Key Features
1. **Digital Manuscript Archive**:
- High-resolution scans and side-by-side verse transcriptions in Ajam script, Ethiopic (Ge'ez), and English.
- Filter by Ethiopian region (*Wollo, Harar, Bale, Silte, Jimma, Raya*) and category (*Menzuma, Zikr, Tawassul, Mawlid, Qasida*).
- Synchronized line-by-line vocal chant audio player.
2. **AI Manuscript Scanner & OCR (Gemini 2.5 Vision Engine)**:
- Photograph or upload physical manuscript pages to extract raw Ajam script.
- Auto-translate into Ethiopic & English, detect regional dialect, poetic meter (*Bahre*), and spiritual commentary.
3. **Interactive Ajam Transcriber & Virtual Keyboard**:
- Real-time bidirectional conversion from Ethiopic/Latin phonetics into authentic Ajam script.
- Touch-optimized on-screen Ajam virtual keyboard with localized three-dot diacritic keys (`پ`, `چ`, `ژ`, `گ`, `ڤ`, `ݧ`, `ڞ`).
4. **Ajam Literacy & History Primer**:
- Educational modules teaching scribal rules, vowel order mapping, and historical context.
- Interactive knowledge check quiz cards.
5. **Community Workbench & Vocal Recorder**:
- Submit new manuscript transcriptions to the Firestore database.
- I …