{"id":43915565,"url":"https://github.com/kokoye2007/myanmar-linux-keyboards","last_synced_at":"2026-02-06T21:14:53.090Z","repository":{"id":309563518,"uuid":"1036746402","full_name":"kokoye2007/myanmar-linux-keyboards","owner":"kokoye2007","description":"Complete keyboard layout package for Myanmar scripts on Linux systems","archived":false,"fork":false,"pushed_at":"2025-09-05T04:30:28.000Z","size":136,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-05T06:15:27.483Z","etag":null,"topics":["burma","i18n","ibus","ibus-table","input-method","karen","keyboard-layout","keymagic","linux","localization","mon","myanmar","myanmar-unicode","shan","unicode","xkb"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kokoye2007.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-12T14:21:06.000Z","updated_at":"2025-09-05T04:30:32.000Z","dependencies_parsed_at":"2025-08-12T16:29:14.188Z","dependency_job_id":"f52c34f7-43bb-478b-b25a-548386733dca","html_url":"https://github.com/kokoye2007/myanmar-linux-keyboards","commit_stats":null,"previous_names":["kokoye2007/myanmar-linux-keyboards"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kokoye2007/myanmar-linux-keyboards","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokoye2007%2Fmyanmar-linux-keyboards","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokoye2007%2Fmyanmar-linux-keyboards/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokoye2007%2Fmyanmar-linux-keyboards/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokoye2007%2Fmyanmar-linux-keyboards/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kokoye2007","download_url":"https://codeload.github.com/kokoye2007/myanmar-linux-keyboards/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokoye2007%2Fmyanmar-linux-keyboards/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29176146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T20:14:21.878Z","status":"ssl_error","status_checked_at":"2026-02-06T20:14:21.443Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["burma","i18n","ibus","ibus-table","input-method","karen","keyboard-layout","keymagic","linux","localization","mon","myanmar","myanmar-unicode","shan","unicode","xkb"],"created_at":"2026-02-06T21:14:52.378Z","updated_at":"2026-02-06T21:14:53.075Z","avatar_url":"https://github.com/kokoye2007.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Myanmar Linux Keyboards\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![GitHub release](https://img.shields.io/github/release/kokoye2007/myanmar-linux-keyboards.svg)](https://github.com/kokoye2007/myanmar-linux-keyboards/releases)\n[![GitHub issues](https://img.shields.io/github/issues/kokoye2007/myanmar-linux-keyboards.svg)](https://github.com/kokoye2007/myanmar-linux-keyboards/issues)\n[![GitHub stars](https://img.shields.io/github/stars/kokoye2007/myanmar-linux-keyboards.svg)](https://github.com/kokoye2007/myanmar-linux-keyboards/stargazers)\n[![Ubuntu](https://img.shields.io/badge/Ubuntu-22.04%2B-orange.svg)](https://ubuntu.com/)\n[![Fedora](https://img.shields.io/badge/Fedora-35%2B-blue.svg)](https://getfedora.org/)\n[![Arch](https://img.shields.io/badge/Arch-rolling-brightgreen.svg)](https://archlinux.org/)\n\nComplete keyboard layout package for Myanmar scripts on Linux systems. Supporting all major Myanmar languages with multiple input methods.\n\n## 🌏 Languages Supported\n\n| Language | ISO Code | Script | Status | Keyboards |\n|----------|----------|---------|---------|-----------|\n| 🇲🇲 **Burmese** (Myanmar) | `my` | Myanmar | ✅ Complete | Standard, Zawgyi |\n| 📜 **Mon** | `mnw` | Myanmar | ✅ Complete | Standard, A1 |\n| 🏔️ **Shan** | `shn` | Myanmar | ✅ Complete | Standard, Zawgyi |\n| 🌾 **Karen (Sgaw)** | `ksw` | Myanmar | ✅ Complete | Kawthoolei |\n| 🌾 **Karen (Eastern Pwo)** | `kjp` | Myanmar | ✅ Complete | Unicode |\n| 🌾 **Karen (Western Pwo)** | `pwo` | Myanmar | ✅ Complete | Kawthoolei |\n| 🏔️ **Kayah** | `kyu` | Myanmar | 🚧 Planned | - |\n\n## 🚀 Quick Installation\n\n### Install All Keyboards\n```bash\n# Clone repository\ngit clone https://github.com/kokoye2007/myanmar-linux-keyboards.git\ncd myanmar-linux-keyboards\n\n# Install all XKB layouts (system-level)\nsudo ./installers/install-all-xkb.sh\n\n# Install all ibus-table input methods\nsudo ./installers/install-all-ibus.sh\n```\n\n### Install Specific Language\n```bash\n# Install only Karen keyboards\nsudo ./installers/install-specific.sh karen\n\n# Install only Mon keyboards  \nsudo ./installers/install-specific.sh mon\n\n# Install only Shan keyboards\nsudo ./installers/install-specific.sh shan\n```\n\n### Interactive TUI Installer\nFor a guided installation experience, use our Text-based User Interface installer:\n```bash\n# Run the interactive TUI installer\nsudo ./installers/tui-installer.sh\n```\nThe TUI installer provides an easy-to-use menu system that allows you to:\n- Choose between XKB layouts, IBus tables, or both\n- Select specific languages to install\n- Get real-time feedback during installation\n\n## ⌨️ Input Methods Available\n\n### **XKB Layouts** (System-level)\n- Integrates with desktop environment\n- Works across all applications\n- Standard Linux keyboard layout system\n- Usage: `setxkbmap mm \u003cvariant\u003e`\n\n### **ibus-table** (Input Method)\n- Direct character mapping\n- No candidate selection needed\n- Windows KLC compatible behavior\n- Usage: Add via Settings → Input Sources\n\n### **KeyMagic** (Advanced)\n- Automatic ligature generation\n- Smart character corrections\n- Context-aware input\n- Usage: Install KeyMagic + load .kms files\n\n## 🎯 Character Access Examples\n\n### Common Patterns (All Languages)\n```\nNumbers: 1-9,0 → ၁-၉,၀ (Myanmar digits)\nBasic:   q,w,e,r,t → ဆ,တ,န,မ,အ (consonants)\nVowels:  d,g,k,l → ိ,ါ,ု,ူ (vowel signs)\nMarks:   f,h,j → ်,့,ြ (diacritics)\n```\n\n### Language-Specific Characters\n\n**Karen (Eastern Pwo)**:\n```\nP → စ, Shift+P → ၮ (nna)\n[ → ဟ, Shift+[ → ၯ (ywa)  \n] → ☆, Shift+] → ၰ (ghwa)\n```\n\n**Karen (Western Pwo)**:\n```\nR → မ, Shift+R → ၩ (tone-1)\nT → အ, Shift+T → ၪ (tone-2)\nA → ၦ (pwa), Shift+A → ၡ (sha)\n```\n\n**Karen (Sgaw)**:\n```\nQ → ဆ, Shift+Q → ၡ (sha)\nE → န, Shift+E → ၢ (eu)\nR → မ, Shift+R → ၤ (kepho)\n```\n\n**Mon**:\n```\nI → ၚ (mon nga)\nB → ၜ (mon bba)\n```\n\n**Shan**:\n```\nU → ၥ (shan tone)\nSpecific Shan characters and tone marks\n```\n\n## 📱 Desktop Integration\n\n### GNOME\n1. Settings → Region \u0026 Language → Input Sources\n2. Click \"+\" → Other → Select Myanmar script\n3. Choose your language variant\n4. Switch: **Super + Space**\n\n### KDE Plasma\n1. System Settings → Input Devices → Keyboard → Layouts\n2. Add → Myanmar → Select variant\n3. Switch: **Alt + Shift**\n\n### XFCE\n1. Settings → Keyboard → Layout\n2. Add → Myanmar → Select variant\n3. Configure switching hotkey\n\n## 🛠️ Development\n\n### Building from Source\n```bash\n# Generate XKB layouts\ncd scripts/\n./build-xkb.sh\n\n# Generate ibus-table files\n./build-ibus.sh\n\n# Test layouts\n./test-layouts.sh\n```\n\n### Contributing\n1. **Fork** the repository\n2. **Create** feature branch: `git checkout -b feature/new-language`\n3. **Commit** changes: `git commit -am 'Add new language support'`\n4. **Push** branch: `git push origin feature/new-language`\n5. **Submit** Pull Request\n\n### Adding New Languages\n1. Create language directory in `scripts/`\n2. Add XKB symbols file\n3. Create ibus-table definition\n4. Add KeyMagic script (optional)\n5. Update installers and documentation\n\n## 📋 System Requirements\n\n### Supported Distributions\n- **Ubuntu** 20.04+ / **Debian** 11+\n- **Fedora** 35+ / **CentOS** 8+\n- **Arch Linux** / **Manjaro**\n- **openSUSE** Leap 15.3+\n\n### Required Packages\n```bash\n# Ubuntu/Debian\nsudo apt install xkb-data ibus-table\n\n# Fedora\nsudo dnf install xkeyboard-config ibus-table\n\n# Arch Linux\nsudo pacman -S xkeyboard-config ibus-table\n```\n\n### Recommended Fonts\n```bash\n# Install Myanmar Unicode fonts\nsudo apt install fonts-noto-myanmar fonts-myanmar  # Ubuntu\nsudo dnf install google-noto-sans-myanmar-fonts    # Fedora\nsudo pacman -S noto-fonts                          # Arch\n```\n\n## 🐛 Troubleshooting\n\n### XKB Issues\n```bash\n# Check current layout\nsetxkbmap -query\n\n# Reset to US layout\nsetxkbmap us\n\n# Clear XKB cache\nsudo rm -f /var/lib/xkb/*.xkm\n\n# Restart display manager\nsudo systemctl restart gdm  # or sddm/lightdm\n```\n\n### ibus Issues\n```bash\n# Restart ibus\nibus restart\n\n# Check available engines\nibus list-engine | grep myanmar\n\n# Debug mode\nibus-daemon -drx\n```\n\n### Character Display Problems\n1. Install Myanmar Unicode fonts\n2. Check system language support\n3. Verify font fallback configuration\n4. Test with different applications\n\n## 📚 Documentation\n\n- **[Installation Guide](docs/installation.md)** - Detailed setup instructions\n- **[Character Maps](docs/character-maps.md)** - Complete character reference\n- **[User Guide](docs/user-guide.md)** - How to use each input method\n- **[Developer Guide](docs/developer-guide.md)** - Contributing and building\n- **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions\n\n## 🤝 Community\n\n### Communication\n- **Issues**: Bug reports and feature requests\n- **Discussions**: General questions and ideas\n- **Wiki**: Community documentation\n- **Releases**: Stable versions and changelogs\n\n### Contributors\n- Language experts and native speakers\n- Linux distribution maintainers\n- Unicode and typography specialists\n- Community translators\n\n### Acknowledgments\n- **Myanmar Unicode Initiative** - Standardization efforts\n- **KNU (Karen National Union)** - Karen layout specifications\n- **Mon Language Project** - Mon script expertise\n- **Shan Digital Heritage** - Shan keyboard layouts\n- **Linux Internationalization Community** - Technical foundation\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n### Font Licenses\nRecommended fonts have their own licenses:\n- **Noto Sans Myanmar**: SIL Open Font License\n- **Myanmar3**: Custom license\n- **Padauk**: SIL Open Font License\n\n## 🌟 Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=kokoye2007/myanmar-linux-keyboards\u0026type=Date)](https://star-history.com/#kokoye2007/myanmar-linux-keyboards\u0026Date)\n\n---\n\n**Made with ❤️ for the Myanmar digital community**\n\n*Supporting linguistic diversity and digital inclusion across all Myanmar languages.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkokoye2007%2Fmyanmar-linux-keyboards","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkokoye2007%2Fmyanmar-linux-keyboards","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkokoye2007%2Fmyanmar-linux-keyboards/lists"}