2022-04-04 17:31:02 +02:00
< h2 align = "center" > < b > OpenBoard< / b > < / h2 >
< h4 align = "center" > 100% FOSS keyboard, based on AOSP.< / h4 >
< p align = "center" > < img src = 'fastlane/metadata/android/en-US/images/icon.png' height = '128' > < / p >
< p align = "center" > < a href = "https://github.com/openboard-team/openboard/actions/workflows/android-build.yml" > < img src = "https://img.shields.io/github/workflow/status/openboard-team/openboard/Build" alt = "GitHub Workflow Status" > < / a >
< a href = "https://github.com/openboard-team/openboard/releases" > < img src = "https://img.shields.io/github/v/release/openboard-team/openboard" alt = "GitHub release (latest by date)" > < / a >
< a href = "https://github.com/openboard-team/openboard/releases" > < img src = "https://img.shields.io/github/release-date/openboard-team/openboard" alt = "GitHub Release Date" > < / a >
< a href = "https://github.com/openboard-team/openboard/commits/master" > < img src = "https://img.shields.io/github/commits-since/openboard-team/openboard/latest" alt = "GitHub commits since latest release (by date)" > < / a >
< a href = "https://hosted.weblate.org/engage/openboard/" > < img src = "https://hosted.weblate.org/widgets/openboard/-/openboard/svg-badge.svg" alt = "Translation status" > < / a >
< a href = "https://matrix.to/ #/#openboard:matrix .org?via=matrix.org" >< img src = "https://img.shields.io/matrix/openboard:matrix.org" alt = "Matrix" ></ a ></ p >
< p align = "center" > < a href = 'https://f-droid.org/packages/org.dslul.openboard.inputmethod.latin' > < img src = 'https://fdroid.gitlab.io/artwork/badge/get-it-on.png' alt = 'Get it on F-Droid' height = '60' > < / a >
< a href = 'https://play.google.com/store/apps/details?id=org.dslul.openboard.inputmethod.latin&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1' > < img alt = 'Get it on Google Play' src = 'https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' height = '60' / > < / a > < / p >
## Community chat
Join our [matrix] channel [here ](https://matrix.to/#/#openboard:matrix.org?via=matrix.org ).
< img src = "images/matrix_qr.png" alt = "Matrix QR Code" height = "128" >
2020-09-09 17:58:43 +02:00
2020-06-07 15:16:18 +01:00
## Contribute
2020-01-22 21:35:47 +01:00
2022-04-04 17:31:02 +02:00
### Translate OpenBoard
2022-01-29 17:38:00 +01:00
You can help in translating OpenBoard in your language through our [Weblate project ](https://hosted.weblate.org/engage/openboard/ ).
[](https://hosted.weblate.org/engage/openboard/)
2022-04-04 17:31:02 +02:00
### Create a dictionary
You can use [this tool ](https://github.com/remi0s/aosp-dictionary-tools ) to create a dictionary. You need a wordlist, as described [here ](dictionaries/sample.combined ). The output .dict file must be put in [res/raw ](app/src/main/res/raw ), its wordlist in [dictionnaries ](/dictionaries ).
2022-01-23 23:43:09 +01:00
2022-04-04 17:31:02 +02:00
For your dictionnary to be merged, you need to provide the wordlist you used, as well as its license if any.
2020-06-07 15:16:18 +01:00
### APK Development
#### Linux
Install java:
```sh
2021-10-16 17:27:18 +02:00
sudo pacman -S jdk11-openjdk jre11-openjdk jre11-openjdk-headless
2020-06-07 15:16:18 +01:00
```
Install Android SDK:
```sh
sudo pacman -S snapd
sudo snap install androidsdk
```
Configure your SDK location in your `~/.bash_profile` or `~/.bashrc` :
```bash
export ANDROID_SDK_ROOT=~/snap/androidsdk/current/AndroidSDK/
```
Compile the project. This will install all dependencies, make sure to accept
licenses when prompted.
```sh
./gradlew assembleDebug
```
Connect your phone and install the debug APK
```sh
adb install ./app/build/outputs/apk/debug/app-debug.apk
```
2021-05-03 13:51:32 +02:00
2022-04-04 17:31:02 +02:00
#### Generate KeyboardTextsTable.java
Make your modifications in [tools/make-keyboard-text/src/main/resources ](tools/make-keyboard-text/src/main/resources )/values-YOUR LOCALE.
Generate the new version of [KeyboardTextsTable.java ](app/src/main/java/org/dslul/openboard/inputmethod/keyboard/internal/KeyboardTextsTable.java ):
```sh
./gradlew tools:make-keyboard-text:makeText
```
## Credits
- Icon by [Marco TLS ](https://www.marcotls.eu )
2020-09-11 17:05:41 +02:00
- [AOSP Keyboard ](https://android.googlesource.com/platform/packages/inputmethods/LatinIME/ )
- [LineageOS ](https://review.lineageos.org/admin/repos/LineageOS/android_packages_inputmethods_LatinIME )
- [Simple Keyboard ](https://github.com/rkkr/simple-keyboard )
- [Indic Keyboard ](https://gitlab.com/indicproject/indic-keyboard )
2022-04-04 17:31:02 +02:00
- Our [contributors ](https://github.com/openboard-team/openboard/graphs/contributors )