Version 4.6.0

CHANGELOG.md

@@ -1,3 +1,39 @@
+## [4.6.0](https://github.com/sds100/KeyMapper/releases/tag/v4.6.0)
+
+#### TO BE RELEASED
+
+## Added
+
+- #711 new action to add to, subtract from or set a variable, and a new constraint for comparing a variable to a value.
+- #1493 the brightness increment for the increase/decrease brightness actions can now be configured, from 1% to 50% (default 10%).
+- #2075 enable/disable/toggle a group by sending a broadcast intent, configurable from Power user options in Settings.
+- #2263 constraints can now be edited in place from the constraints list instead of being deleted and re-added.
+- #2254 you can now give a key map a custom name, which is shown in the key map list.
+- #2252 undo and redo changes when configuring a key map.
+- #2155 the Expert Mode setup wizard now detects Samsung Auto Blocker and guides how to disable it, since it can silently block wireless debugging from staying enabled.
+- #2127 shut down and restart device actions.
+- #2281 action text in the key map list is more concise and the delay between actions is shown as a timer chip.
+- Show constraint icons when collapsed.
+
+## Changed
+
+- #2280 removed the confirmation dialogs when deleting actions, constraints and constraint groups because changes can now be undone.
+- #2252 redesigned the app bar when configuring a key map. Changes are saved automatically so there is no Done button, and the help button was removed.
+- Show side-by-side view when creating a key map on more devices
+- #2273 Constraints that the device can't support (e.g. no Bluetooth or hinge sensor) are now shown as unsupported when choosing a constraint.
+- Rename "app in foreground" constraint to "app is open".
+- #2282 moved the group enable switch into the top app bar to save vertical space.
+
+## Fixed
+
+- #2268 use trampoline when launching device assistant and settings apps when the device is locked so the lock screen dismisses.
+- #2271 brightness actions match brightness slider on Android 16.1+.
+- #1739 support multiple displays better.
+- #2276 Bottom key maps are obscured by selection bottom sheet.
+- Disable Wireless Debugging after manually starting Expert Mode.
+- #2285 show floating button border when configuring even if background is not transparent.
+- #2283 only show side key app in the launcher if the assistant trigger is used by a key map
+
 ## [4.5.0](https://github.com/sds100/KeyMapper/releases/tag/v4.5.0)
 
 #### 21 September 2026

README.md

@@ -21,10 +21,6 @@
 <noscript><a href="https://buy.stripe.com/00g16L9YEabldDWdQQ"><img alt="Donate using Stripe" src="https://img.shields.io/badge/Donate-Stripe-blueviolet?style=for-the-badge&logo=stripe"></a></noscript>
 </p>
 
-<p align="center">
-<img width="700"  src="https://github.com/user-attachments/assets/0411203c-4490-42ff-8aff-667cbde32f49" />
-</p>
-
 ## Unleash your keys!
 
 Make custom macros on your keyboard or gamepad, make on-screen buttons in any app, and unlock new functionality from your volume buttons!

api/src/main/AndroidManifest.xml

@@ -46,6 +46,16 @@
             </intent-filter>
         </receiver>
 
+        <receiver
+            android:name=".EnableGroupBroadcastReceiver"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="io.github.sds100.keymapper.ACTION_ENABLE_GROUP" />
+                <action android:name="io.github.sds100.keymapper.ACTION_DISABLE_GROUP" />
+                <action android:name="io.github.sds100.keymapper.ACTION_TOGGLE_GROUP" />
+            </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. -->

api/src/main/java/io/github/sds100/keymapper/api/Api.kt

@@ -13,4 +13,9 @@ object Api {
     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"
+
+    const val ACTION_ENABLE_GROUP = "io.github.sds100.keymapper.ACTION_ENABLE_GROUP"
+    const val ACTION_DISABLE_GROUP = "io.github.sds100.keymapper.ACTION_DISABLE_GROUP"
+    const val ACTION_TOGGLE_GROUP = "io.github.sds100.keymapper.ACTION_TOGGLE_GROUP"
+    const val EXTRA_GROUP_UID = "io.github.sds100.keymapper.EXTRA_GROUP_UID"
 }

