Version 4.1.0

.cursor/rules/keymapper-add-action-checklist.mdc

@@ -0,0 +1,24 @@
+---
+description: Required checklist when adding a new Action
+alwaysApply: true
+---
+
+# Adding A New Action
+
+Before implementing, confirm whether the action is editable.
+- Branch names must follow `feature/123-branch-name` or `fix/123-branch-name`.
+
+Then follow this sequence:
+
+1. Add an ID in `ActionId`.
+2. Add a new `ActionData` sealed class variant.
+3. Map entity conversions in `ActionDataEntityMapper`.
+4. Assign category in `ActionUtils`.
+5. If editable, add it to `ActionUtils.isEditable`.
+6. Add title string in `strings.xml`.
+7. Add title and Compose icon in `ActionUtils` (ignore drawables).
+8. Add title in `ActionUiHelper`.
+9. Add execution handling in `PerformActionsUseCase`.
+10. Handle creation in `CreateActionDelegate`.
+
+Do not delete existing action code; follow existing names and place additions near similar actions.

.cursor/rules/keymapper-architecture.mdc

@@ -0,0 +1,15 @@
+---
+description: Module boundaries and architectural conventions for KeyMapper
+alwaysApply: true
+---
+
+# KeyMapper Architecture
+
+- Branch names must follow `feature/123-branch-name` or `fix/123-branch-name`.
+- Treat the codebase as Clean Architecture + MVVM with unidirectional data flow.
+- Keep dependency direction as `:app` -> `:base` -> `:common`/`:data`/`:system`/`:sysbridge`.
+- Keep domain models in `:common` and persistence entities in `:data` with explicit mappers.
+- Put business logic in use cases and inject them into ViewModels.
+- Expose UI state via `Flow`/`StateFlow`; collect from UI and send events back to ViewModels.
+- Use Hilt for DI and preserve app-specific binding overrides in app modules.
+- Use coroutines for async work and `viewModelScope` for ViewModel-owned jobs.

.cursor/rules/keymapper-build-and-tooling.mdc

@@ -0,0 +1,16 @@
+---
+description: Build, test, and tooling commands for KeyMapper
+alwaysApply: true
+---
+
+# KeyMapper Build And Tooling
+
+- Branch names must follow `feature/123-branch-name` or `fix/123-branch-name`.
+- Use these common commands:
+  - `./gradlew assembleDebug`
+  - `./gradlew test`
+  - `./gradlew connectedAndroidTest`
+  - `./gradlew ktlintCheck` or `./gradlew ktlintFormat`
+- Release builds require `KEYSTORE_PASSWORD` and `KEY_PASSWORD` environment variables.
+- Target platform constraints: min SDK 26, target SDK 36, Java 11.
+- Dependency versions are managed in `gradle/libs.versions.toml`.

.cursor/rules/keymapper-commit-messages.mdc

@@ -0,0 +1,34 @@
+---
+description: Commit message format convention for KeyMapper
+alwaysApply: true
+---
+
+# KeyMapper Commit Messages
+
+Use this format for commits:
+
+`#<issue_number> <type>: <description>`
+
+Allowed types:
+
+- `feat`
+- `fix`
+- `chore`
+- `refactor`
+- `style`
+
+Example:
+
+`#2025 feat: add button to report bug on home screen`
+
+# Branch Naming Convention
+
+- Use `feature/123-branch-name` for new features.
+- Use `fix/123-branch-name` for bug fixes.
+
+# Pull Request Changelog Requirement
+
+- When preparing a PR, update `CHANGELOG.md` for any user-facing fix/feature/change or notable
+  internal change.
+- If no changelog entry is needed (for example, docs-only or CI-only), explicitly note that in the PR
+  description.

.cursor/rules/keymapper-compose-guidelines.mdc

@@ -0,0 +1,16 @@
+---
+description: Compose coding conventions used in KeyMapper
+globs: "**/*.kt"
+alwaysApply: false
+---
+
+# KeyMapper Compose Guidelines
+
+Apply this when editing Compose code:
+
+- Branch names must follow `feature/123-branch-name` or `fix/123-branch-name`.
+- Put `Modifier` as the first optional parameter after required parameters.
+- For non-standard colors, use `LocalCustomColorsPalette` instead of `MaterialTheme.colorScheme`.
+- Check `KeyMapperIcons` before introducing icons from other sources.
+- Use `LocalUriHandler.openUriSafe` for URL launching and do not hoist URL launching logic.
+- Prefer imports; avoid fully qualified names in Compose call sites.

CHANGELOG.md

