keymapperorg · sds100 · Sep 21, 2026 · Sep 12, 2026 · Sep 13, 2026 · Sep 13, 2026
diff --git a/.github/workflows/pull-request.yml b/.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"
 

diff --git a/.github/workflows/testing.yml b/.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"
 

diff --git a/.gitignore b/.gitignore
@@ -97,4 +97,5 @@ app/.env
 
 evdev/build
 evdev/.cxx
-evdev/src/main/rust/*/target
+evdev/src/main/rust/*/target
+.kotlin/*
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,42 @@
-## [4.4.0](https://github.com/sds100/KeyMapper/releases/tag/v4.3.2)
+## [4.5.0](https://github.com/sds100/KeyMapper/releases/tag/v4.5.0)
+
+#### 21 September 2026
+
+## 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.
+- #2244 only show "Expert mode started" notification the first time it is auto started. Not every time the Key Mapper process starts and the system bridge connects.
+
+## [4.4.0](https://github.com/sds100/KeyMapper/releases/tag/v4.4.0)
 
 #### 12 September 2026
 

diff --git a/CLAUDE.md b/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
@@ -90,6 +91,9 @@ Example: `#2025 feat: add button to report bug on home screen`
 - 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
+- Dialog and modal bottom sheet previews render blank by default because they open a separate
+  window. Use `@Preview(showSystemUi = true)` for both. For bottom sheets, also create the
+  preview's `SheetState` with `initialValue = SheetValue.Expanded`.
 
 ## Adding a New Action (10-step checklist)
 

diff --git a/README.md b/README.md
@@ -8,6 +8,10 @@
 </b>
 </p>
 
+<p align="center">
+<a href="https://trendshift.io/repositories/13504?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-13504" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/13504" alt="keymapperorg%2FKeyMapper | Trendshift" width="250" height="55"/></a>
+</p>
+
 <p align="center">
 <a href='https://play.google.com/store/apps/details?id=io.github.sds100.keymapper&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' height='75px'/></a>
 <a href="https://f-droid.org/packages/io.github.sds100.keymapper/" rel="nofollow"><img alt="Get it on F-Droid" height="75" src="https://user-images.githubusercontent.com/53379023/142497343-0e635fc5-056b-46ff-8d8e-d607ed95527e.png" data-canonical-src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" style="max-width: 100%;"></a>

diff --git a/app/src/main/java/io/github/sds100/keymapper/MainFragment.kt b/app/src/main/java/io/github/sds100/keymapper/MainFragment.kt
@@ -13,13 +13,15 @@ import androidx.compose.foundation.layout.only
 import androidx.compose.foundation.layout.systemBars
 import androidx.compose.foundation.layout.windowInsetsPadding
 import androidx.compose.material3.SnackbarHostState
+import androidx.compose.runtime.getValue
 import androidx.compose.runtime.remember
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.ComposeView
 import androidx.compose.ui.platform.ViewCompositionStrategy
 import androidx.compose.ui.unit.dp
 import androidx.fragment.app.Fragment
 import androidx.hilt.navigation.compose.hiltViewModel
+import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.navigation.NavController
 import androidx.navigation.NavGraphBuilder
 import androidx.navigation.NavHostController
@@ -34,6 +36,7 @@ import io.github.sds100.keymapper.base.compose.KeyMapperTheme
 import io.github.sds100.keymapper.base.constraints.ConfigConstraintsViewModel
 import io.github.sds100.keymapper.base.constraints.ConstraintsScreen
 import io.github.sds100.keymapper.base.home.HomeKeyMapListScreen
+import io.github.sds100.keymapper.base.home.WhatsNewDialog
 import io.github.sds100.keymapper.base.keymaps.ConfigKeyMapScreen
 import io.github.sds100.keymapper.base.keymaps.ConfigKeyMapViewModel
 import io.github.sds100.keymapper.base.keymaps.KeyMapOptionsScreen
@@ -142,16 +145,24 @@ class MainFragment : Fragment() {
 
             val viewModel: HomeViewModel = hiltViewModel()
 
+            val whatsNewState by viewModel.whatsNewState.collectAsStateWithLifecycle()
+
+            whatsNewState?.let { state ->
+                WhatsNewDialog(state = state, onDismissRequest = viewModel::onDismissWhatsNew)
+            }
+
             HomeKeyMapListScreen(
                 modifier = Modifier.fillMaxSize(),
                 viewModel = viewModel.keyMapListViewModel,
                 snackbarState = snackbarState,
                 onSettingsClick = viewModel::launchSettings,
                 onAboutClick = viewModel::launchAbout,
+                onWhatsNewClick = viewModel::onWhatsNewClick,
                 finishActivity = {
                     requireActivity().finish()
                 },
                 fabBottomPadding = 0.dp,
+                headerExtraContent = {},
             )
         }
 

diff --git a/app/src/main/java/io/github/sds100/keymapper/purchasing/PurchasingManagerImpl.kt b/app/src/main/java/io/github/sds100/keymapper/purchasing/PurchasingManagerImpl.kt
@@ -3,6 +3,7 @@ package io.github.sds100.keymapper.purchasing
 import io.github.sds100.keymapper.base.purchasing.PurchasingError
 import io.github.sds100.keymapper.base.purchasing.PurchasingManager
 import io.github.sds100.keymapper.base.purchasing.RevenueCatEntitlementId
+import io.github.sds100.keymapper.base.purchasing.RevenueCatState
 import io.github.sds100.keymapper.common.utils.KMResult
 import io.github.sds100.keymapper.common.utils.State
 import kotlinx.coroutines.flow.Flow
@@ -12,7 +13,7 @@ import kotlinx.coroutines.flow.MutableStateFlow
 class PurchasingManagerImpl : PurchasingManager {
     override val onCompleteProductPurchase: MutableSharedFlow<RevenueCatEntitlementId> =
         MutableSharedFlow()
-    override val entitlements: Flow<State<KMResult<Set<RevenueCatEntitlementId>>>> =
+    override val state: Flow<State<KMResult<RevenueCatState>>> =
         MutableStateFlow(State.Data(PurchasingError.PurchasingNotImplemented))
 
     override suspend fun launchPurchasingFlow(

diff --git a/app/src/main/java/io/github/sds100/keymapper/trigger/ConfigTriggerViewModel.kt b/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,

diff --git a/app/version.properties b/app/version.properties
@@ -1,2 +1,2 @@
-VERSION_NAME=4.4.0
-VERSION_CODE=264
+VERSION_NAME=4.5.0
+VERSION_CODE=271
diff --git a/base/build.gradle.kts b/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

diff --git a/base/src/main/assets/whats-new-app.txt b/base/src/main/assets/whats-new-app.txt
@@ -0,0 +1,7 @@
+! 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
diff --git a/base/src/main/assets/whats-new.txt b/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
diff --git a/base/src/main/java/io/github/sds100/keymapper/base/BaseMainNavHost.kt b/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()
     }
 }
diff --git a/base/src/main/java/io/github/sds100/keymapper/base/BaseSingletonHiltModule.kt b/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(

diff --git a/base/src/main/java/io/github/sds100/keymapper/base/BaseViewModelHiltModule.kt b/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(

diff --git a/base/src/main/java/io/github/sds100/keymapper/base/IntentApi.kt b/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"
+}