Develop 4.5

.github/workflows/pull-request.yml

@@ -102,14 +102,14 @@ jobs:
             ${{ runner.os }}-gradle-
 
       - name: set up JDK 21
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: 'oracle'
           java-version: 21
           cache: 'gradle'
 
       - name: Setup Android SDK
-        uses: android-actions/setup-android@v2
+        uses: android-actions/setup-android@v4
         with:
           ndk-version: "27.2.12479018"
 

.github/workflows/testing.yml

@@ -114,14 +114,14 @@ jobs:
           value: ${{ github.run_number }}
 
       - name: set up JDK 21
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: 'oracle'
           java-version: 21
           cache: 'gradle'
 
       - name: Setup Android SDK
-        uses: android-actions/setup-android@v2
+        uses: android-actions/setup-android@v4
         with:
           ndk-version: "27.2.12479018"
 

.gitignore

@@ -97,4 +97,5 @@ app/.env
 
 evdev/build
 evdev/.cxx
-evdev/src/main/rust/*/target
+evdev/src/main/rust/*/target
+.kotlin/*

CHANGELOG.md

@@ -1,11 +1,40 @@
-## [4.4.1](https://github.com/sds100/KeyMapper/releases/tag/v4.4.1)
+## [4.5.0](https://github.com/sds100/KeyMapper/releases/tag/v4.5.0)
 
 #### TO BE RELEASED
 
 ## Added
 
+- #1341 new constraint for when a notification from a specific app, or with a specific title or text, is posted.
+- #1501 new action to cycle through your enabled keyboards.
+- #2250 redesigned the key map options screen with in-app guides for triggering and enabling/disabling a key map by intent.
+- #701 new action options bottom sheet design.
+- #701 you can now give custom names to actions, to make it easier to identify key maps.
+- #701 redesigned the action list with expandable action cards that show each option and error.
+- #1465 actions can be turned off individually without deleting them.
+- #1479 you can now duplicate an action from the action list.
+- #701 the delay before the next action is now set with a button between actions instead of in the action options.
+- Redesigned the action options with grouped repeat, burst, hold down and delay sections.
+- #752 Constraints can be organised into groups that each have their own AND/OR mode, and the groups are combined with AND or OR.
+- #752 Constraint groups can be given a custom name.
+- #752 Any constraint can be inverted.
+- #752 Redesigned the constraints screen with expandable constraint group cards.
+- #2139 color code disabled/enabled groups.
+- #1987 groups are red if any key maps inside have errors.
+- #2246 adjusted the trigger screen design to match the action and constraint screens.
+- #2249 make key maps more compact in the home screen.
+- #2259 all key maps can now be triggered by intent or shortcut without needing to enable it first.
+- #982 new action to vibrate the device with a custom duration or a predefined haptic effect (Click, Double Click, Heavy Click, Tick).
+- #982 the "vibrate on trigger" key map option can now also be customised with a predefined haptic effect instead of just a duration, via a new settings button next to the Vibrate option.
 - #2243 Redesigned What's New dialog.
 
+## Fixed
+
+- Do not crash if permission not granted for in phone call constraint and trying to perform key map.
+- #2258 remember saved position in key map list when changing them. Do not flash with loading indicator briefly as well.
+- #2167 do not show errors for app not in foreground constraint when the app is uninstalled/disabled.
+- #2262 request local network access permission for HTTP request action on Android 17+.
+- #2261 show the app's saved name instead of a generic label or raw package name for app-related constraints and actions when the app has been uninstalled.
+
 ## [4.4.0](https://github.com/sds100/KeyMapper/releases/tag/v4.4.0)
 
 #### 12 September 2026

CLAUDE.md

@@ -24,8 +24,9 @@ Android app for custom key/gamepad remapping, macros, and on-screen buttons. Sup
 ./gradlew :base:testDebugUnitTest   # single module
 
 # Kotlin lint
-./gradlew ktlintCheck         # check
-./gradlew ktlintFormat        # auto-fix
+# First run format before doing check
+./gradlew ktlintFormat
+./gradlew ktlintCheck
 
 # Rust (run from evdev/src/main/rust/evdev_manager)
 cargo fmt --check

app/src/main/java/io/github/sds100/keymapper/trigger/ConfigTriggerViewModel.kt

@@ -16,6 +16,7 @@ import io.github.sds100.keymapper.base.trigger.TriggerSetupShortcut
 import io.github.sds100.keymapper.base.utils.navigation.NavigationProvider
 import io.github.sds100.keymapper.base.utils.ui.DialogProvider
 import io.github.sds100.keymapper.base.utils.ui.ResourceProvider
+import io.github.sds100.keymapper.base.vibration.VibrateConfigDelegate
 import io.github.sds100.keymapper.sysbridge.manager.SystemBridgeConnectionManager
 import javax.inject.Inject
 import kotlinx.coroutines.launch
@@ -32,6 +33,7 @@ class ConfigTriggerViewModel @Inject constructor(
     setupAccessibilityServiceDelegate: SetupAccessibilityServiceDelegate,
     onboardingTipDelegate: OnboardingTipDelegate,
     triggerSetupDelegate: TriggerSetupDelegate,
+    vibrateConfigDelegate: VibrateConfigDelegate,
     resourceProvider: ResourceProvider,
     navigationProvider: NavigationProvider,
     dialogProvider: DialogProvider,
@@ -46,6 +48,7 @@ class ConfigTriggerViewModel @Inject constructor(
     systemBridgeConnectionManager = systemBridgeConnectionManager,
     onboardingTipDelegate = onboardingTipDelegate,
     triggerSetupDelegate = triggerSetupDelegate,
+    vibrateConfigDelegate = vibrateConfigDelegate,
     resourceProvider = resourceProvider,
     navigationProvider = navigationProvider,
     dialogProvider = dialogProvider,

app/version.properties

@@ -1,2 +1,2 @@
-VERSION_NAME=4.4.1
-VERSION_CODE=265
+VERSION_NAME=4.5.0
+VERSION_CODE=269

base/build.gradle.kts

@@ -161,7 +161,6 @@ dependencies {
     testImplementation(libs.junit.params)
     testImplementation(libs.mockito.kotlin)
     testImplementation(libs.mockito.core)
-    testImplementation(libs.mockito.inline)
     testDebugImplementation(libs.androidx.fragment.testing)
 
     // Dependencies for Android instrumented tests

base/src/main/assets/whats-new-app.txt

@@ -1,8 +1,7 @@
-+ Cycle keyboard language action | Switch between your keyboard's languages with a key press
-+ Sort key maps by enabled/disabled
-+ Custom seek amount for media step actions
-+ Export/import key maps on Android TV
-+ "Reduce app killing" tips for Xiaomi/Redmi/Poco devices
-* Screen tap/swipe/pinch actions now scale to display resolution
-- Fix some crashes when auto starting Expert Mode
-- Many other bug fixes and improvements
+! Group constraints | Organize constraints into groups with their own AND/OR logic
+! Vibrate action | New action with custom duration or haptic effects like Click and Tick
++ • Cycle enabled keyboards action
++ • Notification constraint
+* • Turn off, duplicate and rename actions
+* • Redesigned action, constraint and trigger screens
+- • Many other bug fixes and improvements

base/src/main/assets/whats-new.txt

@@ -1,11 +1,8 @@
-• "Reduce app killing" tips for Xiaomi/Redmi/Poco devices
-• Sort key maps by enabled/disabled
-• Cycle keyboard language action
-• Custom seek amount for media step actions
-• Export/import key maps on Android TV
-• Fix some crashes when auto starting Expert Mode
-• Fix shell commands failing with Windows line endings
-• Screen tap/swipe/pinch actions now scale to display resolution
+• Group constraints with their own AND/OR logic
+• New vibrate action with custom duration or haptic effects
+• Cycle enabled keyboards action
+• Notification constraint
+• Turn off, duplicate and rename actions
 • Many other bug fixes and improvements
 
 📖 View the complete changelog at: http://keymapper.app/changelog

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

@@ -16,6 +16,7 @@ import androidx.navigation.NavGraphBuilder
 import androidx.navigation.NavHostController
 import androidx.navigation.compose.NavHost
 import androidx.navigation.compose.composable
+import androidx.navigation.toRoute
 import io.github.sds100.keymapper.base.actions.ChooseActionScreen
 import io.github.sds100.keymapper.base.actions.ChooseActionViewModel
 import io.github.sds100.keymapper.base.actions.ChooseSettingScreen
@@ -25,10 +26,14 @@ 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.constraints.ConfigNotificationConstraintScreen
+import io.github.sds100.keymapper.base.constraints.ConfigNotificationConstraintViewModel
 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.expertmode.xiaomi.XiaomiOptimizationScreen
+import io.github.sds100.keymapper.base.keymaps.EnableByIntentScreen
+import io.github.sds100.keymapper.base.keymaps.TriggerByIntentScreen
 import io.github.sds100.keymapper.base.logging.LogScreen
 import io.github.sds100.keymapper.base.onboarding.HandleAccessibilityServiceDialogs
 import io.github.sds100.keymapper.base.onboarding.SetupAccessibilityServiceDelegateImpl
@@ -101,6 +106,15 @@ fun BaseMainNavHost(
             )
         }
 
+        composable<NavDestination.ConfigNotificationConstraint> {
+            val viewModel: ConfigNotificationConstraintViewModel = hiltViewModel()
+
+            ConfigNotificationConstraintScreen(
+                modifier = Modifier.fillMaxSize(),
+                viewModel = viewModel,
+            )
+        }
+
         composable<NavDestination.ChooseAction> {
             val viewModel: ChooseActionViewModel = hiltViewModel()
 
@@ -189,6 +203,26 @@ fun BaseMainNavHost(
             )
         }
 
+        composable<NavDestination.TriggerByIntent> { backStackEntry ->
+            val destination = backStackEntry.toRoute<NavDestination.TriggerByIntent>()
+
+            TriggerByIntentScreen(
+                modifier = Modifier.fillMaxSize(),
+                keyMapUid = destination.keyMapUid,
+                onBackClick = { navController.popBackStack() },
+            )
+        }
+
+        composable<NavDestination.EnableByIntent> { backStackEntry ->
+            val destination = backStackEntry.toRoute<NavDestination.EnableByIntent>()
+
+            EnableByIntentScreen(
+                modifier = Modifier.fillMaxSize(),
+                keyMapUid = destination.keyMapUid,
+                onBackClick = { navController.popBackStack() },
+            )
+        }
+
         composableDestinations()
     }
 }

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

@@ -45,7 +45,6 @@ import io.github.sds100.keymapper.base.system.inputmethod.SwitchImeAsyncImpl
 import io.github.sds100.keymapper.base.system.inputmethod.SwitchImeInterface
 import io.github.sds100.keymapper.base.system.inputmethod.ToggleCompatibleImeUseCase
 import io.github.sds100.keymapper.base.system.inputmethod.ToggleCompatibleImeUseCaseImpl
-import io.github.sds100.keymapper.base.system.notifications.AndroidNotificationAdapter
 import io.github.sds100.keymapper.base.system.notifications.ManageNotificationsUseCase
 import io.github.sds100.keymapper.base.system.notifications.ManageNotificationsUseCaseImpl
 import io.github.sds100.keymapper.base.trigger.RecordTriggerController
@@ -63,16 +62,11 @@ import io.github.sds100.keymapper.common.utils.UuidGenerator
 import io.github.sds100.keymapper.system.accessibility.AccessibilityServiceAdapter
 import io.github.sds100.keymapper.system.inputmethod.KeyEventRelayServiceWrapper
 import io.github.sds100.keymapper.system.inputmethod.KeyEventRelayServiceWrapperImpl
-import io.github.sds100.keymapper.system.notifications.NotificationAdapter
 import javax.inject.Singleton
 
 @Module
 @InstallIn(SingletonComponent::class)
 abstract class BaseSingletonHiltModule {
-    @Singleton
-    @Binds
-    abstract fun provideNotificationAdapter(impl: AndroidNotificationAdapter): NotificationAdapter
-
     @Singleton
     @Binds
     abstract fun provideAccessibilityAdapter(

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

@@ -61,6 +61,8 @@ import io.github.sds100.keymapper.base.trigger.SetupInputMethodUseCase
 import io.github.sds100.keymapper.base.trigger.SetupInputMethodUseCaseImpl
 import io.github.sds100.keymapper.base.trigger.TriggerSetupDelegate
 import io.github.sds100.keymapper.base.trigger.TriggerSetupDelegateImpl
+import io.github.sds100.keymapper.base.vibration.VibrateConfigDelegate
+import io.github.sds100.keymapper.base.vibration.VibrateConfigDelegateImpl
 
 @Module
 @InstallIn(ViewModelComponent::class)
@@ -197,6 +199,10 @@ abstract class BaseViewModelHiltModule {
         impl: FixKeyEventActionDelegateImpl,
     ): FixKeyEventActionDelegate
 
+    @Binds
+    @ViewModelScoped
+    abstract fun bindVibrateConfigDelegate(impl: VibrateConfigDelegateImpl): VibrateConfigDelegate
+
     @Binds
     @ViewModelScoped
     abstract fun bindExpertModeSetupDelegate(

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

@@ -0,0 +1,10 @@
+package io.github.sds100.keymapper.base
+
+object IntentApi {
+    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 TRIGGER_RECEIVER_CLASS =
+        "io.github.sds100.keymapper.api.TriggerKeyMapsBroadcastReceiver"
+}

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

@@ -29,6 +29,16 @@ data class Action(
 
     val multiplier: Int? = null,
     val delayBeforeNextAction: Int? = null,
+
+    /**
+     * A name set by the user that is shown instead of the generated title.
+     */
+    val customName: String? = null,
+
+    /**
+     * Disabled actions are not performed when the key map is triggered.
+     */
+    val isEnabled: Boolean = true,
 )
 
 object ActionEntityMapper {
@@ -85,6 +95,11 @@ object ActionEntityMapper {
             .valueOrNull()
             ?.toIntOrNull()
 
+        val customName = entity.extras
+            .getData(ActionEntity.EXTRA_CUSTOM_NAME)
+            .valueOrNull()
+            ?.takeIf { it.isNotBlank() }
+
         return Action(
             uid = entity.uid,
             data = data,
@@ -98,6 +113,8 @@ object ActionEntityMapper {
             holdDownDuration = holdDownDuration,
             delayBeforeNextAction = delayBeforeNextAction,
             multiplier = multiplier,
+            customName = customName,
+            isEnabled = !entity.flags.hasFlag(ActionEntity.ACTION_FLAG_DISABLED),
         )
     }
 
@@ -118,6 +135,10 @@ object ActionEntityMapper {
                 add(EntityExtra(ActionEntity.EXTRA_MULTIPLIER, action.multiplier.toString()))
             }
 
+            if (!action.customName.isNullOrBlank()) {
+                add(EntityExtra(ActionEntity.EXTRA_CUSTOM_NAME, action.customName))
+            }
+
             if (keyMap.isHoldingDownActionBeforeRepeatingAllowed(action) &&
                 action.holdDownDuration != null
             ) {
@@ -185,6 +206,10 @@ object ActionEntityMapper {
             flags = flags.withFlag(ActionEntity.ACTION_FLAG_HOLD_DOWN)
         }
 
+        if (!action.isEnabled) {
+            flags = flags.withFlag(ActionEntity.ACTION_FLAG_DISABLED)
+        }
+
         return@map ActionEntity(
             type = base.type,
             data = base.data,