@@ -1,3 +1,22 @@
+## [4.1.0](https://github.com/sds100/KeyMapper/releases/tag/v4.1.0)
+
+#### 05 May 2026
+
+## Added
+
+- #2067 add action to select all text in the focused field.
+- #2045 add action to input on-screen keyboard enter/send button.
+- #2106 disable the keyboard auto-switching setting when manually switching the keyboard in the Key Mapper homescreen menu.
+- #1029 add action to show a toast message.
+- #2081 add getevent debug screen.
+- #2087 small segmented button text is not readable in dark mode.
+- #2077 rename "This device" and "any device" to "This Android device" and "Any input device" to prevent confusion.
+
+## Fixed
+
+- #2091 show an error on the "open device assistant" action when no device assistant is installed.
+- #2107 clarify the crashed accessibility service dialog text and keep only Cancel/Restart actions.
+
 ## [4.0.5](https://github.com/sds100/KeyMapper/releases/tag/v4.0.5)
 
 #### 26 February 2026

CLAUDE.md

@@ -0,0 +1,109 @@
+# KeyMapper
+
+## Project Overview
+
+Android app for custom key/gamepad remapping, macros, and on-screen buttons. Supports Android 8.0+ (minSdk 26), targets API 36. Distributed on Google Play and F-Droid (FOSS flavor).
+
+- **Package:** `io.github.sds100.keymapper`
+- **Languages:** Kotlin (primary), Rust (event device handling), C++ (system bridge JNI)
+
+## Build Commands
+
+```bash
+./gradlew assembleDebug       # debug APK
+./gradlew assembleCi          # CI build (minified)
+./gradlew assembleRelease     # release build (requires KEYSTORE_PASSWORD and KEY_PASSWORD env vars)
+./gradlew clean               # clean build outputs
+```
+
+## Test & Lint Commands
+
+```bash
+# Kotlin unit tests
+./gradlew testDebugUnitTest
+./gradlew :base:testDebugUnitTest   # single module
+
+# Kotlin lint
+./gradlew ktlintCheck         # check
+./gradlew ktlintFormat        # auto-fix
+
+# Rust (run from evdev/src/main/rust/evdev_manager)
+cargo fmt --check
+cargo test --package evdev_manager_core
+```
+
+CI runs all of the above on every PR (see `.github/workflows/pull-request.yml`).
+
+## Architecture & Modules
+
+Multi-module Gradle project using MVVM, Hilt DI, Room, StateFlow/Flow, Jetpack Compose, and Coroutines.
+
+| Module | Responsibility |
+|---|---|
+| `app/` | Entry point: `MainActivity`, `KeyMapperApp`, `MyAccessibilityService` |
+| `base/` | UI screens and ViewModels (actions, constraints, triggers, keymaps, settings) |
+| `common/` | Shared utilities and models |
+| `data/` | Room database, repositories, DataStore, migrations |
+| `system/` | Device APIs, permission management |
+| `sysbridge/` | C++ JNI via CMake for elevated system access |
+| `evdev/` | Rust event device handling + JNI bindings |
+| `api/` | AIDL public interface definitions |
+| `systemstubs/` | Mock stubs for system classes used in tests |
+
+Most business logic lives in `base/src/main/java/io/github/sds100/keymapper/`.
+
+## Code Style
+
+- **Kotlin:** ktlint with android_studio code style (configured via `.editorconfig`)
+  - No function expression bodies
+  - Trailing commas allowed
+  - Run `./gradlew ktlintFormat` before committing
+- **Rust:** `cargo fmt`
+
+## Commit Message Convention
+
+```
+#<issue_number> <type>: <description>
+```
+
+Types: `feat`, `fix`, `chore`, `refactor`, `style`
+
+Example: `#2025 feat: add button to report bug on home screen`
+
+## Branch Naming Convention
+
+- Use `feature/123-branch-name` for new features.
+- Use `fix/123-branch-name` for bug fixes.
+
+## Pull Request Requirement
+
+- Any user-facing behavior change, fix, feature, or notable internal change in a PR must include an
+  update to `CHANGELOG.md`.
+- If there is truly no changelog impact (for example, docs-only or CI-only changes), explicitly state
+  that in the PR description.
+
+## Compose Guidelines
+
+- `Modifier` is always the first parameter after required params
+- Use `LocalCustomColorsPalette` (not `MaterialTheme.colorScheme`) for non-standard colors
+- Check `KeyMapperIcons` before using other icon sources
+- Use `LocalUriHandler.openUriSafe` extension for URL launching — do not hoist URL launching logic up the call stack
+- Use import statements; never use fully qualified names in Compose code
+- Write `@Preview` composables for every screen
+
+## Adding a New Action (10-step checklist)
+
+First determine whether the action is editable. Then:
+
+1. Add a new ID to `ActionId`
+2. Create a new `ActionData` sealed class variant
+3. Map to/from entity in `ActionDataEntityMapper`
+4. Assign a category in `ActionUtils`
+5. If editable, add to `isEditable` in `ActionUtils`
+6. Add a title string in `strings.xml`
+7. Add title and Compose icon in `ActionUtils` (ignore drawables)
+8. Add title in `ActionUiHelper`
+9. Stub out execution in `PerformActionsUseCase`
+10. Handle creation in `CreateActionDelegate`
+
+Do not delete existing action code. Follow existing naming conventions exactly. Add new code near similar existing actions.

