Space bar ribbon: fail-safe host graph fetch and parser

Merge: gauge low-usage fill uses the space bar button colour
Gauge: low-usage fill reuses the space bar button colour
2026-09-27 18:35:02 +00:00 · 2026-09-27 18:27:49 +00:00 · 2026-09-27 18:27:49 +00:00 · 2026-09-27 18:25:24 +00:00 · 2026-09-27 18:25:24 +00:00 · 2026-09-27 18:20:59 +00:00
588 changed files with 36556 additions and 7808 deletions
@@ -0,0 +1 @@
+srcs/juloo.keyboard2/ComposeKeyData.java -diff
@@ -0,0 +1,3 @@
+github: [ Julow ]
+liberapay: Julow
+custom: [ "https://paypal.me/JulesAguillon" ]
@@ -0,0 +1,39 @@
+name: Check generated files
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - master
+  pull_request:
+
+jobs:
+  gen-layouts:
+    name: Layout list
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout repo
+      uses: actions/checkout@v4
+    - run: python3 gen_layouts.py
+    - name: "Run 'python3 gen_layouts.py' to update the generated files."
+      run: git diff --exit-code
+
+  check-layouts:
+    name: Layout warnings
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout repo
+      uses: actions/checkout@v4
+    - run: python3 check_layout.py
+    - name: "Fix your layout accordingly or run 'python3 check_layout.py' to promote the warnings"
+      run: git diff --exit-code
+
+  check-compose:
+    name: Compose key data
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout repo
+      uses: actions/checkout@v4
+    - run: python3 srcs/compose/compile.py srcs/compose/{*.json,compose} > srcs/juloo.keyboard2/ComposeKeyData.java
+    - name: "Run 'gradle test' to update the generated files."
+      run: git diff --exit-code
@@ -1,19 +0,0 @@
-name: Check layouts
-
-# Runs 'gen_layouts.py' and checks that the generated file were uptodate.
-# This doesn't run 'check_layout.py'.
-
-on:
-  workflow_dispatch:
-  push:
-  pull_request:
-
-jobs:
-  check-layouts:
-    runs-on: ubuntu-latest
-    steps:
-    - name: Checkout repo
-      uses: actions/checkout@v3
-    - run: python3 gen_layouts.py
-    - name: Check that the generated layouts.xml is uptodate, run python3 gen_layouts.py otherwise
-      run: git diff --exit-code
@@ -1,16 +0,0 @@
-name: Check translations
-
-on:
-  workflow_dispatch:
-  push:
-  pull_request:
-
-jobs:
-  check-translations:
-    runs-on: ubuntu-latest
-    steps:
-    - name: Checkout repo
-      uses: actions/checkout@v3
-    - run: python3 sync_translations.py
-    - name: Check that strings files are uptodate, run python3 sync_translations.py otherwise
-      run: git diff --exit-code
@@ -3,45 +3,65 @@ name: Make Apk CI
 on:
  workflow_dispatch:
  push:
+    branches:
+      - master
  pull_request:

 jobs:
  Build-Apk:
    runs-on: ubuntu-latest
    steps:
-    - uses: actions/setup-java@v3
-      with:
-        distribution: 'zulu' # See 'Supported distributions' for available options
-        java-version: '11'
    - name: Checkout repo
-      uses: actions/checkout@v3
-    - name: Cache debug certificate
-      uses: actions/cache@v3
+      uses: actions/checkout@v6
      with:
-        path: _build/debug.keystore
-        key: debug-keystore
-    - name: Restore debug keystore from github Secrets 
+        submodules: true
+
+    - name: Restore debug keystore from GitHub Secrets
      run: |
-        mkdir -p _build
-        cd "_build"
        # Check if exist and use the secret named DEBUG_KEYSTORE
        # The contents of the secret can be obtained -
-        #    from the debug.keystore.asc from you local _build folder
+        #  from the debug.keystore.asc from you local folder 
+        #  (refer to CONTRIBUTING.md Using the local debug.keystore on the Github CI actions)
        if [[ ! "${{ secrets.DEBUG_KEYSTORE }}" = "" ]]; then
            echo "${{ secrets.DEBUG_KEYSTORE }}" > "debug.keystore.asc"
            if [[ -s "debug.keystore.asc" ]]; then
+                echo "Restoring debug keystore from GitHub secrets"
                gpg -d --passphrase "debug0" --batch "debug.keystore.asc" > "debug.keystore"
            fi
        fi
-    - name: Build
-      run: make
+
+    - uses: actions/setup-java@v4
+      with:
+        distribution: 'temurin'
+        java-version: '17'
+    - name: Setup Gradle
+      uses: gradle/actions/setup-gradle@v4
+      with:
+        gradle-version: 8.14.4
+
+    - name: Run tests
+      run: |
+        gradle test
+        # Warn about outdated generated files.
+        if ! git diff --name-only; then
+          echo "Warning: Generated files are not uptodate. Run 'gradle test'."
+        fi
+
+    - name: Build debug APK
+      run: ./gradlew assembleDebug
+      env:
+        DEBUG_KEYSTORE: "debug.keystore"
+        DEBUG_KEYSTORE_PASSWORD: debug0
+        DEBUG_KEY_ALIAS: debug
+        DEBUG_KEY_PASSWORD: debug0
+
    - name: Artifact naming
      run: |
        artifact="${{github.repository_owner}} ${{github.ref_name}}"
        artifact="${artifact//\//-}" # replace slashes
        echo "artifact=${artifact}" >> $GITHUB_ENV
-    - name: Save debug apk
-      uses: actions/upload-artifact@v3
+    - name: Upload debug APK
+      uses: actions/upload-artifact@v4
      with:
        name: "${{env.artifact}} debug_apk"
