Mgboard — Masaram Gondi Android Keyboard

Mgboard एक privacy-first Android keyboard (IME) है, जिसमें Masaram Gondi लिपि, bundled Noto Sans Masaram Gondi font, English/QWERTY, emoji, local clipboard history और keyboard themes शामिल हैं।

• Repository: aimanage750/Mgboard
• Android: 8.0 Oreo या नया (minSdk 26)
• Network: ऐप में INTERNET permission नहीं है
• License: Apache License 2.0
• Font: Noto Sans Masaram Gondi, SIL Open Font License 1.1

APK Download

GitHub Release बनने के बाद नवीनतम APK इस लिंक से मिलेगा:

Mgboard.apk डाउनलोड करें

Repository clone/download करने पर verified beta APK project के root में Mgboard.apk नाम से भी उपलब्ध है।

अगर beta02 या किसी पुराने debug build के ऊपर install करते समय App not installed, signature conflict या package conflicts with an existing package दिखे, तो पुराने OpenKeyboard/Mgboard debug app को uninstall करके नया APK install करें। Production updates के लिए हमेशा एक ही सुरक्षित release-signing key उपयोग करें।

---

मुख्य सुविधाएँ

• Masaram Gondi के सभी assigned Unicode letters, dependent signs, marks और native digits
• Noto Sans Masaram Gondi font APK के अंदर bundled
• English/QWERTY, number और symbol layouts
• 𑴀 key से Masaram Gondi layout पर switch
• REPHA logical ordering fix: 𑴌 के बाद 𑵆 दबाने पर output 𑵆𑴌
• Emoji categories, recent emoji और multiple pages
• Long-press characters और repeating backspace
• Shift तथा Caps Lock
• तीन built-in themes और local .oktheme import/export
• Clipboard history, जो default में बंद रहती है
• Password fields में clipboard history छिपी रहती है
• कोई advertisement, analytics या Internet permission नहीं

---

Android Phone में APK कैसे Install करें

1. APK डाउनलोड करें

ऊपर दिया Mgboard.apk download link खोलें और APK save करें। Chrome warning दिखाए कि file नुकसान पहुँचा सकती है, तो केवल इसी verified repository से download की गई file के लिए Download anyway चुनें।

2. “Install unknown apps” अनुमति दें

Android के अनुसार menu का नाम थोड़ा अलग हो सकता है:

1. Settings खोलें।
2. Apps → Special app access → Install unknown apps खोलें।
3. जिस app से APK खोल रहे हैं, जैसे Chrome, Files या File Manager, उसे चुनें।
4. Allow from this source चालू करें।
5. Downloads में Mgboard.apk खोलकर Install दबाएँ।

Install पूरा होने के बाद सुरक्षा के लिए Allow from this source फिर बंद किया जा सकता है।

3. Keyboard Enable करें

1. Mgboard/OpenKeyboard app खोलें।
2. Enable OpenKeyboard दबाएँ।
3. Android की On-screen keyboard / Manage keyboards screen खुलेगी।
4. OpenKeyboard toggle चालू करें।
5. Android keyboard warning दिखा सकता है। यह सभी third-party keyboards के लिए सामान्य system warning है। इस project का source public है और APK में Internet permission नहीं है।

Manual path आमतौर पर:

Settings → System → Languages & input
→ On-screen keyboard → Manage on-screen keyboards
→ OpenKeyboard ON

Samsung devices पर path ऐसा हो सकता है:

Settings → General management
→ Keyboard list and default
→ OpenKeyboard ON

4. Default Keyboard चुनें

1. App में वापस आएँ और Select keyboard दबाएँ, या किसी text field को खोलें।
2. Keyboard switcher/keyboard icon दबाएँ।
3. सूची से Masram Gondi (India) चुनें।

इस नाम वाले subtype का typing behavior पहले की तरह QWERTY से शुरू होता है। Masaram Gondi खोलने के लिए keyboard की नीचे वाली row में 𑴀 दबाएँ। वापस English/QWERTY पर जाने के लिए EN दबाएँ।

---

Android Tablet में Setup

Tablet पर installation और activation के steps phone जैसे ही हैं:

1. Mgboard.apk download और install करें।
2. Settings → System/General management → Languages & input खोलें।
3. Physical keyboard नहीं, बल्कि On-screen keyboard section खोलें।
4. OpenKeyboard enable करें और default keyboard चुनें।
5. Landscape mode में keyboard उपलब्ध screen width का उपयोग करेगा।

अगर Bluetooth/USB physical keyboard जुड़ा है और on-screen keyboard नहीं दिख रहा:

1. Physical keyboard settings खोलें।
2. Show virtual keyboard या Show on-screen keyboard while physical keyboard is connected चालू करें।

---

Masaram Gondi कैसे चलाएँ

• QWERTY keyboard में 𑴀 दबाएँ: Masaram Gondi letters page खुलेगा।
• ◌𑴱 key दबाएँ: vowel signs और special marks page खुलेगा।
• 𑵐𑵑𑵒 दबाएँ: Masaram Gondi digits page खुलेगा।
• EN दबाएँ: QWERTY पर वापस जाएँ।
• 😊: Emoji panel।
• 📋: Clipboard panel। Clipboard history Settings में enable करनी होगी।