app/version.properties

@@ -1,2 +1,2 @@
-VERSION_NAME=4.0.5
-VERSION_CODE=247
+VERSION_NAME=4.1.0
+VERSION_CODE=248

base/src/main/java/io/github/sds100/keymapper/base/BaseMainNavHost.kt

@@ -25,6 +25,7 @@ import io.github.sds100.keymapper.base.actions.uielement.InteractUiElementScreen
 import io.github.sds100.keymapper.base.actions.uielement.InteractUiElementViewModel
 import io.github.sds100.keymapper.base.constraints.ChooseConstraintScreen
 import io.github.sds100.keymapper.base.constraints.ChooseConstraintViewModel
+import io.github.sds100.keymapper.base.debug.GetEventScreen
 import io.github.sds100.keymapper.base.expertmode.ExpertModeScreen
 import io.github.sds100.keymapper.base.expertmode.ExpertModeSetupScreen
 import io.github.sds100.keymapper.base.logging.LogScreen
@@ -165,6 +166,14 @@ fun BaseMainNavHost(
             )
         }
 
+        composable<NavDestination.GetEvent> {
+            GetEventScreen(
+                modifier = Modifier.fillMaxSize(),
+                viewModel = hiltViewModel(),
+                onBackClick = { navController.popBackStack() },
+            )
+        }
+
         composable<NavDestination.ChooseSetting> {
             ChooseSettingScreen(
                 modifier = Modifier.fillMaxSize(),

base/src/main/java/io/github/sds100/keymapper/base/BaseViewModelHiltModule.kt

@@ -25,6 +25,8 @@ import io.github.sds100.keymapper.base.constraints.ConfigConstraintsUseCaseImpl
 import io.github.sds100.keymapper.base.constraints.CreateConstraintUseCase
 import io.github.sds100.keymapper.base.constraints.CreateConstraintUseCaseImpl
 import io.github.sds100.keymapper.base.constraints.DisplayConstraintUseCase
+import io.github.sds100.keymapper.base.debug.GetEventOutputUseCase
+import io.github.sds100.keymapper.base.debug.GetEventOutputUseCaseImpl
 import io.github.sds100.keymapper.base.expertmode.ExpertModeSetupDelegateImpl
 import io.github.sds100.keymapper.base.expertmode.SystemBridgeSetupDelegate
 import io.github.sds100.keymapper.base.expertmode.SystemBridgeSetupUseCase
@@ -185,6 +187,10 @@ abstract class BaseViewModelHiltModule {
     @ViewModelScoped
     abstract fun bindShareLogcatUseCase(impl: ShareLogcatUseCaseImpl): ShareLogcatUseCase
 
+    @Binds
+    @ViewModelScoped
+    abstract fun bindGetEventOutputUseCase(impl: GetEventOutputUseCaseImpl): GetEventOutputUseCase
+
     @Binds
     @ViewModelScoped
     abstract fun bindOnboardingTipDelegate(impl: OnboardingTipDelegateImpl): OnboardingTipDelegate

base/src/main/java/io/github/sds100/keymapper/base/actions/ActionData.kt

@@ -833,6 +833,11 @@ sealed class ActionData : Comparable<ActionData> {
         override val id = ActionId.SHOW_KEYBOARD_PICKER
     }
 
+    @Serializable
+    data object PerformImeAction : ActionData() {
+        override val id = ActionId.PERFORM_IME_ACTION
+    }
+
     @Serializable
     data object CopyText : ActionData() {
         override val id = ActionId.TEXT_COPY
@@ -853,6 +858,11 @@ sealed class ActionData : Comparable<ActionData> {
         override val id = ActionId.SELECT_WORD_AT_CURSOR
     }
 
+    @Serializable
+    data object SelectAllText : ActionData() {
+        override val id = ActionId.SELECT_ALL_TEXT
+    }
+
     @Serializable
     data object VoiceAssistant : ActionData() {
         override val id = ActionId.OPEN_VOICE_ASSISTANT
@@ -919,6 +929,22 @@ sealed class ActionData : Comparable<ActionData> {
         }
     }
 
+    @Serializable
+    data class Toast(val message: String, val duration: Duration) : ActionData() {
+        override val id: ActionId = ActionId.TOAST
+
+        @Serializable
+        enum class Duration {
+            SHORT,
+            LONG,
+        }
+
+        override fun compareTo(other: ActionData) = when (other) {
+            is Toast -> compareValuesBy(this, other, { it.message }, { it.duration })
+            else -> super.compareTo(other)
+        }
+    }
+
     @Serializable
     data object AnswerCall : ActionData() {
         override val id: ActionId = ActionId.ANSWER_PHONE_CALL