-        path: _build/*.apk
+        path: build/outputs/apk/debug/*.apk
@@ -1,4 +1,14 @@
 *.keystore
 *.keystore.asc
-_build
 /*-keystore.conf
+*.iml
+.gradle
+/local.properties
+/.idea
+.DS_Store
+/captures
+/build
+# Directory _build is not used anymore
+/_build
+/release
+vendor/libswipetype/
@@ -0,0 +1,3 @@
+[submodule "vendor/cdict"]
+	path = vendor/cdict
+	url = https://github.com/Julow/cdict
@@ -0,0 +1,46 @@
+# Harley's Keyboard - agent notes
+
+Fork of Julow/Unexpected-Keyboard (Unexpected Keyboard). Android IME, Java, Gradle Kotlin DSL.
+
+## Build & test (exact)
+
+```bash
+./gradlew testDebugUnitTest assembleDebug    # full verification: unit tests THEN the APK
+./gradlew clean assembleDebug                # when a generated file may be stale
+```
+
+- SDK: `local.properties` -> `sdk.dir=/home/nyra/android-sdk` (present, gitignored, do not commit).
+- JDK 21, build-tools 34.0.0/36.0.0, AGP 8.8.2, compileSdk 36, minSdk 21.
+- APK: `build/outputs/apk/debug/Unexpected-Keyboard-debug.apk`, package id `harley.keyboard`.
+
+## Layout & generated code
+
+- Layout rows live in `srcs/layouts/*.xml`. A layout edit needs a **full build**, not just compile:
+  `gen_layouts.py` regenerates `res/values/layouts.xml`, `res/raw/*.xml` and
+  `srcs/juloo.keyboard2/ComposeKeyData.java`. Unit tests run before regeneration report
+  stale-generated-state failures that are not real bugs.
+- Never hand-edit generated files (`res/values/layouts.xml`, `res/raw/*`, `ComposeKeyData.java`,
+  `res/xml/method.xml`).
+
+## Always do
+
+- Run `./gradlew testDebugUnitTest assembleDebug` before reporting done.
+- Keep user-visible text in `res/values/strings.xml`.
+- Keep all network access off the UI thread.
+
+## Ask first
+
+- Adding any dependency (prefer the framework: `org.json`, `HttpURLConnection`).
+- Changing the package id, signing config or versionCode.
+
+## Never do
+
+- Commit or print secrets/tokens; no credentials in code, XML, tests or logs.
+- Touch `.git` internals, force-push, or edit CI workflows.
+- Enable cleartext HTTP globally (only a per-host network security config).
+- Change the space-bar peak-colour behaviour (a separate, deliberate feature).
+
+## Definition of done
+
+`./gradlew testDebugUnitTest assembleDebug` exits 0, new behaviour is covered by unit tests,
+and the tree has no generated-file diffs beyond what a normal build produces.
@@ -1,25 +1,42 @@
 <?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="juloo.keyboard2" android:versionCode="36" android:versionName="1.24.0" android:hardwareAccelerated="false">
-  <uses-sdk android:minSdkVersion="4" android:targetSdkVersion="33"/>
-  <application android:label="@string/app_name" android:allowBackup="true" android:icon="@drawable/ic_launcher" android:hardwareAccelerated="false">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" android:hardwareAccelerated="false">
+  <uses-permission android:name="android.permission.VIBRATE"/>
+  <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+  <uses-permission android:name="android.permission.INTERNET"/>
+  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
+
+  <application android:label="@string/app_name" android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:hardwareAccelerated="false" android:networkSecurityConfig="@xml/network_security_config">
    <service android:name="juloo.keyboard2.Keyboard2" android:label="@string/app_name" android:permission="android.permission.BIND_INPUT_METHOD" android:exported="true" android:directBootAware="true">
      <intent-filter>
        <action android:name="android.view.InputMethod"/>
      </intent-filter>
      <meta-data android:name="android.view.im" android:resource="@xml/method"/>
    </service>
-    <activity android:name="juloo.keyboard2.SettingsActivity" android:icon="@drawable/ic_launcher" android:label="@string/settings_activity_label" android:theme="@style/android:Theme.DeviceDefault" android:exported="true" android:directBootAware="true">
+
+    <activity android:name="juloo.keyboard2.SettingsActivity" android:icon="@mipmap/ic_launcher" android:theme="@style/settingsTheme" android:exported="true" android:directBootAware="true">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
      </intent-filter>
    </activity>
-    <activity android:name="juloo.keyboard2.LauncherActivity" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/android:Theme.DeviceDefault" android:exported="true" android:directBootAware="true">
+
+    <activity android:name="juloo.keyboard2.LauncherActivity" android:icon="@mipmap/ic_launcher" android:theme="@style/appTheme" android:exported="true" android:directBootAware="true">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
+
+    <activity android:name="juloo.keyboard2.dict.DictionariesActivity" android:icon="@mipmap/ic_launcher" android:theme="@style/appTheme" android:exported="true" android:directBootAware="true">
+      <intent-filter>
+        <action android:name="android.intent.action.MAIN"/>
+      </intent-filter>
+    </activity>
  </application>
-  <uses-permission android:name="android.permission.VIBRATE"/>
-  <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+
+  <!-- To query enabled input methods for voice IME detection -->
+  <queries>
+    <intent>
+      <action android:name="android.view.InputMethod" />
+    </intent>
+  </queries>
 </manifest>
@@ -4,52 +4,52 @@ Thanks for contributing :)

 ## Building the app

-The application doesn't use Gradle and it might be hard to use some features of
-Android Studio.
+The application uses Gradle and can be used with Android Studio, but using
+Android Studio is not required. The build dependencies are:
+- OpenJDK 17
+- Android SDK: build tools, platform `36`

-Fortunately, there's not many dependencies:
- OpenJDK 8
- Android SDK: build tools (minimum `28.0.1`), platform `30`
- Make sure to have the `$ANDROID_HOME` environment variable set.
+Python 3 is required to update generated files but not to build the app.
+
+Make sure the Git submodules are initialized and point to the right revision:
+
+```sh
+git submodule update --init
+```
+
+For Android Studio users, no more setup is needed.

 For Nix users, the right environment can be obtained with `nix-shell ./shell.nix`.
-Instructions to install Nix are [here](https://nixos.wiki/wiki/Nix_Installation_Guide).
+Instructions to install Nix are [here](https://wiki.nixos.org/wiki/Nix_Installation_Guide).
+
+If you don't use Android Studio or Nix, you have to inform Gradle about the
+location of your Android SDK by either:
+- Setting the `ANDROID_HOME` environment variable to point to the android sdk or
+- Creating the file `local.properties` and writing
+  `sdk.dir=<location_of_android_home>` into it.

 Building the debug apk:

 ```sh
-make
+./gradlew assembleDebug
 ```

-If the build succeed, the debug apk is located in `_build/juloo.keyboard2.debug.apk`.
+Nix users can call gradle directly: `gradle assembleDebug`.

-## Using the local debug.keystore on the Github CI actions
-
-It's possible to save the local debug.keystore into a github secret, so the same keystore is utilized to build the debug apk in the CI github actions.
-Doing this, they wil have the same signature, thus the debug apk can be updated without having to uninstall it first.
-
-After you sucessfully run `make`, (thus a debug.keystore exists) you can use this second command to generate a base64 stringified version of it
-
-```sh
-cd _build
-gpg -c --armor --pinentry-mode loopback --passphrase debug0 --yes "debug.keystore"
-```
-
-A file will be generated inside the local `_build/` folder, called `debug.keystore.asc`
-
-You can copy the content of this file, and with that, paste it into a new github secret in your repo settings.
-
-The secret must be named `DEBUG_KEYSTORE`
+If the build succeeds, the debug apk is located in `build/outputs/apk/debug/app-debug.apk`.

 ## Debugging on your phone

 First [Enable adb debugging on your device](https://developer.android.com/studio/command-line/adb#Enabling).
-Then connect your phone to your computer using an USB cable or wireless
+Then connect your phone to your computer using an USB cable or via wireless
 debugging.

+If you use Android Studio, this process will be automatic and you don't have to
+follow this guide anymore.
+
 And finally, install the application with:
 ```sh
-make installd
+./gradlew installDebug
 ```

 The released version of the application won't be removed, both versions will
@@ -57,11 +57,13 @@ be installed at the same time.

 ## Debugging the application: INSTALL_FAILED_UPDATE_INCOMPATIBLE

-`make installd` can fail with the following error message:
+`./gradlew installDebug` can fail with the following error message:

 ```
-adb: failed to install _build/juloo.keyboard2.debug.apk: Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package juloo.keyboard2.debug signatures do not match previously installed version; ignoring!]
-make: *** [Makefile:20: installd] Error 1
+FAILURE: Build failed with an exception.
+* What went wrong:
+Execution failed for task ':installDebug'.
+> java.util.concurrent.ExecutionException: com.android.builder.testing.api.DeviceException: com.android.ddmlib.InstallException: INSTALL_FAILED_UPDATE_INCOMPATIBLE: Existing package juloo.keyboard2.debug signatures do not match newer version; ignoring!
 ```

 The application can't be "updated" because the temporary certificate has been
@@ -70,36 +72,57 @@ The application must be enabled again in the settings.

 ```sh
 adb uninstall juloo.keyboard2.debug
-make installd
+./gradlew installDebug
 ```

+## Specifying a debug signing certificate on Github Actions
+
+It's possible to specify the signing certificate that the automated build
+should use.
+After you successfully run `./gradlew asssembleDebug`, (thus a debug.keystore
+exists) you can use this second command to generate a base64 stringified
+version of it:
+
+```sh
+gpg -c --armor --pinentry-mode loopback --passphrase debug0 --yes "debug.keystore"
+```
+
+This will create the file `debug.keystore.asc`, paste its content into a new
+Github secret named `DEBUG_KEYSTORE`.
+
 ## Guidelines

 ### Adding a layout

-Layouts are defined in XML, see `res/xml/latn_qwerty_us.xml`.
+Layouts are defined in XML, see `srcs/layouts/latn_qwerty_us.xml`.
 An online tool for editing layout files written by @Lixquid is available
 [here](https://unexpected-keyboard-layout-editor.lixquid.com/).

 Makes sure to specify the `name` attribute like in `latn_qwerty_us.xml`,
 otherwise the layout won't be added to the app.

-The layout file must be placed in the `res/xml/` directory and named according to:
+The layout file must be placed in the `srcs/layouts` directory and named
+according to:
 - script (`latn` for latin, etc..)
 - layout name (eg. the name of a standard)
 - country code (or language code if more adequate)

-Then, run `make gen_layouts` to add the layout to the app.
+Then, run `./gradlew genLayoutsList` to add the layout to the app.

 The last step will update the file `res/values/layouts.xml`, that you should
 not edit directly.

-Run `make check_layouts` to check some properties about your layout. This will
-change the file `check_layout.output`, which you should commit.
+Run `./gradlew checkKeyboardLayouts` to check some properties about your
+layout. This will change the file `check_layout.output`, which you should
+commit.
+
+Layouts are CC0 licensed by default. If you do not want your layout to be
+released into the public domain, add a copyright notice at the top of the file
+and a mention in `srcs/layouts/LICENSE`.

 #### Adding a programming layout

-A programming layout must contains every ASCII characters.
+A programming layout must contain all ASCII characters.
 The current programming layouts are: QWERTY, Dvorak and Colemak.

 See for example, Dvorak, added in https://github.com/Julow/Unexpected-Keyboard/pull/16
@@ -133,38 +156,86 @@ and other extra keys to show.

 The list of language tags (generally two letters)
 and locales (generally of the form `xx_XX`)
-can be found in this stackoverflow answer: https://stackoverflow.com/a/7989085
+can be found in this [stackoverflow answer](https://stackoverflow.com/a/7989085)

-### Translations
+### Updating translations

-Translations are always welcome !
+The text used in the app is written in `res/values-<language_tag>/strings.xml`.

-See for example: 1723288 (Latvian), baf867a (French).
-The app can be translated by writing `res/values-<language code>/strings.xml`
-(for example `values-fr`, `values-lv`), based on the default:
-`res/values/strings.xml` (English).
+The list of language tags can be found in this
+[stackoverflow answer](https://stackoverflow.com/a/7989085)

-To check that `strings.xml` is formatted correctly, run
-`python sync_translations.py`. This will modify your files.
+The first part before the `_` is used, for example,
+`res/values-fr/strings.xml` for French,
+`res/values-lv/strings.xml` for Latvian.

-The store description is found in `metadata/android/<locale>/`,
-`short_description.txt` and `full_description.txt`.
-The short description must not exceed 80 characters.
+Commented-out lines indicate missing translations:
+
+```xml
+  <!-- <string name="pref_layouts_add">Add an alternate layout</string> -->
+```
+
+Remove the `<!--` and `-->` parts and change the text.
+
+### Adding a translation
+
+The preferred method for translating the app is to use Weblate:
+https://hosted.weblate.org/engage/unexpected-keyboard/
+
+The `res/values-<language_tag>/strings.xml` file must be created by copying the
+default translation in `res/values/strings.xml`, which contain the structure of
+the file and the English strings.
+
+Store descriptions in `fastlane/metadata/android/` are updated automatically.
 Translating changelogs is not useful.

-The app name might be partially translated, the "unexpected" word should remain
-untranslated.
+The app name might be partially translated, the "Unexpected" word should remain
+untranslated if possible.

 As translations need to be updated regularly, you can subscribe to this issue
 to receive a notification when an update is needed:
 https://github.com/Julow/Unexpected-Keyboard/issues/373

-### Adding key combinations
+### Adding symbols to Shift, Fn, Compose and other modifiers

-Key combinations are defined in `srcs/juloo.keyboard2/KeyModifier.java`.
-For example, keys modified by the `Fn` key are defined in method
-`apply_fn_char`.
+New key combinations can be added to builtin modifiers in the following files:

-Keys with special meaning are defined in `KeyValue.java` in method
-`getKeyByName`. Their special action are defined in `KeyEventHandler.java` in
-method `key_up`
+- Shift in `srcs/compose/shift.json`.
+- Fn in `srcs/compose/fn.json`.
+- Compose in `srcs/compose/compose/extra.json`.
+- Other modifiers are defined in the `accent_*.json` files in `srcs/compose`.
+
+Generated code must then be updated by running:
+
+```
+./gradlew compileComposeSequences
+```
+
+These files describe each symbols that get transformed when a given modifier is
+activated, in JSON format. For example:
+
+Example from `fn.json`, when `Fn` is activated, `<` becomes `«`:
+```json
+{
+  "<": "«",
+}
+```
+
+The result of a sequence can be a key name. See the list of key names in
+[doc/Possible-key-values.md](doc/Possible-key-values.md). For example from
+`fn.json`, when `Fn` is activated, space becomes `nbsp`:
+```json
+{
+  " ": "nbsp",
+}
+```
+
+Compose sequences are made of several steps. For example, the sequence
+`Compose V s = Š` is defined as:
+```json
+{
+  "V": {
+    "s": "Š"
+  }
+}
+```
@@ -1,139 +0,0 @@
-# Configuration
-
-PACKAGE_NAME = juloo.keyboard2
-
-ANDROID_PLATFORM_VERSION = android-30
-JAVA_VERSION = 1.7
-
-SRC_DIR = srcs
-RES_DIR = res
-
-EXTRA_JARS =
-
-# /
-
-debug: _build/$(PACKAGE_NAME).debug.apk
-release: _build/$(PACKAGE_NAME).apk
-
-installd: _build/$(PACKAGE_NAME).debug.apk
-	adb install -r "$<"
-
-clean:
-	rm -rf _build/*.dex _build/class _build/gen _build/*.apk _build/*.unsigned-apk \
-		_build/*.idsig _build/assets
-
-rebuild_special_font: _build/special_font.ttf
-	cp "$<" srcs/special_font/result.ttf
-
-sync_translations:
-	python sync_translations.py
-
-check_layouts:
-	python check_layout.py $(wildcard res/xml/*.xml) > check_layout.output
-
-gen_layouts:
-	python gen_layouts.py
-
-# Will modify the source tree.
-runtest: rebuild_special_font sync_translations check_layouts gen_layouts
-
-.PHONY: release debug installd clean rebuild_special_font check_layouts \
-	sync_translations runtest gen_layouts
-
-$(shell mkdir -p _build)
-
-ifndef ANDROID_HOME
-$(error ANDROID_HOME not set)
-endif
-
-ANDROID_BUILD_TOOLS = $(lastword $(sort $(wildcard $(ANDROID_HOME)/build-tools/*)))
-ANDROID_PLATFORM = $(ANDROID_HOME)/platforms/$(ANDROID_PLATFORM_VERSION)
-
-ifeq ($(shell [ -d "$(ANDROID_PLATFORM)" ] && echo ok),)
-$(error Android platform not found. Want $(ANDROID_PLATFORM_VERSION), \
-	found $(notdir $(wildcard $(ANDROID_HOME)/platforms/*)))
-endif
-
-JAVAC_FLAGS = -source $(JAVA_VERSION) -target $(JAVA_VERSION) -encoding utf8
-
-# Source files
-
-MANIFEST_FILE = AndroidManifest.xml
-JAVA_FILES = $(shell find $(SRC_DIR) -name '*.java')
-RES_FILES = $(shell find $(RES_DIR) -type f)
-
-# Debug signing
-
-DEBUG_KEYSTORE = _build/debug.keystore
-DEBUG_PASSWD = debug0
-
-$(DEBUG_KEYSTORE):
-	echo y | keytool -genkeypair -dname "cn=d, ou=e, o=b, c=ug" \
-		-alias debug -keypass $(DEBUG_PASSWD) -keystore "$@" \
-		-keyalg rsa -storepass $(DEBUG_PASSWD) -validity 10000
-
-_build/%.debug.apk: _build/%.debug.unsigned-apk $(DEBUG_KEYSTORE)
-	$(ANDROID_BUILD_TOOLS)/apksigner sign --in "$<" --out "$@" \
-		--ks $(DEBUG_KEYSTORE) --ks-key-alias debug --ks-pass "pass:$(DEBUG_PASSWD)"
-
-# Debug apk
-
-_build/$(PACKAGE_NAME).debug.unsigned-apk: AAPT_PACKAGE_FLAGS+=--rename-manifest-package $(PACKAGE_NAME).debug --product debug
-
-# Release signing
-
-# %-keystore.conf should declare KEYSTORE, KEYNAME and KEYSTOREPASS
-#  it is interpreted as a shell script
-_build/%.apk: _build/%.unsigned-apk %-keystore.conf
-	eval `cat $(word 2,$^)` && \
-	$(ANDROID_BUILD_TOOLS)/apksigner sign --in "$<" --out "$@" \
-		--ks "$$KEYSTORE" --ks-key-alias "$$KEYNAME" --ks-pass "pass:$$KEYSTOREPASS"
-
-# Package
-
-_build/%.unsigned-apk: _build/%.unaligned-apk
-	$(ANDROID_BUILD_TOOLS)/zipalign -fp 4 "$<" "$@"
-
-APK_EXTRA_FILES = classes.dex assets/special_font.ttf
-
-_build/%.unaligned-apk: $(addprefix _build/,$(APK_EXTRA_FILES)) $(MANIFEST_FILE)
-	$(ANDROID_BUILD_TOOLS)/aapt package -f -M $(MANIFEST_FILE) -S $(RES_DIR) \
-		-I $(ANDROID_PLATFORM)/android.jar -F "$@" $(AAPT_PACKAGE_FLAGS)
-	cd $(@D) && $(ANDROID_BUILD_TOOLS)/aapt add $(@F) $(APK_EXTRA_FILES)
-
-# Copy the special font file into _build because aapt requires relative paths
-_build/assets/special_font.ttf: srcs/special_font/result.ttf
-	mkdir -p $(@D)
-	cp "$<" "$@"
-
-# R.java
-
-GEN_DIR = _build/gen
-R_FILE = $(GEN_DIR)/$(subst .,/,$(PACKAGE_NAME))/R.java
-
-$(R_FILE): $(RES_FILES) $(MANIFEST_FILE)
-	mkdir -p "$(@D)"
-	$(ANDROID_BUILD_TOOLS)/aapt package -f -m -S $(RES_DIR) -J $(GEN_DIR) \
-		-M $(MANIFEST_FILE) -I $(ANDROID_PLATFORM)/android.jar
-
-# Compile java classes and build classes.dex
-
-OBJ_DIR = _build/class
-# A$B.class files are ignored
-# CLASS_FILES = $(JAVA_FILES:$(SRC_DIR)/%.java=$(OBJ_DIR)/%.class) \
-# 	$(R_FILE:$(GEN_DIR)/%.java=$(OBJ_DIR)/%.class)
-
-_build/classes.dex: $(JAVA_FILES) $(R_FILE)
-	mkdir -p $(OBJ_DIR)
-	javac -d $(OBJ_DIR) $(JAVAC_FLAGS) \
-		-classpath $(ANDROID_PLATFORM)/android.jar:$(EXTRA_JARS) \
-		-sourcepath $(SRC_DIR):$(GEN_DIR) \
-		$^
-	$(ANDROID_BUILD_TOOLS)/d8 --output $(@D) $(OBJ_DIR)/*/*/* $(subst :, ,$(EXTRA_JARS))
-
-# Font file
-
-FONT_GLYPHS = $(wildcard srcs/special_font/*.svg)
-
-_build/special_font.ttf: srcs/special_font/build.pe $(FONT_GLYPHS)
-	fontforge -lang=ff -script $< "$@" $(FONT_GLYPHS)
@@ -1,4 +1,12 @@
-# Unexpected Keyboard
+# Unexpected Keyboard [<img src="https://hosted.weblate.org/widget/unexpected-keyboard/svg-badge.svg" alt="État de la traduction" />](https://hosted.weblate.org/engage/unexpected-keyboard/)
+
+---
+
+⚠️ Google wants to kill the open-source Android community.
+
+See [keepandroidopen.org](https://keepandroidopen.org/) and the [F-Droid blog](https://f-droid.org/en/2025/09/29/google-developer-registration-decree.html).
+
+---

 [<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
     alt="Get it on F-Droid"
@@ -9,21 +17,32 @@

 Lightweight and privacy-conscious virtual keyboard for Android.

-| <img src="/metadata/android/en-US/images/phoneScreenshots/1.png" alt="Screenshot-1" /> | <img src="/metadata/android/en-US/images/phoneScreenshots/2.png" alt="Screenshot-2"/> | <img src="/metadata/android/en-US/images/phoneScreenshots/3.png" alt="Screenshot-3"/> |
-| --- | --- | --- |
-| <img src="/metadata/android/en-US/images/phoneScreenshots/4.png" alt="Screenshot-4" /> | <img src="/metadata/android/en-US/images/phoneScreenshots/5.png" alt="Screenshot-5" /> | <img src="/metadata/android/en-US/images/phoneScreenshots/6.png" alt="Screenshot-6" /> |
+https://github.com/Julow/Unexpected-Keyboard/assets/2310568/28f8f6fe-ac13-46f3-8c5e-d62443e16d0d

 The main feature is that you can type more characters by swiping the keys towards the corners.

 This application was originally designed for programmers using Termux.
 Now perfect for everyday use.

-This application contains no ads, doesn't make any network requests and is Open Source.
+This application contains no ads and is open source.

-## Similar apps
-* [Calculator++](https://github.com/Bubu/android-calculatorpp) - Calculator with a similar UX, swipe to corners for advanced math symbols and operators. Works up to Android 13 but maybe unmaintained.
+Usage: to apply the symbols located in the corners of each key, slide your finger in the direction of the symbols. For example, the Settings are opened by sliding in the left down corner.
+
+| <img src="/fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" alt="Screenshot-1" /> | <img src="/fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" alt="Screenshot-2"/> | <img src="/fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" alt="Screenshot-3"/> |
+| --- | --- | --- |
+| <img src="/fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" alt="Screenshot-4" /> | <img src="/fastlane/metadata/android/en-US/images/phoneScreenshots/5.png" alt="Screenshot-5" /> | <img src="/fastlane/metadata/android/en-US/images/phoneScreenshots/6.png" alt="Screenshot-6" /> |
+
+## Help translate the application
+
+Improve the application translations [using Weblate](https://hosted.weblate.org/engage/unexpected-keyboard/).
+
+[<img src="https://hosted.weblate.org/widget/unexpected-keyboard/multi-auto.svg" alt="État de la traduction" />](https://hosted.weblate.org/engage/unexpected-keyboard/)

 ## Contributing

 For instructions on building the application, see
 [Contributing](CONTRIBUTING.md).
+
+## Acknowledgement
+
+The [NLnet foundation](https://nlnet.nl/) funded the work on the spell checking feature.
@@ -0,0 +1,196 @@
+import com.android.build.gradle.internal.api.BaseVariantOutputImpl
+import java.io.FileOutputStream
+
+plugins {
+  id("com.android.application") version "8.13.2"
+}
+
+dependencies {
+  // Following versions of androidx.window require sdk version 23
+  implementation("androidx.window:window-java:1.4.0")
+  implementation("androidx.core:core:1.16.0") // Version 1.17.0 available with sdk 36
+  testImplementation("junit:junit:4.13.2")
+}
+
+android {
+  namespace = "juloo.keyboard2"
+  compileSdkVersion = "android-36"
+
+  defaultConfig {
+    applicationId = "harley.keyboard"
+    minSdk = 21
+    targetSdk { version = release(36) }
+    versionCode = 55
+    versionName = "2.0.4"
+  }
+
+  sourceSets {
+    named("main") {
+      manifest.srcFile("AndroidManifest.xml")
+      java.srcDirs("srcs/juloo.keyboard2", "vendor/cdict/java/juloo.cdict")
+      res.srcDirs("res", "build/generated-resources")
+      assets.srcDirs("assets")
+    }
+
+    named("test") {
+      java.srcDirs("test")
+    }
+  }
+
+  externalNativeBuild {
+    ndkBuild {
+      path = file("vendor/Android.mk")
+    }
+  }
+
+  signingConfigs {
+    // Debug builds will always be signed. If no environment variables are set, a default
+    // keystore will be initialized by the task initDebugKeystore and used. This keystore
+    // can be uploaded to GitHub secrets by following instructions in CONTRIBUTING.md
+    // in order to always receive correctly signed debug APKs from the CI.
+    named("debug") {
+      storeFile = file(System.getenv("DEBUG_KEYSTORE") ?: "debug.keystore")
+      storePassword = System.getenv("DEBUG_KEYSTORE_PASSWORD") ?: "debug0"
+      keyAlias = System.getenv("DEBUG_KEY_ALIAS") ?: "debug"
+      keyPassword = System.getenv("DEBUG_KEY_PASSWORD") ?: "debug0"
+    }
+
+    create("release") {
+      val ks = System.getenv("RELEASE_KEYSTORE")
+      if (ks != null) {
+        storeFile = file(ks)
+        storePassword = System.getenv("RELEASE_KEYSTORE_PASSWORD")
+        keyAlias = System.getenv("RELEASE_KEY_ALIAS")
+        keyPassword = System.getenv("RELEASE_KEY_PASSWORD")
+      }
+    }
+  }
+
+  buildTypes {
+    named("release") {
+      isMinifyEnabled = true
+      proguardFiles(
+        getDefaultProguardFile("proguard-android-optimize.txt"),
+        "proguard-rules.pro")
+      isShrinkResources = true
+      isDebuggable = false
+      resValue("string", "app_name", "@string/app_name_release")
+      signingConfig = signingConfigs["release"]
+    }
+
+    named("debug") {
+      isMinifyEnabled = false
+      isShrinkResources = false
+      isDebuggable = true
+      resValue("string", "app_name", "@string/app_name_debug")
+      resValue("bool", "debug_logs", "true")
+      signingConfig = signingConfigs["debug"]
+    }
+  }
+
+  compileOptions {
+    sourceCompatibility = JavaVersion.VERSION_1_8
+    targetCompatibility = JavaVersion.VERSION_1_8
+  }
+}
+
+
+// This raises an error with an informative message instead of the confusing
+// ndk-build errors that occur when submodules are not initialized.
+gradle.projectsEvaluated {
+  if (!file("vendor/cdict/java").exists())
+    throw GradleException("Git submodules not initialized. Run 'git submodule update --init'")
+}
+
+val buildKeyboardFont by tasks.registering(Exec::class) {
+  val `in` = projectDir.resolve("srcs/special_font")
+  val out = layout.projectDirectory.file("assets/special_font.ttf")
+  inputs.dir(`in`)
+  outputs.file(out)
+  doFirst { println("\nBuilding assets/special_font.ttf") }
+  workingDir = `in`
+  val svgFiles = `in`.listFiles()!!.filter {
+    it.isFile && it.name.endsWith(".svg")
+  }.toTypedArray()
+  commandLine("fontforge", "-lang=ff", "-script", "build.pe", out.asFile.absolutePath, *svgFiles)
+}
+
+val genEmojis by tasks.registering(Exec::class) {
+  doFirst { println("\nGenerating res/raw/emojis.txt") }
+  workingDir = projectDir
+  commandLine("python", "gen_emoji.py")
+}
+
+val genLayoutsList by tasks.registering(Exec::class) {
+  inputs.dir(projectDir.resolve("srcs/layouts"))
+  outputs.file(projectDir.resolve("res/values/layouts.xml"))
+  doFirst { println("\nGenerating res/values/layouts.xml") }
+  workingDir = projectDir
+  commandLine("python", "gen_layouts.py")
+}
+
+val genMethodXml by tasks.registering(Exec::class) {
+  val out = projectDir.resolve("res/xml/method.xml")
+  inputs.file(projectDir.resolve("gen_method_xml.py"))
+  inputs.file(projectDir.resolve("res/values/dictionaries.xml"))
+  outputs.file(out)
+  doFirst { println("\nGenerating res/xml/method.xml") }
+  doFirst { standardOutput = FileOutputStream(out) }
+  workingDir = projectDir
+  commandLine("python", "gen_method_xml.py")
+}
+
+val checkKeyboardLayouts by tasks.registering(Exec::class) {
+  inputs.dir(projectDir.resolve("srcs/layouts"))
+  inputs.file(projectDir.resolve("srcs/juloo.keyboard2/KeyValue.java"))
+  outputs.file(projectDir.resolve("check_layout.output"))
+  doFirst { println("\nChecking layouts") }
+  workingDir = projectDir
+  commandLine("python", "check_layout.py")
+}
+
+val compileComposeSequences by tasks.registering(Exec::class) {
+  val `in` = projectDir.resolve("srcs/compose")
+  val out = projectDir.resolve("srcs/juloo.keyboard2/ComposeKeyData.java")
+  inputs.dir(`in`)
+  outputs.file(out)
+  doFirst { println("\nGenerating $out") }
+  val sequences = `in`.listFiles { it: File ->
+    !it.name.endsWith(".py") && !it.name.endsWith(".md")
+  }!!.map { it.absolutePath }.toTypedArray()
+  workingDir = projectDir
+  commandLine("python", `in`.resolve("compile.py").absolutePath, *sequences)
+  doFirst { standardOutput = FileOutputStream(out) }
+}
+
+tasks.withType(Test::class).configureEach {
+  dependsOn(genLayoutsList, checkKeyboardLayouts, compileComposeSequences, genMethodXml)
+}
+
+val initDebugKeystore by tasks.registering(Exec::class) {
+  doFirst { println("Initializing default debug keystore") }
+  isEnabled = !file("debug.keystore").exists()
+  // A shell script might be needed if this line requires input from the user
+  commandLine("keytool", "-genkeypair", "-dname", "cn=d, ou=e, o=b, c=ug", "-alias", "debug", "-keypass", "debug0", "-keystore", "debug.keystore", "-keyalg", "rsa", "-storepass", "debug0", "-validity", "10000")
+}
+
+// latn_qwerty_us is used as a raw resource by the custom layout option.
+val copyRawQwertyUS by tasks.registering(Copy::class) {
+  from("srcs/layouts/latn_qwerty_us.xml")
+  into("build/generated-resources/raw")
+}
+
+val copyLayoutDefinitions by tasks.registering(Copy::class) {
+  from("srcs/layouts")
+  include("*.xml")
+  into("build/generated-resources/xml")
+}
+
+tasks.named("preBuild") {
+  dependsOn(initDebugKeystore, copyRawQwertyUS, copyLayoutDefinitions)
+  // 'mustRunAfter' defines ordering between tasks (which is required by
+  // Gradle) but doesn't create a dependency. These rules update files that are
+  // checked in the repository that don't need to be updated during regular
+  // builds.
+  mustRunAfter(genEmojis, genLayoutsList, compileComposeSequences, genMethodXml)
+}
@@ -1,117 +1,32 @@
-# res/xml/arab_alt.xml
-Layout includes some ASCII punctuation but not all, missing: !, ", ', +, -, /, :, ;, <, =, >, ?, [, \, ], _, |, ~
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-2 warnings
-# res/xml/arab_pc_ckb.xml
-Layout includes some ASCII punctuation but not all, missing: ", %, ', +, ,, ., :, ;, <, =, >, ?, `, |, ~
-1 warnings
-# res/xml/arab_pc_ir.xml
-Duplicate keys: (, )
-Layout includes some ASCII punctuation but not all, missing: ", %, ', ,, /, ;, <, =, >, ?, [, \, ], `, {, |, }
-2 warnings
-# res/xml/arab_pc.xml
-Layout includes some ASCII punctuation but not all, missing: !, ', +, ;, ?, \, |
-1 warnings
-# res/xml/beng_national.xml
-Layout includes some ASCII punctuation but not all, missing: $
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-Layout doesn't specify a script.
-3 warnings
-# res/xml/beng_provat.xml
-Layout includes some ASCII punctuation but not all, missing: $, &, *, ., /, <, >, [, \, ], `, {, |, }
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-Layout doesn't specify a script.
-3 warnings
-# res/xml/cyrl_jcuken_ru.xml
-0 warnings
-# res/xml/cyrl_jcuken_uk.xml
-0 warnings
-# res/xml/cyrl_yaverti.xml
-Layout includes some ASCII punctuation but not all, missing: ~
-1 warnings
-# res/xml/deva_alt.xml
-Layout includes some ASCII punctuation but not all, missing: #, $, %, &, ', (, ), *, +, ., /, :, <, =, >, @, [, \, ], ^, _, `, {, |, }, ~
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-2 warnings
-# res/xml/deva_inscript.xml
-Duplicate keys: , ।
-Layout includes some ASCII punctuation but not all, missing: ", $, ', ^, _, `, |
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-3 warnings
-# res/xml/grek_qwerty.xml
-Duplicate keys: ;
-1 warnings
-# res/xml/hang_dubeolsik_kr.xml
-0 warnings
-# res/xml/hebr_1_il.xml
-Layout includes some ASCII punctuation but not all, missing: (, ), <, >, [, ], {, }
-1 warnings
-# res/xml/hebr_2_il.xml
-Layout includes some ASCII punctuation but not all, missing: (, ), <, >, [, ], {, }
-1 warnings
-# res/xml/latn_azerty_fr.xml
-0 warnings
-# res/xml/latn_bepo_fr.xml
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-1 warnings
-# res/xml/latn_bone.xml
-Layout includes some ASCII punctuation but not all, missing: $
-Layout redefines the bottom row but some important keys are missing, missing: switch_backward
-2 warnings
-# res/xml/latn_colemak.xml
-0 warnings
-# res/xml/latn_dvorak.xml
-0 warnings
-# res/xml/latn_neo2.xml
-Duplicate keys: -
-Layout redefines the bottom row but some important keys are missing, missing: switch_forward
-2 warnings
-# res/xml/latn_qwerty_br.xml
-0 warnings
-# res/xml/latn_qwerty_es.xml
-0 warnings
-# res/xml/latn_qwerty_hu.xml
-0 warnings
-# res/xml/latn_qwerty_lv.xml
-0 warnings
-# res/xml/latn_qwerty_no.xml
-0 warnings
-# res/xml/latn_qwerty_pl.xml
-0 warnings
-# res/xml/latn_qwerty_ro.xml
-0 warnings
-# res/xml/latn_qwerty_se.xml
-Duplicate keys: !, ', ,, -, ., ?
-1 warnings
-# res/xml/latn_qwerty_tr.xml
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-1 warnings
-# res/xml/latn_qwerty_us.xml
-0 warnings
-# res/xml/latn_qwerty_vi.xml
-Layout includes some ASCII punctuation but not all, missing: \
-1 warnings
-# res/xml/latn_qwertz_cz_multifunctional.xml
-Layout includes some ASCII punctuation but not all, missing: `
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-2 warnings
-# res/xml/latn_qwertz_cz.xml
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-1 warnings
-# res/xml/latn_qwertz_de.xml
-0 warnings
-# res/xml/latn_qwertz_fr_ch.xml
-0 warnings
-# res/xml/latn_qwertz_hu.xml
-0 warnings
-# res/xml/latn_qwertz_sk.xml
-Layout includes some ASCII punctuation but not all, missing: \, `
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-2 warnings
-# res/xml/latn_qwertz.xml
-0 warnings
-# res/xml/urdu_phonetic_ur.xml
-Duplicate keys:  
-Layout includes some ASCII punctuation but not all, missing: <, >, ?, `, |, ~
-Layout doesn't define some important keys, missing: f11_placeholder, f12_placeholder
-3 warnings
+arab_alt: Layout includes some ASCII punctuation but not all, missing: !, ", ', +, -, /, :, ;, <, =, >, ?, [, \, ], _, |, ~
+arab_hamvaj_tly: Layout includes some ASCII punctuation but not all, missing: ", %, ', ,, /, ;, <, =, >, ?, [, \, ], _, `, {, |, }
+arab_pc: Layout includes some ASCII punctuation but not all, missing: !, ', +, ;, ?, \, |
+arab_pc_ckb: Layout includes some ASCII punctuation but not all, missing: ", %, ', +, ,, ;, <, =, >, ?, `, |, ~
+arab_pc_ckb_fa: Layout includes some ASCII punctuation but not all, missing: ", #, $, %, &, ', ,, /, ;, ?, @, \, ^, `, |, ~
+arab_pc_hindu: Layout includes some ASCII punctuation but not all, missing: !, ', +, ;, ?, \, |
+arab_pc_ir: Layout includes some ASCII punctuation but not all, missing: ", %, ', ,, /, ;, <, =, >, ?, [, \, ], `, {, |, }
+armn_cpbsmo: Layout includes some ASCII punctuation but not all, missing: !, ", #, $, %, &, ', *, +, <, =, >, ?, @, [, ], ^, `, {, }, ~
+armn_kvertc: Layout includes some ASCII punctuation but not all, missing: !, ", #, $, %, &, ', *, +, <, =, >, ?, @, [, ], ^, `, {, }, ~
+beng_assamese: Layout includes some ASCII punctuation but not all, missing: #, $, %, &, ', *, +, -, /, :, ;, <, =, >, ?, [, \, ], ^, _, `, {, |, }, ~
+beng_national: Layout includes some ASCII punctuation but not all, missing: $
+beng_provat: Layout includes some ASCII punctuation but not all, missing: $, &, *, ., /, <, >, [, \, ], `, {, |, }
+cyrl_jiuken: Layout includes some ASCII punctuation but not all, missing: #, $, &, ', *, +, <, =, >, @, [, ], ^, _, `, {, }, ~
+cyrl_lynyertdz_mk: Layout includes some ASCII punctuation but not all, missing: "
+cyrl_yaverti: Layout includes some ASCII punctuation but not all, missing: ~
+cyrl_yawerty: Layout includes some ASCII punctuation but not all, missing: #, $, &, ', *, <, >, @, [, ], ^, `, {, }, ~
+cyrl_yxukeng_os: Layout includes some ASCII punctuation but not all, missing: ", #, $, &, ', @, [, ], ~
+deva_alt: Layout includes some ASCII punctuation but not all, missing: #, $, %, &, ', (, ), *, +, ., /, :, <, =, >, [, \, ], ^, _, `, {, |, }, ~
+deva_inscript: Layout includes some ASCII punctuation but not all, missing: ", $, ', ^, _, `, |
+hebr_1_il: Layout includes some ASCII punctuation but not all, missing: (, ), <, >, [, ], {, }
+hebr_2_il: Layout includes some ASCII punctuation but not all, missing: (, ), <, >, [, ], {, }
+kann_kannada: Layout includes some ASCII punctuation but not all, missing: #, $, %, (, ), *, +, /, <, =, >, [, \, ], ^, `, {, |, }, ~
+latin_kbdtuf_tr: Layout includes some ASCII punctuation but not all, missing: $
+latin_kbdtuf_tr: These keys are now added automatically, unexpected: f11_placeholder, f12_placeholder
+latin_kbdtuf_tr: Missing programming keys, missing: loc esc, loc tab
+latn_colemak: Some keys contain whitespaces, unexpected:  ́
+latn_dvorak: Missing important key, missing: loc capslock
+latn_neo2: Layout redefines the bottom row but some important keys are missing, missing: alt, loc switch_clipboard, meta, pgdn, pgup, switch_fn
+latn_qwertz_cz_multifunctional: Layout includes some ASCII punctuation but not all, missing: `
+latn_qwertz_sk: Layout includes some ASCII punctuation but not all, missing: `
+latn_qzerty_it: Layout includes some ASCII punctuation but not all, missing: #, $, \, `, ~
+urdu_phonetic_ur: Layout includes some ASCII punctuation but not all, missing: <, >, ?, `, |, ~
@@ -1,17 +1,26 @@
 import xml.etree.ElementTree as ET
-import sys
+import sys, os, glob, re

-warning_count = 0
+layout_file_name = 0
+warnings = []

 KNOWN_NOT_LAYOUT = set([
-    "res/xml/number_row.xml", "res/xml/numpad.xml", "res/xml/pin.xml",
-    "res/xml/bottom_row.xml", "res/xml/settings.xml", "res/xml/method.xml",
-    "res/xml/greekmath.xml", "res/xml/numeric.xml" ])
+    "number_row", "numpad", "pin",
+    "bottom_row", "settings", "method",
+    "greekmath", "numeric", "emoji_bottom_row",
+    "clipboard_bottom_row" ])
+
+KEY_ATTRIBUTES = set([
+    "key0", "key1", "key2", "key3", "key4", "key5", "key6", "key7", "key8",
+    "c", "nw", "ne", "sw", "se", "w", "e", "n", "s"
+    ])
+
+# Keys defined in KeyValue.java
+known_keys = set()

 def warn(msg):
-    global warning_count
-    print(msg)
-    warning_count += 1
+    global warnings
+    warnings.append("%s: %s" % (layout_file_name, msg))

 def key_list_str(keys):
    return ", ".join(sorted(list(keys)))
@@ -34,46 +43,72 @@ def unexpected_keys(keys, symbols, msg):
    if len(unexpected) > 0:
        warn("%s, unexpected: %s" % (msg, key_list_str(unexpected)))

+def duplicates(keys):
+    dup = [ k for k, key_elts in keys.items() if len(key_elts) >= 2 ]
+    if len(dup) > 0:
+        warn("Duplicate keys: " + key_list_str(dup))
+
+def should_have_role(keys_map, role, keys):
+    def is_center_key(key):
+        def center(key_elt): return key_elt.get("key0", key_elt.get("c"))
+        return any(( center(key_elt) == key for key_elt in keys_map.get(key, []) ))
+    def key_roles(key):
+        return ( key_elt.get("role", "normal") for key_elt in keys_map[key] )
+    for key in keys:
+        if is_center_key(key) and role not in key_roles(key):
+            warn("Key '%s' is not on a key with role=\"%s\"" % (key, role))
+
+# Write to [keys], dict of keyvalue to the key elements they appear in
+def parse_row_from_et(row, keys):
+    for key_elt in row:
+        for attr in key_elt.keys():
+            if attr in KEY_ATTRIBUTES:
+                k = key_elt.get(attr).removeprefix("\\")
+                keys.setdefault(k, []).append(key_elt)
+
 def parse_layout(fname):
-    keys = set()
-    dup = set()
+    keys = {}
    root = ET.parse(fname).getroot()
    if root.tag != "keyboard":
        return None
    for row in root:
-        for key in row:
-            for attr in key.keys():
-                if attr.startswith("key"):
-                    k = key.get(attr).removeprefix("\\")
-                    if k in keys: dup.add(k)
-                    keys.add(k)
-    return root, keys, dup
+        parse_row_from_et(row, keys)
+    return root, keys
+
+def parse_row(fname):
+    keys = {}
+    root = ET.parse(fname).getroot()
+    if root.tag != "row":
+        return None
+    parse_row_from_et(root, keys)
+    return root, keys

 def check_layout(layout):
-    root, keys, dup = layout
-    if len(dup) > 0: warn("Duplicate keys: " + key_list_str(dup))
+    root, keys_map = layout
+    keys = set(keys_map.keys())
+    duplicates(keys_map)
    missing_some_of(keys, "~!@#$%^&*(){}`[]=\\-_;:/.,?<>'\"+|", "ASCII punctuation")
    missing_some_of(keys, "0123456789", "digits")
-    missing_required(keys,
-                     ["esc", "tab", "backspace", "delete",
-                      "f11_placeholder", "f12_placeholder"],
-                     "Layout doesn't define some important keys")
+    missing_required(keys, ["backspace", "delete"], "Layout doesn't define some important keys")
    unexpected_keys(keys,
                    ["copy", "paste", "cut", "selectAll", "shareText",
-                     "pasteAsPlainText", "undo", "redo", "replaceText",
-                     "textAssist", "autofill" ],
+                     "pasteAsPlainText", "undo", "redo" ],
                    "Layout contains editing keys")
    unexpected_keys(keys,
                    [ "f1", "f2", "f3", "f4", "f5", "f6", "f7", "f8", "f9",
                     "f10", "f11", "f12" ],
                    "Layout contains function keys")
+    unexpected_keys(keys, [""], "Layout contains empty strings")
+    unexpected_keys(keys, ["loc"], "Special keyword cannot be a symbol")
+    unexpected_keys(keys, filter(lambda k: k.strip()!=k, keys), "Some keys contain whitespaces")
+    unexpected_keys(keys, ["f11_placeholder", "f12_placeholder"], "These keys are now added automatically")

-    bottom_row_keys = [
-            "ctrl", "fn", "switch_numeric", "change_method", "switch_emoji",
-            "config", "switch_forward", "switch_backward", "enter", "action",
-            "left", "up", "right", "down", "space"
-            ]
+    if root.get("script", "latin") == "latin":
+        missing_required(keys, ["shift", "loc capslock"], "Missing important key")
+        missing_required(keys, ["loc esc", "loc tab"], "Missing programming keys")

+    _, bottom_row_keys_map = parse_row("res/xml/bottom_row.xml")
+    bottom_row_keys = set(bottom_row_keys_map.keys())
    if root.get("bottom_row") == "false":
        missing_required(keys, bottom_row_keys,
                         "Layout redefines the bottom row but some important keys are missing")
@@ -84,14 +119,38 @@ def check_layout(layout):
    if root.get("script") == None:
        warn("Layout doesn't specify a script.")

-for fname in sys.argv[1:]:
-    if fname in KNOWN_NOT_LAYOUT:
+    should_have_role(keys_map, "action",
+                     [ "shift", "ctrl", "fn", "backspace", "enter" ])
+    should_have_role(keys_map, "space_bar", [ "space" ])
+
+    keys_without_loc = set(( k.removeprefix("loc ") for k in keys ))
+    # Keys with a len under 3 are often composed characters
+    special_keys = set(( k for k in keys_without_loc if len(k) > 3 and ":" not in k ))
+    unknown = special_keys.difference(known_keys)
+    if len(unknown) > 0:
+        warn("Layout contains unknown keys: %s" % key_list_str(unknown))
+
+# Fill 'known_keys', which is used for some checks
+def parse_known_keys():
+    global known_keys
+    with open("srcs/juloo.keyboard2/KeyValue.java", "r", encoding="utf-8") as f:
+        known_keys = set(
+                ( m.group(1) for m in re.finditer('case "([^"]+)":', f.read()) )
+                )
+
+parse_known_keys()
+
+for fname in sorted(glob.glob("srcs/layouts/*.xml")):
+    layout_id, _ = os.path.splitext(os.path.basename(fname))
+    if layout_id in KNOWN_NOT_LAYOUT:
        continue
+    layout_file_name = layout_id
    layout = parse_layout(fname)
    if layout == None:
-        print("Not a layout file: %s" % fname)
+        warn("Not a layout file")
    else:
-        print("# %s" % fname)
-        warning_count = 0
        check_layout(layout)
-        print("%d warnings" % warning_count)
+
+with open("check_layout.output", "w", encoding="utf-8") as out:
+    for w in warnings:
+        print(w, file=out)
@@ -0,0 +1,163 @@
+# Custom layouts
+You select a key layout for Unexpected Keyboard by calling up the Settings page (swipe the gear icon) and, at the top of the page, either tapping an existing layout or tapping _Add an alternate layout_. This displays a menu of available layouts. You can define your own layout by choosing _Custom layout_ at the bottom of this menu. Unexpected Keyboard now displays code in the XML format. You make changes by replacing this with different code and tapping OK.
+
+We recommend you keep your work in a file outside Unexpected Keyboard (named something like `MyChanges.xml`). If you installed a new version of Unexpected from a different website (with a different signature), then the work you did solely by editing the XML inside Unexpected would be lost.
+
+Put initial contents into your file in one of these ways:
+* Copypaste the code Unexpected displays for _Custom layout_.
+* Make a copy of one of the built-in layouts found in [`/srcs/layouts`](https://github.com/Julow/Unexpected-Keyboard/tree/master/srcs/layouts).
+* Use the [web-based editor](https://domportera.github.io/app-unexpected-keyboard-layout-editor/). Interact with this web page to define keys and swipes and move keys to desired positions, and it will write the XML code for you. You can make the web page put the XML in a text file or copy it to the clipboard.
+
+When you have prepared suitable XML code in one of these ways, copy it to the clipboard and paste it into Unexpected Keyboard.
+
+## XML language overview
+A layout XML file comprises tags that start with `<` and end with `>`.
+* Every layout file starts with this declaration:
+  `<?xml version="1.0" encoding="utf-8"?>`
+* Certain tags come in pairs—an opening tag and a closing tag—and apply to everything between them.
+  * The `<keyboard>`...`</keyboard>` pair says that the material between them is the definition of your keyboard. There can be only one of these.
+  * The `<row>`...`</row>` pair encloses the definition of a single row.
+  * An optional `<modmap>`...`</modmap>` pair contains instructions if you want to change the behavior of a modifier key such as Shift.
+* Stand-alone tags include `<key`...`/>`, which defines a single key.
+
+A tag can have properties, defined using an equals sign and a pair of ASCII double quotes. For example, `<key c="a" />` defines the "a" key. The `c` property of the `key` tag says which key you are defining, and the tag's location inside `<row>`...`</row>` specifies where it will go in the row.
+
+### Example
+Here is a complete keyboard file with a single row containing an "a" key on the left and a "b" key on the right:
+
+    <?xml version="1.0" encoding="utf-8"?>
+    <keyboard name="Simple example" script="latin">
+        <row>
+            <key c="a" />
+            <key c="b" />
+        </row>
+    </keyboard>
+
+## Keyboard metadata
+
+The `<keyboard>`...`</keyboard>` pair follows the declaration tag and encloses the whole keyboard. The following properties may be used (The first two appear in the example above):
+
+* `name`: The name of the keyboard. The name you specify will appear in the Settings menu. If not present, the layout will just appear as “Custom layout”.
+
+* `script`: The (main) writing system that the keyboard supports. The possible values are `arabic`, `armenian`, `bengali`, `cyrillic`, `devanagari`, `gujarati`, `hangul`, `hebrew`, `latin`, `persian`, `shavian`, and `urdu`. It defaults to `latin`.
+
+* `numpad_script`: The script to use for the numpad. This is useful for scripts where a different, non-ASCII set of numerals is used, like Devanagari and Arabic. It defaults to the same as `script`.
+
+* `bottom_row`: Whether or not to show the built-in bottom row. It accepts `true` or `false`, and defaults to `true`. If your custom layout defines the bottom row, then specify `bottom_row="false"` to disable the built-in bottom row.
+  + We recommend your layout use the built-in bottom row, because it is still evolving and your layout will incorporate innovations in future versions. However, to define your own, the current definition of the bottom row is in [bottom_row.xml](https://github.com/Julow/Unexpected-Keyboard/blob/master/res/xml/bottom_row.xml). You can copypaste this XML into your custom layout as a starting point.
+  + Likewise, the current definition of the top (number) row is in [number_row.xml](https://github.com/Julow/Unexpected-Keyboard/blob/master/res/xml/number_row.xml).
+
+* `embedded_number_row`: Whether the layout has an embedded number row, and thus the "Show number row" setting shouldn't add another one. It accepts `true` or `false`, and defaults to `false`.
+
+* `locale_extra_keys`: Whether Unexpected should add language-dependent extra keys from [method.xml](../res/xml/method.xml) to this layout. It accepts `true` or `false`, and defaults to `true`. To disable these automatic additions, specify `locale_extra_keys="false"`.
+
+## Row
+The `<row>`...`</row>` pair encloses one row on the keyboard. It has the following optional property:
+* `height`: The height of the row: a positive floating-point value.
+
+* `scale`: A positive floating-point value. If present, scale the width of each key so that the total is equal to the specified value, in key width unit.
+
+A row's default height is 1.0 (one quarter of the keyboard height specified on the Settings menu). The `height` property makes the row taller or shorter than this. For example, if you define a 5-row keyboard but one row has `height="0.7"`, then the keyboard's total height is 4.7 units. If the total is different from 4.0, the keyboard will be taller or shorter than that specified in Settings.
+
+(A row of keys is drawn with a minimum height of 0.5 even if you specify a smaller value for `height`. There is no such minimum for a row without keys, such as a spacer row.)
+
+## Key
+The `<key />` tag defines a key on the keyboard. Its position in the sequence of keys inside `<row>`...`</row>` indicates its position in the row from left to right. What the key does is defined by optional properties.
+
+### Taps
+What the key does when tapped is defined by the optional `c` property. For example, `<key c="a" />` defines the "a" key. Unexpected Keyboard provides a legend in the middle of the key.
+
+When the Shift modifier is tapped, the "a" key becomes the "A" key and the legend temporarily changes. The Fn modifier makes a different change. You can override this behavior with a modmap (see below).
+
+### Swipes
+The following optional properties define the effects of swipes:
+* `n`, `ne`, `e`, `se`, `s`, `sw`, `w`, `nw`: What the key should do when it is swiped in the direction of that compass point. ("North" means upward and "East" is to the right.)
+<TABLE ALIGN=CENTER>
+  <TR>
+    <TD STYLE="width: 6em;">nw</TD><TD>n</TD><TD>ne</TD>
+  </TR>
+  <TR ALIGN=CENTER>
+    <TD>w</TD><TD>c</TD><TD>e</TD>
+  </TR>
+  <TR>
+    <TD>sw</TD><TD>s</TD><TD>se</TD>
+  </TR>
+</TABLE>
+
+* `key1` through `key8` is an older way to achieve the same effects. The directions are ordered as follows:
+<TABLE ALIGN=CENTER>
+  <TR>
+    <TD>key1</TD><TD>key7</TD><TD>key2</TD>
+  </TR>
+  <TR>
+    <TD>key5</TD><TD>key0</TD><TD>key6</TD>
+  </TR>
+  <TR>
+    <TD>key3</TD><TD>key8</TD><TD>key4</TD>
+  </TR>
+</TABLE>
+
+You can define a swipe only once with either compass-point or numeric notation. Unexpected Keyboard automatically puts a small legend in that direction from the center of the key.
+
+* `anticircle`: The key value to send when doing an anti-clockwise gesture on the key.
+
+### Layout
+A key may have the following properties to control the row's layout:
+* `width`: The width of the key, a positive floating-point value. It defaults to 1.0
+* `shift`: How much empty space to add to the left of this key, a non-negative floating-point value. It defaults to 0.0
+
+Normally, a key's width is 1.0 unit. Unexpected Keyboard occupies the full width of the screen, and the row defining the highest number of units (in widths plus shifts) is as wide as the screen. A row whose width is a smaller number of units has empty space on the right.
+
+### Extra legend
+* `indication`: An optional extra legend to show under the main label. For example, `<key c="2" indication="ABC" />` displays ABC at the bottom of the 2 key, as on a pinpad or some telephones. If the key also defines a downward swipe with `s` or `key8`, the legends overlap.
+
+### Possible key values
+Built-in strings that assign a special function to a key are described in [this page](Possible-key-values.md). For example, `se="copy"` means a southeasterly swipe produces the Copy key. If a key value does not match any of the built-in strings, it outputs that text _verbatim_. For example, `c="a"` simply outputs the letter a.
+
+In a layout, a key value can also start with the `loc` prefix. These are place-holders; the tap or swipe does nothing unless enabled through the "Add keys to keyboard" option in the Settings menu, or implicitly enabled by the language the device is set to use. For example, `ne="loc accent_aigu"` says that a northeast swipe produces the acute accent combinatorial key—if enabled.
+
+## Modmap
+The `<modmap>`...`</modmap>` pair encloses custom mappings for modifier keys. The modmap is placed inside the `<keyboard>`...`</keyboard>` pair, but outside any row. A layout can have at most one modmap. It can contain any number of mappings. Each mapping has an `a` property and a `b` property and maps the `a` key to the `b` key. Valid values are listed in [Possible key values](Possible-key-values.md).
+
+The following mappings are supported:
+
+```xml
+  <shift a="before" b="after" />
+```
+This means that when the Shift modifier is on, the key `before` is changed into `after`.
+
+```xml
+  <fn a="before" b="after" />
+```
+This means that when the Fn modifier is on, the key `before` is changed into `after`.
+
+```xml
+  <ctrl a="before" b="after" />
+```
+This means that when the Ctrl modifier is on, the key `before` is changed into `after`. The `<ctrl />` mapping is special in that the Ctrl modifier is applied to `after` after the mapping.
+
+The clockwise circle and the round-trip gestures are affected by the `<fn />` mappings. Otherwise, they are defined by the Shift mappings (including the `<shift />` mappings), then, if that did not modify the key, the builtin Fn mappings are used instead.
+
+### Examples
+① Turkish keyboards use the Latin alphabet, but when "i" is shifted, it should produce "İ". This is achieved with the following mapping: 
+
+```xml
+    <shift a="i" b="İ" />
+```
+② Cyrillic layouts have no V key. A layout can define Ctrl-V with the following mapping:
+
+```xml
+    <ctrl a="в" b="v" />
+```
+This maps Ctrl+в to Ctrl+V—not to v.
+
+### Default mappings
+Unexpected Keyboard's built-in mappings are not expressed as a modmap but by a series of .json files in `https://github.com/Julow/Unexpected-Keyboard/tree/master/srcs/compose`. For example, the mappings for `fn` are in [`fn.json`](https://github.com/Julow/Unexpected-Keyboard/blob/master/srcs/compose/fn.json). These built-in mappings are common to every language.
+
+## Portrait vs. landscape
+Unexpected Keyboard remembers *separately* which layout has last been used in portrait and landscape orientation. So you may have one custom layout for portrait orientation, but another custom layout for landscape orientation, and Unexpected Keyboard will switch between them without your intervention.
+
+## Contributing your layout
+The Unexpected Keyboard project enthusiastically accepts user contributions, including custom layouts. (See the guidance for layouts at [CONTRIBUTING.md](https://github.com/Julow/Unexpected-Keyboard/blob/master/CONTRIBUTING.md#Adding-a-layout)).
+* Submit a layout that has innovations of possible interest to other users at [Unexpected-Keyboard-layouts](https://github.com/Julow/Unexpected-Keyboard-layouts).
+* Propose that your layout be included in the set of built-in layouts by making a Pull Request for an addition to [srcs/layouts](https://github.com/Julow/Unexpected-Keyboard/tree/master/srcs/layouts). Please show that such a layout is standard in your locale or has a substantial number of users.
@@ -0,0 +1,213 @@
+# Key values
+
+A key value defines what a key on the keyboard does when pressed or swiped.
+
+Key values appear in the following places:
+
+- In custom layouts, they are the value of: the `c` attribute, the compass-point attributes `nw` ... `se`, and the old-style `key0` ... `key8` attributes.
+- Internally, they are used in the definition of the "Add keys to the keyboard" setting.
+
+Key values can be any of the following:
+
+- The name of a special key. A complete list of valid special keys follows.
+
+- An arbitrary sequence of characters not containing `:`.
+  This results in a key that writes the specified characters.
+
+- The syntax `legend:key_def`.
+  `legend` is the visible legend on the keyboard. It cannot contain `:`.
+  `key_def` can be:
+  + The name of a special key, as listed below.
+  + `'string'` An arbitrary string that can contain `:`. `'` can be added to the string as `` \' ``.
+  + `keyevent:keycode` An Android keycode. They are listed as `KEYCODE_...` in [KeyEvent](https://developer.android.com/reference/android/view/KeyEvent#summary).
+
+  Examples:
+  + `⏯:keyevent:85` A play/pause key (which has no effect in most apps).
+  + `my@:'my.email@domain.com'` A key that sends an arbitrary string
+
+- A macro, `legend:key_def1,key_def2,...`.
+  This results in a key with legend `legend` that behaves as if the sequence of `key_def` had been pressed in order.
+
+  Examples:
+  + `CA:ctrl,a,ctrl,c` A key with legend CA that sends the sequence `ctrl+a`, `ctrl+c`.
+  + `Cd:ctrl,backspace` A key with legend Cd that sends the shortcut `ctrl+backspace`.
+
+### Escape codes
+
+When defining a key value, several characters have special effects. If you want a character not to have its usual effect but to be taken literally, you should "escape" it in the usual way for XML:
+
+To get this character... | ...you can type
+:---- | :------
+A literal newline character, which is different from `enter` and `action` in certain apps. | `\n`
+A literal tab character, which is different from `tab` in certain apps. | `\t`
+`&` | `&amp;`
+`<` | `&lt;`
+`>` | `&gt;`
+`"` | `&quot;`
+
+The characters `\` (unless followed by n or t), `?`, `#`, and `@` do not need to be escaped when writing custom layouts. When writing a layout to be included in the app (in [srcs/layouts](https://github.com/Julow/Unexpected-Keyboard/tree/master/srcs/layouts)), they are represented by typing `\\`, `\?`, `\#`, and `\@`.
+
+The characters `,` and `:` can be escaped in a key value, using single quotes. For example, this macro defines a key with legend `http` that sends a string containing `:`: `<key c="http:home,'https://'" />` For simplicity, `,` and `:` cannot be escaped in the key legend.
+
+## Modifiers
+System modifiers are sent to the app, which can take app-specific action.
+
+Value       | Meaning
+:---------- | :------
+`shift`     | System modifier.
+`ctrl`      | System modifier.
+`alt`       | System modifier.
+`meta`      | System modifier. Equivalent to the Windows key.
+
+The other modifiers take effect only within the keyboard.
+
+Value       | Meaning
+:---------- | :------
+`fn`        | Activates Fn mode, which assigns letters and symbols to special characters. Example: `fn` `!` = `¡`
+`compose`   | Compose key. Enables composing characters using Linux-like shortcuts. Example: `Compose` `A` `'` types `Á` (A with acute accent).
+`capslock`  | Activates and locks Shift.
+
+## App function keys
+These keys are sent to apps, which are free to ignore them. The keyboard does not perform editing in response to these keys.
+
+`esc`, `enter`,
+`up`, `right`,
+`down`, `left`,
+`page_up`, `page_down`,
+`home`, `end`,
+`backspace`, `delete`,
+`insert`, `scroll_lock`,
+`f1`-`f12`,
+`tab`, `copy`,
+`paste`, `cut`,
+`selectAll`, `pasteAsPlainText`,
+`undo`, `redo`
+
+## Keyboard editing actions
+In contrast, these keys perform editing on the text without sending anything to the app.
+Value                 | Meaning
+:-------------------- | :------
+`cursor_left`         | Moves the cursor to the left with the slider gesture.
+`cursor_right`        | Moves the cursor to the right with the slider gesture.
+`cursor_up`           | Moves the cursor up with the slider gesture. Warning: this might make the cursor leave the text box.
+`cursor_down`         | Moves the cursor down with the slider gesture. Warning: this might make the cursor leave the text box.
+`delete_word`         | Delete the word to the left of the cursor.
+`forward_delete_word` | Delete the word to the right of the cursor.
+
+The values with `cursor_` are new in v1.31.0. Previous custom layouts specified the slider with `slider="true"`, which should be removed.
+
+## Whitespace
+Value   | Meaning
+:------ | :------
+`space` | Space bar.
+`nbsp`  | Non-breaking space.
+`nnbsp` | Narrow non-breaking space.
+`zwj`   | Zero-width joiner.
+`zwnj`  | Zero-width non-joiner.
+
+## Other modifiers and diacritics
+Value                | Meaning
+:------------------- | :------
+`accent_aigu`        | Acute accent. `á`
+`accent_caron`       | Háček. `č`
+`accent_cedille`     | Cedilla. `ç`
+`accent_circonflexe` | Circumflex. `â`
+`accent_grave`       | Grave accent. `à`
+`accent_macron`      | Macron. `ā`
+`accent_ring`        | Ring accent. `å`
+`accent_tilde`       | Tilde. `ã`
+`accent_trema`       | Dieresis/umlaut. `ä`
+`accent_ogonek`      | Ogonek. `ą`
+`accent_dot_above`   | Dot accent. `ż` If applied to the lowercase `i`, removes the dot instead for Turkish. `ı`
+`accent_double_aigu` | Double acute accent. `ő`
+`accent_slash`       | Slash through. `ø`
+`accent_arrow_right` | Right arrow above, used to denote a vector. `a⃗`
+`accent_breve`       | Breve. `ă`
+`accent_bar`         | Bar/strikethrough. `ɨ`
+`accent_dot_below`   | Dot below. `ạ`
+`accent_horn`        | Horn accent. `ơ`
+`accent_hook_above`  | Hook accent. `ả`
+`accent_double_grave`  | Double grave accent. `ȁ`
+`accent_small_caps`  | Small capital letters. `ᴀ`
+`superscript`        | Superscript. `ᵃ`
+`subscript`          | Subscript. `ₐ`
+`ordinal`            | Turns `a` and `o` into `ª` and `º`.
+`arrows`             | Turns `1`-`4` and `6`-`9` into arrows.
+`box`                | Turns `1`-`9`, `0`, and `.` into single-line, thin box-drawing characters.
+
+## Bidirectional
+Value   | Meaning
+:------ | :------
+`lrm`   | Left-to-right mark.
+`rlm`   | Right-to-left mark.
+`b(`, `b)`, `b[`, `b]`, `b{`, `b}`, `blt`, `bgt` | Sends the bracket characters, but with mirrored key legends for right-to-left languages. (`blt` and `bgt` print `<` and `>` respectively.)
+
+## Arabic
+These are the diacritics for Arabic
+
+Value | Meaning
+:------ | :------
+`combining_fatha` | َ
+`combining_dammah` | ُ
+`combining_kasra` | ِ
+`combining_sukun` | ْ
+`combining_shaddah` | ّ
+`combining_hamza_above` | ٔ
+`combining_hamza_below` | ٕ
+
+
+## Hebrew
+Keys ending in `_placeholder` are normally hidden unless the Fn key is pressed.
+
+`qamats`, `patah`,
+`sheva`, `dagesh`,
+`hiriq`, `segol`,
+`tsere`, `holam`,
+`qubuts`, `hataf_patah`,
+`hataf_qamats`, `hataf_segol`,
+`shindot`, `shindot_placeholder`,
+`sindot`, `sindot_placeholder`,
+`geresh`, `gershayim`,
+`maqaf`, `rafe`,
+`ole`, `ole_placeholder`,
+`meteg`, `meteg_placeholder`
+
+## Keyboard behavior keys
+Value                  | Meaning
+:--------------------- | :------
+`config`               | Gear icon; opens Unexpected Keyboard settings.
+`switch_text`          | Switch to the text layer (main layer).
+`switch_numeric`       | Switch to the numeric layer.
+`switch_emoji`         | Switch to the emoji layer.
+`switch_back_emoji`    | Switch to the text layer from the emoji layer.
+`switch_forward`       | Change the keyboard layout, as long as Unexpected Keyboard has multiple keyboard layouts enabled in the settings.
+`switch_backward`      | Change the keyboard layout to the previous one in the list.
+`switch_greekmath`     | Switch to the Greek & Math Symbols layer.
+`switch_clipboard`     | Switch to the clipboard pane.
+`change_method`        | Open the input method picker dialog.
+`change_method_prev`   | Switch to the previously used input method.
+`action`               | Performs a special context-sensitive operation related to the Enter key. For example, in the Twitter (X) app, `enter` adds a new line, while `action` posts.
+`voice_typing`         | Begin voice typing.
+`voice_typing_chooser` | Shows a menu where you can choose which voice typing provider to use, then begins voice typing when you make a selection.
+`shareText`            | Emit a share Intent for the selected text. **Oddity:** This is in CamelCase.
+`hide_self`            | Hide the keyboard.
+
+## Suggestions
+
+Value           | Meaning
+:----           | :------
+`complete_first`  | Enter the best suggestion (the one in the middle)
+`complete_second` | Enter the second best suggestion (the right one)
+`complete_third`  | Enter the third best suggestion (the left one)
+`complete_emoji`  | Enter the emoji suggestion
+
+## Unused
+These keys are known to do nothing.
+
+`replaceText`, `textAssist`,
+`autofill`, `removed`
+
+## Placeholders
+These keys are normally hidden unless the Fn modifier is activated.
+
+`f11_placeholder` | `f12_placeholder`
@@ -0,0 +1,5 @@
+الميزة الرئيسة هي إمكانية كتابة المزيد من الأحرف عن طريق تمرير المفاتيح نحو الزوايا.
+
+صُمم هذا التطبيق في الأصل للمبرمجين الذين يستخدمون Termux.
+
+أصبح الآن مثاليًا للاستخدام اليومي.
@@ -0,0 +1 @@
+لوحة مفاتيح افتراضية خفيفة الوزن ومراعية للخصوصية لنظام أندرويد.
@@ -0,0 +1,6 @@
+La característica principal és que pots escriure més caràcters arrossegant les tecles cap a les cantonades.
+
+Aquesta aplicació va ser dissenyada originalment per als programadors que usen Termux.
+Ara és perfecta per a un ús quotidià.
+
+Aquesta aplicació no conté anuncis i és de codi obert.
@@ -0,0 +1 @@
+Un teclat virtual lleuger per a Android que és conscient de la teva privacitat.
@@ -0,0 +1,6 @@
+Hlavní funkcí je možnost psát více znaků posunutím kláves směrem k rohům.
+
+Tato aplikace byla původně navržena pro programátory používající Termux.
+Nyní je ideální pro každodenní použití.
+
+Tato aplikace neobsahuje žádné reklamy a je Open Source.
@@ -3,4 +3,4 @@ Diese Tastatur zeichnet sich dadurch aus, dass man zusätzliche Zeichen durch Wi
 Die Anwendung wurde ursprünglich für das Programmieren in Termux entwickelt.
 Mittlerweile ist sie auch für den täglichen Gebrauch perfekt geeignet.

-Diese App enthält keine Werbung, benötigt keinen Netzwerkzugriff und ist quelloffen.
+Diese App enthält keine Werbung und ist quelloffen.
@@ -0,0 +1,8 @@
+Improved custom layout option.
+Allow selecting voice typing app with a long press.
+The numpad can work with other numeral systems.
+New and updated layouts.
+New themes.
+Many small improvements.
+
+Thanks to the contributors: @pharook, @syskill, @ojas-bhagavath, @lrvideckis, @lyubomirv, @matthiakl, @deftkHD, @V6lhost, @RZHSSNZDH, @RetrogisusDEV, @rafasaurus, @krtsgnr7230, @eandersons, @ChasmSolacer, @Validbit, @polyctena
@@ -0,0 +1,7 @@
+The custom vibration setting is back.
+Allow to hide the keyboard switching key.
+Fixed modifier keys in some development apps.
+Updated translations.
+Bug fixes and general improvements.
+
+Many thanks to the contributors: @abb128, @marciozomb13, @RetrogisusDEV, @Sestowner, @vedamanavi, @krtsgnr7230
@@ -0,0 +1,6 @@
+New layouts: QWERTY (Slovak), Gujarati phonetic
+Add Linux Compose key to type a variety of characters using known combinations.
+Fixed localized numpad and number row.
+Many improvements and bug fixes.
+
+Huge thanks to the contributors: @Yogesh-B, @ChasmSolacer, @matthiakl, @Sestowner, @RyanGibb, @BogdanLata, @RetrogisusDEV, @V6lhost, @ErrrorMaxx, @sdrapha, @vedamanavi
@@ -0,0 +1,11 @@
+MessagEase and Thumb-Key inspired gestures with the anti-clockwise circle being
+completely configurable.
+
+Updated emojis.
+Improved Hangul (Korean) support.
+Added Danish support.
+Improved spacebar slider.
+Updated translations.
+Various improvements and fixes to the app and layouts.
+
+Many thanks to the contributors: @alotbsol555 @bkmgit @Cheesebaron @CloneWith @eandersons @JapanYoshi @Julow @la-ninpre @m15a @marciozomb13 @polyctena @solokot @Spike-from-NH @tmqCypher @Validbit
@@ -0,0 +1,8 @@
+Clipboard pane
+
+New Monet theme
+Improvements to custom layouts
+Options to disable key repeat and the circle gesture
+Options to disable the Tab and Esc keys
+
+Many thanks to the contributors: @alotbsol555 @ChasmSolacer @eandersons @polyctena @Sestowner @solokot @Spike-from-NH @TadaCZE @V6lhost @Validbit
@@ -0,0 +1,6 @@
+Fix crash on Android 6.
+Fix scaling issues for layouts with few columns.
+Added Serbian layouts.
+Layout and compose key tweaks. Improvements to custom layouts. Added Menu key.
+
+Many thanks to the contributors: @adrian4096 @asivery @bokidori @dingodoppelt @RZHSSNZDH
@@ -0,0 +1,14 @@
+New supported languages: Albanian, Belgian, Estonian, Georgian, Hawaiian,
+Irish, Kannada, Kazakh, Old Church Slavonic, Serbian, Tajiki, Tamil, Welsh
+
+Added WORKMAN (US) layout.
+Improved layouts for modern Hindi and Sanskrit, Greek, Kurdish, Persian, Czech.
+
+New compose sequences and added combining diacritic keys.
+New and improved themes.
+Many bug fixes and improvements.
+
+Many thanks to the contributors: @anaskaejdar @bokidori @cknight828 @cuhsy
+@Danger-Mkh @DocJr90 @IYO-OYI @kalankaboom @Kxeo @marciozomb13 @ms-jagadeeshan
+@npnpatidar @ptitgnu @quantenzitrone @Sestowner @solokot @Spike-from-NH
+@tenextractor
@@ -0,0 +1 @@
+Bug fixes
@@ -0,0 +1 @@
+Bug fixes
@@ -0,0 +1 @@
+Bug fixes
@@ -0,0 +1,8 @@
+Delete a word with a circle gesture on the delete key.
+Compose key can be unselected.
+Improved space bar slider and added selection mode.
+Lock shift with a circle gesture.
+Improvements to layouts.
+Various bug fixes and improvements to themes.
+
+Huge thanks to the contributors: @0skar2 @chuckwagoncomputing @dzaima @eandersons Lokesh Kumar @lrvideckis @ms-jagadeeshan @quantenzitrone @Sestowner @solokot @Spike-from-NH @srikanban @tenextractor
@@ -0,0 +1,9 @@
+Bug fixes
+
+Delete a word with a circle gesture on the delete key.
+Compose key can be unselected.
+Improved space bar slider and added selection mode.
+Lock shift with a circle gesture.
+Various bug fixes and improvements to themes and layouts.
+
+Many thanks to the contributors: @HaleyHalcyon @Jaoheah @Spike-from-NH
@@ -0,0 +1,6 @@
+Better support for foldable devices
+Added layouts
+Improved selection mode
+Bug fixes and many other improvements
+
+Huge thanks to the contributors: @alotbsol555, @bergentroll, @dacc9, @HaleyHalcyon, @Jaoheah, @jorexdeveloper, @malbajun, @matejdro, @Spike-from-NH, @tenextractor
@@ -0,0 +1 @@
+Bug fixes
@@ -0,0 +1,6 @@
+Spell checking and autocorrect are here !
+
+This releases comes with a very large number of improvements,
+support for more languages and new themes!
+
+Huge thanks to the contributors: @10Develops @anaskaejdar @andyca111100 @Autissima @bqv @cillyvms @domportera @dzaima @exzombie @Harry-Ais0 @Houfalafel @JeelsBoobz @JFronny @Julow @lan700ng @malbajun @matejdro @n-ce @skynetcat @sperareine @Spike-from-NH @xxcavemanxx
@@ -0,0 +1,6 @@
+Spell checking and autocorrect are here !
+
+This releases comes with a very large number of improvements,
+support for many languages and new themes!
+
+Huge thanks to the contributors: @10Develops @anaskaejdar @andyca111100 @Autissima @bqv @cillyvms @domportera @dzaima @exzombie @Harry-Ais0 @Houfalafel @JeelsBoobz @JFronny @Julow @lan700ng @malbajun @matejdro @n-ce @skynetcat @sperareine @Spike-from-NH @xxcavemanxx
@@ -0,0 +1,3 @@
+Bug fixes
+
+Huge thanks to the contributors: @alotbsol555 @FlippingBinary
@@ -0,0 +1,6 @@
+Spell checking and autocorrect are here !
+
+This releases comes with a very large number of improvements,
+support for many languages and new themes!
+
+Huge thanks to the contributors: @10Develops @alotbsol555 @anaskaejdar @andyca111100 @Autissima @bqv @cillyvms @domportera @dzaima @exzombie @FlippingBinary @Harry-Ais0 @Houfalafel @JeelsBoobz @JFronny @Julow @lan700ng @malbajun @matejdro @n-ce @skynetcat @sperareine @Spike-from-NH @xxcavemanxx
@@ -0,0 +1 @@
+Bug fixes
@@ -3,4 +3,4 @@ The main feature is that you can type more characters by swiping the keys toward
 This application was originally designed for programmers using Termux.
 Now perfect for everyday use.

-This application contains no ads, doesn't make any network requests and is Open Source.
+This application contains no ads and is Open Source.
@@ -0,0 +1 @@
+https://www.youtube.com/watch?v=rwGvWesPFX8
@@ -3,4 +3,4 @@ La característica principal es que hay acceso a más caractéres deslizando hac
 Esta aplicación fue originalmente diseñada para programadores que usaran Termux.
 Ahora es perfecta para uso cotidiano.

-La misma no contiene ningún anuncio/publicidad, no realiza peticiones de red y es de Fuente Abierta. 
+La misma no contiene ningún anuncio/publicidad y es de Fuente Abierta.
@@ -0,0 +1,6 @@
+Peamine omadus on see, et saad sisestada rohkem märke, viibates klahve nurkade suunas.
+
+See rakendus loodi algselt Termuxit kasutavatele programmeerijatele.
+Nüüd sobib see ideaalselt igapäevaseks kasutamiseks.
+
+Rakendus ei sisalda reklaame ja on avatud lähtekoodiga.
@@ -0,0 +1 @@
+Väike ja privaatsusteadlik klahvistik Androidile.
@@ -0,0 +1 @@
+Ootamatu klahvistik
@@ -0,0 +1,6 @@
+Ang pangunahing feature ay maaari kang mag-type ng mas marami pang karakter sa pag-swipe sa gilid ng mga key.
+
+Noong simula, ginawa itong application para sa mga programmer sa na nagte-Termux.
+Ngayo'y perpekto na sa pang-araw-araw.
+
+Walang ads at Open Source ang application na ito.
@@ -0,0 +1 @@
+Magaan at privacy-conscious na virtual keyboard sa Android.
@@ -3,4 +3,4 @@ La fonctionnalité principale est l'accès rapide à plus de caractères en bala
 Cette application a été conçue à l'origine pour les programmeurs utilisant Termux.
 Elle est maintenant parfaite pour une utilisation quotidienne.

-Cette application ne contient pas de publicité, n'accède pas au réseau et est Open Source.
+Cette application ne contient pas de publicité et est Open Source.
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				`srcs/juloo.keyboard2/ComposeKeyData.java -diff`
				`@@ -0,0 +1 @@`
				`لوحة مفاتيح افتراضية خفيفة الوزن ومراعية للخصوصية لنظام أندرويد.`
				`@@ -0,0 +1 @@`
				`Un teclat virtual lleuger per a Android que és conscient de la teva privacitat.`
				`@@ -0,0 +1 @@`
				`https://www.youtube.com/watch?v=rwGvWesPFX8`
				`@@ -0,0 +1 @@`
				`Väike ja privaatsusteadlik klahvistik Androidile.`
				`@@ -0,0 +1 @@`
				`Magaan at privacy-conscious na virtual keyboard sa Android.`