REPHA input

U+11D46 MASARAM GONDI REPHA Unicode logical order में consonant से पहले store होता है। सुविधा के लिए Mgboard दोनों तरीकों को संभालता है:

पहले REPHA:      𑵆 + 𑴌 → 𑵆𑴌
पहले consonant:  𑴌 + 𑵆 → 𑵆𑴌

दूसरे तरीके में keyboard cursor से पहले वाला Masaram Gondi cluster सुरक्षित रूप से rewrite करता है।

---

Privacy

• AndroidManifest.xml में android.permission.INTERNET नहीं है।
• Keystrokes केवल active text field को भेजे जाते हैं; app उन्हें log नहीं करता।
• Clipboard history default में OFF है।
• Enable होने पर clipboard text केवल local Room database में रहता है।
• Unpinned entries सात दिन बाद साफ की जाती हैं।
• Password fields में clipboard history नहीं दिखाई जाती।
• Theme import/export Android Storage Access Framework से होता है; broad storage permission की जरूरत नहीं है।

---

Android Studio से Project चलाना

आवश्यकताएँ

• Android Studio Hedgehog या नया
• JDK 17
• Android SDK 34
• Internet केवल Gradle dependencies पहली बार download करने के लिए; बनी हुई app स्वयं Internet permission नहीं माँगती

Steps

1. Repository clone करें:

git clone https://github.com/aimanage750/Mgboard.git
cd Mgboard

2. Android Studio खोलें।
3. Open दबाकर cloned Mgboard folder चुनें।
4. Gradle Sync पूरा होने दें।
5. Phone/tablet में Developer options और USB debugging चालू करें।
6. Device USB से जोड़ें और debugging authorization स्वीकार करें।
7. Android Studio toolbar में device चुनें।
8. Run ▶ app दबाएँ।
9. Install होने के बाद ऊपर दिए keyboard enable/select steps करें।

Emulator पर चलाना

1. Android Studio → Device Manager खोलें।
2. Android 8.0+ का virtual phone या tablet बनाएँ।
3. Emulator start करें।
4. Run ▶ app दबाएँ।
5. Emulator Settings में OpenKeyboard enable और select करें।

---

Command Line Build

Linux/macOS:

chmod +x gradlew
./gradlew testDebugUnitTest
./gradlew lintDebug
./gradlew assembleDebug

Windows:

gradlew.bat testDebugUnitTest

gradlew.bat lintDebug

gradlew.bat assembleDebug

Generated debug APK:

app/build/outputs/apk/debug/app-debug.apk

उसे share-friendly नाम देने के लिए:

cp app/build/outputs/apk/debug/app-debug.apk Mgboard.apk

ADB से install:

adb install -r Mgboard.apk

Signature conflict होने पर development device में पहले पुराना debug package हटाएँ:

adb uninstall com.openkeyboard.debug
adb install Mgboard.apk

---

Release APK Signing

Public distribution के लिए debug APK की जगह signed release APK उपयोग करें। Release signing key को repository में commit न करें। Android Studio में:

Build → Generate Signed Bundle / APK → APK

फिर नया keystore बनाएँ या existing production keystore चुनें। उसी package के सभी future updates को उसी key से sign करना आवश्यक है। GitHub Release में अंतिम signed file का नाम Mgboard.apk रखें, ताकि README का download link काम करे।

---

Project Structure

app/src/main/kotlin/com/openkeyboard/
├── clipboard/   Local Room clipboard database
├── emoji/       Emoji catalogue और recents
├── extensions/  Local add-on metadata
├── keyboard/    Layouts, custom view और Gondi composer
├── prefs/       Privacy preferences
├── service/     Android InputMethodService
├── theme/       Keyboard themes
└── ui/          Setup और settings screens

---

परीक्षण

Project में unit tests यह जाँचते हैं कि:

• सभी assigned Masaram Gondi code points keyboard से उपलब्ध हैं।
• Unassigned code points layout में नहीं हैं।
• 𑴌 + 𑵆 का logical output 𑵆𑴌 है।
• REPHA preceding consonant के dependent signs को सुरक्षित रखता है।
• REPHA spaces या independent vowels को पार करके reorder नहीं होता।

---

ज्ञात Beta सीमाएँ

• Custom-drawn keys के लिए TalkBack virtual accessibility nodes अभी पूरे नहीं हैं।
• Clipboard pin/unpin data layer में है, पर keyboard panel gestures अभी उपलब्ध नहीं हैं।
• Masaram Gondi arrangement को fluent Gondi writers से community usability validation चाहिए।
• Gesture typing, suggestions और spell checking अभी उपलब्ध नहीं हैं।

---

योगदान और Issues

Bug report में यह जानकारी दें:

• Android version और device/tablet model
• Mgboard version
• दबाई गई exact key sequence
• Actual output और expected output
• Screenshot या screen recording, यदि संभव हो

Issues: https://github.com/aimanage750/Mgboard/issues

---

License

Application source Apache License 2.0 के अंतर्गत है। LICENSE देखें।

Bundled NotoSansMasaramGondi-Regular.ttf Noto Project का font है और SIL Open Font License 1.1 के अंतर्गत है। Font license app/src/main/assets/fonts/OFL.txt में शामिल है.