api/src/main/java/io/github/sds100/keymapper/api/EnableGroupBroadcastReceiver.kt

@@ -0,0 +1,36 @@
+package io.github.sds100.keymapper.api
+
+import android.content.BroadcastReceiver
+import android.content.Context
+import android.content.Intent
+import dagger.hilt.android.AndroidEntryPoint
+import io.github.sds100.keymapper.base.keymaps.EnableGroupUseCase
+import javax.inject.Inject
+
+// DON'T MOVE THIS CLASS TO A DIFFERENT PACKAGE OR RENAME BECAUSE IT BREAKS THE API
+@AndroidEntryPoint
+class EnableGroupBroadcastReceiver : BroadcastReceiver() {
+
+    @Inject
+    lateinit var useCase: EnableGroupUseCase
+
+    override fun onReceive(context: Context?, intent: Intent?) {
+        context ?: return
+        intent?.action ?: return
+
+        if (intent.action != Api.ACTION_ENABLE_GROUP &&
+            intent.action != Api.ACTION_DISABLE_GROUP &&
+            intent.action != Api.ACTION_TOGGLE_GROUP
+        ) {
+            return
+        }
+
+        val groupUid = intent.getStringExtra(Api.EXTRA_GROUP_UID) ?: return
+
+        when (intent.action) {
+            Api.ACTION_ENABLE_GROUP -> useCase.enable(groupUid)
+            Api.ACTION_DISABLE_GROUP -> useCase.disable(groupUid)
+            Api.ACTION_TOGGLE_GROUP -> useCase.toggle(groupUid)
+        }
+    }
+}

app/proguard-rules.pro

@@ -82,6 +82,8 @@
 -keep class android.hardware.usb.IUsbManager { *; }
 -keep class android.hardware.usb.IUsbManager$Stub { *; }
 -keep class android.net.* { *; }
+-keep class android.os.IPowerManager { *; }
+-keep class android.os.IPowerManager$Stub { *; }
 
 -keepattributes *Annotation*, InnerClasses
 -dontnote kotlinx.serialization.AnnotationsKt # core serialization annotations

app/src/main/java/io/github/sds100/keymapper/purchasing/PurchasingManagerImpl.kt

@@ -7,12 +7,9 @@ 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
-import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
 
 class PurchasingManagerImpl : PurchasingManager {
-    override val onCompleteProductPurchase: MutableSharedFlow<RevenueCatEntitlementId> =
-        MutableSharedFlow()
     override val state: Flow<State<KMResult<RevenueCatState>>> =
         MutableStateFlow(State.Data(PurchasingError.PurchasingNotImplemented))
 

app/version.properties

@@ -1,2 +1,2 @@
-VERSION_NAME=4.5.0
-VERSION_CODE=271
+VERSION_NAME=4.6.0
+VERSION_CODE=277

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

@@ -1,4 +1,4 @@
-! Group constraints | Organize constraints into groups with their own AND/OR logic
+! Constraint groups | 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

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

@@ -166,7 +166,7 @@ abstract class BaseKeyMapperApp : MultiDexApplication() {
         }
     }
 
