keymapperorg · sds100 · Nov 1, 2025 · Sep 8, 2025 · Sep 9, 2025 · Sep 9, 2025
diff --git a/.cursor/rules/create-action.mdc b/.cursor/rules/create-action.mdc
diff --git a/.cursor/rules/jetpack-compose.mdc b/.cursor/rules/jetpack-compose.mdc
diff --git a/.editorconfig b/.editorconfig
@@ -2,7 +2,10 @@
 ktlint_standard_function-expression-body = disabled
 ktlint_function_naming_ignore_when_annotated_with = Composable
 ktlint_ignore_back_ticked_identifier = true
-ktlint_code_style = intellij_idea # Use IntelliJ style because it has trailing commas
+ktlint_code_style = android_studio
+ij_kotlin_indent_before_arrow_on_new_line = true
+ij_kotlin_allow_trailing_comma = true
+ij_kotlin_allow_trailing_comma_on_call_site = true
 
 [base/src/main/java/io/github/sds100/keymapper/base/utils/ui/compose/icons/*.{kt,kts}]
 ktlint_standard_property-naming = disabled

diff --git a/.github/workflows/crowdin-actions.yml b/.github/workflows/crowdin-actions.yml
diff --git a/.github/workflows/testing.yml b/.github/workflows/testing.yml
@@ -135,4 +135,33 @@ jobs:
         if: github.event.repository.fork == false && failure()
         with:
           title: "Build apk"
-          webhook: ${{ secrets.DISCORD_BUILD_STATUS_WEBHOOK }}
+          webhook: ${{ secrets.DISCORD_BUILD_STATUS_WEBHOOK }}
+
+  synchronize-with-crowdin:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: crowdin action
+        uses: crowdin/github-action@v2
+        if: github.event.repository.fork == false
+        with:
+          upload_sources: true
+          upload_translations: false
+          download_translations: true
+          localization_branch_name: l10n/develop
+          create_pull_request: true
+          pull_request_title: 'New Crowdin Translations'
+          pull_request_body: 'New Crowdin translations by [Crowdin GH Action](https://github.com/crowdin/github-action)'
+          pull_request_base_branch_name: 'develop'
+        env:
+          # A classic GitHub Personal Access Token with the 'repo' scope selected (the user should have write access to the repository).
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+          # A numeric ID, found at https://crowdin.com/project/<projectName>/tools/api
+          CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
+
+          # Visit https://crowdin.com/settings#api-key to create this token
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,53 @@
+## [4.0.0 Beta 1](https://github.com/sds100/KeyMapper/releases/tag/v4.0.0-beta.01)
+
+#### TO BE RELEASED
+
+## Added
+
+- #761 Detect keys with scancodes. Key Mapper will do this automatically if the key code is unknown
+  or you record different physical keys from the same device with the same key code.
+- Redesign the Settings screen.
+- Shortcuts on the trigger screen that guide you how to set up different types of buttons.
+- #1788 dismiss lockscreen when launching app action from lockscreen
+- Show tips for parallel and sequence triggers, and constraints in the trigger screen
+- #397 enable/disable all key maps in a group
+- #1773 Option to show floating buttons on top of keyboard or notification panel.
+- #1335 Intent API to enable/disable/toggle a key map.
+- #114 action to force stop app, and an action to clear an app from recents
+- #727 Actions to send SMS messages: "Send SMS" and "Compose SMS"
+- #1819 Explain how to enable the accessibility service restricted setting
+- #661 Action to execute shell commands.
+- #991 Consolidated volume and stream actions.
+- #1066 Action to mute/unmute microphone.
+- #985 Constraints for foldable hinge being open/closed.
+
+## Removed
+
+- The key event relay service is now also used on all Android versions below Android 14. The
+  broadcast receiver method is no longer used.
+- Minimum supported Android version is now 8.0. Less than 1% of users are on older versions than
+  this and dropping support simplifies the codebase and maintenance.
+- Dropped support for showing a keyboard picker notification and automatically showing it when a
+  device connects. This is only supported on Android 8.1 and is extra work to maintain it.
+- Dropped support for rerouting key events on Android 11. This was a workaround for a specific bug
+  in Android 11 which fewer than 10% of users are using and less are probably using that feature.
+
+## Fixed
+
+- Restoring subgroups works and does not freeze Key Mapper.
+- Do not show duplicate constraint shortcuts.
+- Make WiFi connected constraints more reliable
+- #1818 auto switching of the Key Mapper keyboard when typing is more reliable and quicker on
+  Android 13+
+- #1818 auto switching of the Key Mapper keyboard now requires Android 11+. On older versions it was
+  only possible with WRITE_SECURE_SETTINGS but very few users are on these old Android versions so
+  it is not worth the extra maintenance effort.
+- #1818 the Key Mapper GUI Keyboard is no longer mentioned in the app. It still works but PRO mode
+  and the auto switching feature are the preferred way to work around the limitations of the Key
+  Mapper keyboard.
+- Allow selecting notification and alarm sound and not just ringtones for Sound action.
+- #1064 wait for switch keyboard action to complete before doing next action.
+
 ## [3.2.1](https://github.com/sds100/KeyMapper/releases/tag/v3.2.1)
 
 #### 03 Sept 2025
@@ -1332,26 +1382,26 @@ This summarises the changes since 2.0.2.
 - Dark mode! 🕶
 - A keymap can have multiple actions.
 - Triggers
-  - 2 modes. The keys can all be pressed at the same time or one after another in a sequence.
-  - Keys can be limited to a specific external device, any device or the device the app is
-    installed on.
-  - Double press support.
+    - 2 modes. The keys can all be pressed at the same time or one after another in a sequence.
+    - Keys can be limited to a specific external device, any device or the device the app is
+      installed on.
+    - Double press support.
 - Constraints. Keymaps can be restricted to only work in certain situations. Constraints can be
   mixed in OR mode or AND mode.
-  - App in foreground
-  - App not in foreground
-  - Bluetooth device connected
-  - Bluetooth device not connected
-  - Screen on/off (ROOT only).
+    - App in foreground
+    - App not in foreground
+    - Bluetooth device connected
+    - Bluetooth device not connected
+    - Screen on/off (ROOT only).
 
 - Actions
-  - Toggle/enable/disable a Do Not Disturb mode (Android 6.0+).
-  - Toggle/enable/disable airplane mode (ROOT only).
-  - Switch between vibrate and ring.
-  - Launch the device assistant rather than the voice assistant.
-  - Take screenshots on rooted devices older than Pie.
-  - Can now have unique repeat options and any action is allowed to be repeated now.
-  - Show the keycode number when picking a Keycode action.
+    - Toggle/enable/disable a Do Not Disturb mode (Android 6.0+).
+    - Toggle/enable/disable airplane mode (ROOT only).
+    - Switch between vibrate and ring.
+    - Launch the device assistant rather than the voice assistant.
+    - Take screenshots on rooted devices older than Pie.
+    - Can now have unique repeat options and any action is allowed to be repeated now.
+    - Show the keycode number when picking a Keycode action.
 
 - Renamed "Repeat Delay" to "Repeat Rate".
 - Renamed "Hold Down Delay" to "Repeat Delay"
@@ -1482,16 +1532,16 @@ Significantly improved the input latency.
 
 - A keymap can have multiple actions.
 - Triggers
-  - 2 modes. The keys can all be pressed at the same time or one after another in a sequence.
-  - Keys can be limited to a specific external device, any device or the device the app is
-    installed on.
-  - Double press support.
+    - 2 modes. The keys can all be pressed at the same time or one after another in a sequence.
+    - Keys can be limited to a specific external device, any device or the device the app is
+      installed on.
+    - Double press support.
 - Constraints. Keymaps can be restricted to only work in certain situations. Constraints can be
   mixed in OR mode or AND mode.
-  - App in foreground
-  - App not in foreground
-  - Bluetooth device connected
-  - Bluetooth device not connected
+    - App in foreground
+    - App not in foreground
+    - Bluetooth device connected
+    - Bluetooth device not connected
 - The option to show the "performing action" toast has been moved to a toggle in each keymap.
 - The long press delay, double press timeout, sequence trigger timeout, action repeat delay,
   hold-down delay until actions are repeated and vibrate delay can be changed per keymap.

diff --git a/CREDITS.md b/CREDITS.md
@@ -2,19 +2,33 @@
 
 Many thanks to...
 
- - @[dslul](https://github.com/dslul) for their [OpenBoard](https://github.com/dslul/openboard) fork of the AOSP keyboard! This made adding a GUI keyboard for Key Mapper _much_ easier. 🎉
- - @[salomonbrys] for his [Kotson] library so I can easily use Gson in Kotlin.
- - The [Material Design Icons] community for various icons that are not provided by Google.
- - [App Mockup] for their screenshot utility.
- - Airbnb for their [Epoxy](https://github.com/airbnb/epoxy) RecyclerView. They made having multiple itemview types and dragging and dropping super easy!
- - @[Jake Wharton](https://github.com/JakeWharton) for his [Timber](https://github.com/JakeWharton/timber) logging library.
- - @[srikanth-lingala](https://github.com/srikanth-lingala) for their Java zip file [library](https://github.com/srikanth-lingala/zip4j).
- - @[anggrayudi](https://github.com/anggrayudi) for their [Simple Storage](https://github.com/anggrayudi/SimpleStorage) library that makes working with Scoped Storage and the Storage Access Framework on Android much easier.
- - @[MFlisar](https://github.com/MFlisar) for their [drag and select](https://github.com/MFlisar/DragSelectRecyclerView) library.
- - @[RikkaApps](https://github.com/RikkaApps) for Shizuku! It is amazing.
- - @[canopas](https://github.com/canopas) for their Jetpack Compose Tap Target library https://github.com/canopas/compose-intro-showcase.
+- @[dslul](https://github.com/dslul) for their [OpenBoard](https://github.com/dslul/openboard) fork
+  of the AOSP keyboard! This made adding a GUI keyboard for Key Mapper _much_ easier. 🎉
+- @[salomonbrys] for his [Kotson] library so I can easily use Gson in Kotlin.
+- The [Material Design Icons] community for various icons that are not provided by Google.
+- [App Mockup] for their screenshot utility.
+- Airbnb for their [Epoxy](https://github.com/airbnb/epoxy) RecyclerView. They made having multiple
+  itemview types and dragging and dropping super easy!
+- @[Jake Wharton](https://github.com/JakeWharton) for
+  his [Timber](https://github.com/JakeWharton/timber) logging library.
+- @[srikanth-lingala](https://github.com/srikanth-lingala) for their Java zip
+  file [library](https://github.com/srikanth-lingala/zip4j).
+- @[anggrayudi](https://github.com/anggrayudi) for
+  their [Simple Storage](https://github.com/anggrayudi/SimpleStorage) library that makes working
+  with Scoped Storage and the Storage Access Framework on Android much easier.
+- @[MFlisar](https://github.com/MFlisar) for
+  their [drag and select](https://github.com/MFlisar/DragSelectRecyclerView) library.
+- @[RikkaApps](https://github.com/RikkaApps) for Shizuku! It is amazing and was used as the base for
+  PRO mode (system bridge).
+- @[canopas](https://github.com/canopas) for their Jetpack Compose Tap Target
+  library https://github.com/canopas/compose-intro-showcase.
+- @[topjohnwu](https://github.com/topjohnwu) for Magisk
+  and [libsu](https://github.com/topjohnwu/libsu).
 
 [salomonbrys]: https://github.com/salomonbrys
+
 [Kotson]: https://github.com/salomonbrys/Kotson
+
 [Material Design Icons]: https://materialdesignicons.com/
+
 [App Mockup]: https://app-mockup.com/
diff --git a/api/src/main/AndroidManifest.xml b/api/src/main/AndroidManifest.xml
@@ -36,6 +36,16 @@
             </intent-filter>
         </receiver>
 
+        <receiver
+            android:name=".EnableKeyMapsBroadcastReceiver"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="io.github.sds100.keymapper.ACTION_ENABLE_KEY_MAP" />
+                <action android:name="io.github.sds100.keymapper.ACTION_DISABLE_KEY_MAP" />
+                <action android:name="io.github.sds100.keymapper.ACTION_TOGGLE_KEY_MAP" />
+            </intent-filter>
+        </receiver>
+
         <!-- Don't require a permission because we want other apps to bind
          to this service. The permission wouldn't be signature-level so
          if a nefarious app wants to talk to Key Mapper they could add the permission anyway. -->

diff --git a/api/src/main/java/io/github/sds100/keymapper/api/Api.kt b/api/src/main/java/io/github/sds100/keymapper/api/Api.kt
@@ -4,9 +4,13 @@ object Api {
     // Do not use the package name for debug/ci builds
     const val ACTION_TRIGGER_KEYMAP_BY_UID =
         "io.github.sds100.keymapper.ACTION_TRIGGER_KEYMAP_BY_UID"
-    const val EXTRA_KEYMAP_UID = "io.github.sds100.keymapper.EXTRA_KEYMAP_UID"
+    const val EXTRA_KEYMAP_ID = "io.github.sds100.keymapper.EXTRA_KEYMAP_UID"
 
     const val ACTION_PAUSE_MAPPINGS = "io.github.sds100.keymapper.ACTION_PAUSE_MAPPINGS"
     const val ACTION_RESUME_MAPPINGS = "io.github.sds100.keymapper.ACTION_RESUME_MAPPINGS"
     const val ACTION_TOGGLE_MAPPINGS = "io.github.sds100.keymapper.ACTION_TOGGLE_MAPPINGS"
+
+    const val ACTION_ENABLE_KEY_MAP = "io.github.sds100.keymapper.ACTION_ENABLE_KEY_MAP"
+    const val ACTION_DISABLE_KEY_MAP = "io.github.sds100.keymapper.ACTION_DISABLE_KEY_MAP"
+    const val ACTION_TOGGLE_KEY_MAP = "io.github.sds100.keymapper.ACTION_TOGGLE_KEY_MAP"
 }