-    private fun init() {
+    open fun init() {
         Log.i(tag, "KeyMapperApp: Init")
 
         val intentFilter = IntentFilter().apply {

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

@@ -7,7 +7,9 @@ import android.content.Intent
 import android.content.IntentFilter
 import android.content.res.Configuration
 import android.net.Uri
+import android.os.Build
 import android.os.Bundle
+import android.view.Display
 import android.view.MotionEvent
 import android.widget.Toast
 import androidx.activity.SystemBarStyle
@@ -38,6 +40,7 @@ import io.github.sds100.keymapper.base.utils.ui.ResourceProviderImpl
 import io.github.sds100.keymapper.common.BuildConfigProvider
 import io.github.sds100.keymapper.sysbridge.service.SystemBridgeSetupControllerImpl
 import io.github.sds100.keymapper.system.devices.AndroidDevicesAdapter
+import io.github.sds100.keymapper.system.display.AndroidDisplayAdapter
 import io.github.sds100.keymapper.system.files.FileUtils
 import io.github.sds100.keymapper.system.inputevents.KMGamePadEvent
 import io.github.sds100.keymapper.system.network.AndroidNetworkAdapter
@@ -106,6 +109,9 @@ abstract class BaseMainActivity : AppCompatActivity() {
     @Inject
     lateinit var configKeyMapState: ConfigKeyMapStateImpl
 
+    @Inject
+    lateinit var displayAdapter: AndroidDisplayAdapter
+
     private lateinit var requestPermissionDelegate: RequestPermissionDelegate
 
     private val currentNightMode: Int
@@ -205,6 +211,11 @@ abstract class BaseMainActivity : AppCompatActivity() {
         onboardingUseCase.handledMigrateScreenOffKeyMapsNotification()
     }
 
+    override fun onPause() {
+        configKeyMapState.save()
+        super.onPause()
+    }
+
     override fun onSaveInstanceState(outState: Bundle) {
         configKeyMapState.saveState(outState)
 
@@ -219,6 +230,16 @@ abstract class BaseMainActivity : AppCompatActivity() {
         super.onDestroy()
     }
 
+    override fun onAttachedToWindow() {
+        super.onAttachedToWindow()
+
+        displayAdapter.activityDisplayId = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+            display?.displayId
+        } else {
+            Display.DEFAULT_DISPLAY
+        }
+    }
+
     /**
      * Process motion events from the activity so that DPAD buttons can be recorded
      * even when the Key Mapper IME is not being used. DO NOT record the key events because

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

@@ -32,7 +32,9 @@ 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.groups.EnableGroupByIntentScreen
 import io.github.sds100.keymapper.base.keymaps.EnableByIntentScreen
+import io.github.sds100.keymapper.base.keymaps.PauseResumeByIntentScreen
 import io.github.sds100.keymapper.base.keymaps.TriggerByIntentScreen
 import io.github.sds100.keymapper.base.logging.LogScreen
 import io.github.sds100.keymapper.base.onboarding.HandleAccessibilityServiceDialogs
@@ -106,9 +108,13 @@ fun BaseMainNavHost(
             )
         }
 
-        composable<NavDestination.ConfigNotificationConstraint> {
+        composable<NavDestination.ConfigNotificationConstraint> { backStackEntry ->
             val viewModel: ConfigNotificationConstraintViewModel = hiltViewModel()
 
+            backStackEntry.handleRouteArgs<NavDestination.ConfigNotificationConstraint> {
+                it.oldJson?.let { json -> viewModel.loadOldData(Json.decodeFromString(json)) }
+            }
+
             ConfigNotificationConstraintScreen(
                 modifier = Modifier.fillMaxSize(),
                 viewModel = viewModel,
@@ -223,6 +229,20 @@ fun BaseMainNavHost(
             )
         }
 
+        composable<NavDestination.PauseResumeByIntent> {
+            PauseResumeByIntentScreen(
+                modifier = Modifier.fillMaxSize(),
+                onBackClick = { navController.popBackStack() },
+            )
+        }
+
+        composable<NavDestination.EnableGroupByIntent> {
+            EnableGroupByIntentScreen(
+                modifier = Modifier.fillMaxSize(),
+                viewModel = hiltViewModel(),
+            )
+        }
+
         composableDestinations()
     }
 }

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

@@ -20,6 +20,8 @@ import io.github.sds100.keymapper.base.input.InputEventHub
 import io.github.sds100.keymapper.base.input.InputEventHubImpl
 import io.github.sds100.keymapper.base.keymaps.ConfigKeyMapState
 import io.github.sds100.keymapper.base.keymaps.ConfigKeyMapStateImpl
+import io.github.sds100.keymapper.base.keymaps.EnableGroupUseCase
+import io.github.sds100.keymapper.base.keymaps.EnableGroupUseCaseImpl
 import io.github.sds100.keymapper.base.keymaps.EnableKeyMapsUseCase
 import io.github.sds100.keymapper.base.keymaps.EnableKeyMapsUseCaseImpl
 import io.github.sds100.keymapper.base.keymaps.FingerprintGesturesSupportedUseCase
@@ -55,6 +57,8 @@ import io.github.sds100.keymapper.base.utils.ui.DialogProvider
 import io.github.sds100.keymapper.base.utils.ui.DialogProviderImpl
 import io.github.sds100.keymapper.base.utils.ui.ResourceProvider
 import io.github.sds100.keymapper.base.utils.ui.ResourceProviderImpl
+import io.github.sds100.keymapper.base.variables.VariablesUseCase
+import io.github.sds100.keymapper.base.variables.VariablesUseCaseImpl
 import io.github.sds100.keymapper.common.utils.Clock
 import io.github.sds100.keymapper.common.utils.ClockImpl
 import io.github.sds100.keymapper.common.utils.DefaultUuidGenerator
@@ -199,6 +203,10 @@ abstract class BaseSingletonHiltModule {
     @Singleton
     abstract fun bindEnableKeyMapsUseCase(impl: EnableKeyMapsUseCaseImpl): EnableKeyMapsUseCase
 
+    @Binds
+    @Singleton
+    abstract fun bindEnableGroupUseCase(impl: EnableGroupUseCaseImpl): EnableGroupUseCase
+
     @Binds
     @Singleton
     abstract fun bindSetupAccessibilityServiceDelegate(
@@ -208,4 +216,8 @@ abstract class BaseSingletonHiltModule {
     @Binds
     @Singleton
     abstract fun bindClock(impl: ClockImpl): Clock
+
+    @Binds
+    @Singleton
+    abstract fun bindVariablesUseCase(impl: VariablesUseCaseImpl): VariablesUseCase
 }

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

@@ -31,6 +31,8 @@ import io.github.sds100.keymapper.base.expertmode.SystemBridgeSetupUseCase
 import io.github.sds100.keymapper.base.expertmode.SystemBridgeSetupUseCaseImpl
 import io.github.sds100.keymapper.base.expertmode.xiaomi.XiaomiOptimizationUseCase
 import io.github.sds100.keymapper.base.expertmode.xiaomi.XiaomiOptimizationUseCaseImpl
+import io.github.sds100.keymapper.base.groups.SelectGroupUseCase
+import io.github.sds100.keymapper.base.groups.SelectGroupUseCaseImpl
 import io.github.sds100.keymapper.base.home.ListKeyMapsUseCase
 import io.github.sds100.keymapper.base.home.ListKeyMapsUseCaseImpl
 import io.github.sds100.keymapper.base.home.ShowHomeScreenAlertsUseCase
@@ -85,6 +87,10 @@ abstract class BaseViewModelHiltModule {
     @ViewModelScoped
     abstract fun bindListKeyMapsUseCase(impl: ListKeyMapsUseCaseImpl): ListKeyMapsUseCase
 
+    @Binds
+    @ViewModelScoped
+    abstract fun bindSelectGroupUseCase(impl: SelectGroupUseCaseImpl): SelectGroupUseCase
+
     @Binds
     @ViewModelScoped
     abstract fun bindBackupRestoreMappingsUseCase(

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

@@ -7,4 +7,19 @@ object IntentApi {
 
     const val TRIGGER_RECEIVER_CLASS =
         "io.github.sds100.keymapper.api.TriggerKeyMapsBroadcastReceiver"
+
+    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 PAUSE_RECEIVER_CLASS =
+        "io.github.sds100.keymapper.api.PauseMappingsBroadcastReceiver"
+
+    const val ACTION_ENABLE_GROUP = "io.github.sds100.keymapper.ACTION_ENABLE_GROUP"
+    const val ACTION_DISABLE_GROUP = "io.github.sds100.keymapper.ACTION_DISABLE_GROUP"
+    const val ACTION_TOGGLE_GROUP = "io.github.sds100.keymapper.ACTION_TOGGLE_GROUP"
+    const val EXTRA_GROUP_UID = "io.github.sds100.keymapper.EXTRA_GROUP_UID"
+
+    const val GROUP_RECEIVER_CLASS =
+        "io.github.sds100.keymapper.api.EnableGroupBroadcastReceiver"
 }

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

@@ -14,4 +14,5 @@ enum class ActionCategory {
     TELEPHONY,
     NOTIFICATIONS,
     SPECIAL,
+    VARIABLES,
 }