keymapperorg · sds100 · Jun 4, 2026 · May 10, 2026 · May 10, 2026 · May 15, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,22 @@
+## [4.2.0](https://github.com/sds100/KeyMapper/releases/tag/v4.2.0)
+
+#### 03 June 2026
+
+## Added
+
+- #2140 Add monochrome app icon layer for themed icon support on Android 13+.
+
+## Fixed
+
+- #2074 Scrolling the action or trigger list no longer accidentally moves items; reordering by drag now only activates from the drag handle or via long-press.
+
+## Changed
+
+- #1369 Add content descriptions to drag handles and custom "Move up"/"Move down" accessibility actions for trigger and action list items, improving TalkBack support for reordering.
+- #262 Add "TalkBack gesture" action to simulate TalkBack navigation gestures (swipes, multi-finger taps, and multi-directional swipes).
+- #2076 Use "any input device" as the default for triggers.
+
+
 ## [4.1.0](https://github.com/sds100/KeyMapper/releases/tag/v4.1.0)
 
 #### 10 May 2026

diff --git a/app/src/ci/res/mipmap-anydpi-v26/ic_launcher.xml b/app/src/ci/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -2,4 +2,5 @@
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
     <background android:drawable="@color/ic_launcher_background"/>
     <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_monochrome"/>
 </adaptive-icon>
diff --git a/app/src/ci/res/mipmap-anydpi-v26/ic_launcher_round.xml b/app/src/ci/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -2,4 +2,5 @@
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
     <background android:drawable="@color/ic_launcher_background"/>
     <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_monochrome"/>
 </adaptive-icon>
diff --git a/app/src/debug/res/mipmap-anydpi-v26/ic_launcher.xml b/app/src/debug/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -2,4 +2,5 @@
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
     <background android:drawable="@color/ic_launcher_background"/>
     <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_monochrome"/>
 </adaptive-icon>
diff --git a/app/src/debug/res/mipmap-anydpi-v26/ic_launcher_round.xml b/app/src/debug/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -2,4 +2,5 @@
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
     <background android:drawable="@color/ic_launcher_background"/>
     <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_monochrome"/>
 </adaptive-icon>
diff --git a/app/version.properties b/app/version.properties
@@ -1,2 +1,2 @@
-VERSION_NAME=4.1.0
-VERSION_CODE=251
+VERSION_NAME=4.2.0
+VERSION_CODE=253
diff --git a/base/src/main/assets/whats-new.txt b/base/src/main/assets/whats-new.txt
@@ -1,34 +1,9 @@
-✨ Screen-off remapping
-You can now remap ALL buttons when the screen is off (including the power button) for free with Expert mode.
-
 🎯 New Actions
-• Run shell commands
-• Send SMS messages
-• Force stop current app or clear from recents
-• Mute/unmute microphone
-• Modify any system setting
-• Show a custom notification
-• Toggle hotspot
-• Toggle night shift
-
-🆕 New Features
-• Redesigned Settings screen
-• Constraints for foldable hinge open/closed
-• Shortcuts on the trigger screen to guide setup
-• Select notification and alarm sounds for Sound action
-• Constraints for keyboard is showing
-• Switch next to record trigger button to use PRO mode
-
-
-⚙️ Enhanced Controls
-• Enable or disable all key maps in a group at once
-• Intent API to enable, disable, or toggle individual key maps
-• Floating buttons can now appear on top of keyboard or in notification panel
-• Make floating buttons movable and completely invisible
+• Select all text at the cursor
+• Input on-screen keyboard enter/send button
+• Show a toast message
 
 🔧 Improvements
-• Auto-switching keyboard more reliable and quicker on Android 13+
-• Wi-Fi connected constraints more reliable
-• A lot of bug fixes
+• Bug fixes
 
 📖 View the complete changelog at: http://keymapper.app/changelog
diff --git a/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionData.kt b/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionData.kt
@@ -1,5 +1,6 @@
 package io.github.sds100.keymapper.base.actions
 
+import io.github.sds100.keymapper.base.actions.talkback.TalkBackGestureType
 import io.github.sds100.keymapper.common.models.ShellExecutionMode
 import io.github.sds100.keymapper.common.utils.NodeInteractionType
 import io.github.sds100.keymapper.common.utils.Orientation
@@ -95,6 +96,7 @@ sealed class ActionData : Comparable<ActionData> {
                     { it.showVolumeUi },
                     { it.volumeStream },
                 )
+
                 else -> super.compareTo(other)
             }
         }
@@ -111,6 +113,7 @@ sealed class ActionData : Comparable<ActionData> {
                     { it.showVolumeUi },
                     { it.volumeStream },
                 )
+
                 else -> super.compareTo(other)
             }
         }
@@ -1040,6 +1043,17 @@ sealed class ActionData : Comparable<ActionData> {
                 { it.settingKey },
                 { it.value },
             )
+
+            else -> super.compareTo(other)
+        }
+    }
+
+    @Serializable
+    data class TalkBackGesture(val gesture: TalkBackGestureType) : ActionData() {
+        override val id: ActionId = ActionId.TALKBACK_GESTURE
+
+        override fun compareTo(other: ActionData) = when (other) {
+            is TalkBackGesture -> gesture.compareTo(other.gesture)
             else -> super.compareTo(other)
         }
     }

diff --git a/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionDataEntityMapper.kt b/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionDataEntityMapper.kt
@@ -2,6 +2,7 @@ package io.github.sds100.keymapper.base.actions
 
 import android.util.Base64
 import androidx.core.net.toUri
+import io.github.sds100.keymapper.base.actions.talkback.TalkBackGestureType
 import io.github.sds100.keymapper.common.models.ShellExecutionMode
 import io.github.sds100.keymapper.common.utils.KMError
 import io.github.sds100.keymapper.common.utils.KMResult
@@ -69,6 +70,7 @@ object ActionDataEntityMapper {
             ActionEntity.Type.MODIFY_SETTING -> ActionId.MODIFY_SETTING
 
             ActionEntity.Type.CREATE_NOTIFICATION -> ActionId.CREATE_NOTIFICATION
+
             ActionEntity.Type.TOAST -> ActionId.TOAST
         }
 
@@ -874,6 +876,20 @@ object ActionDataEntityMapper {
 
             ActionId.CLEAR_RECENT_APP -> ActionData.ClearRecentApp
 
+            ActionId.TALKBACK_GESTURE -> {
+                val gestureTypeString =
+                    entity.extras.getData(ActionEntity.EXTRA_TALKBACK_GESTURE_TYPE)
+                        .valueOrNull() ?: return null
+
+                val gestureType = try {
+                    TalkBackGestureType.valueOf(gestureTypeString)
+                } catch (_: IllegalArgumentException) {
+                    return null
+                }
+
+                ActionData.TalkBackGesture(gesture = gestureType)
+            }
+
             ActionId.MODIFY_SETTING -> {
                 val value = entity.extras.getData(ActionEntity.EXTRA_SETTING_VALUE)
                     .valueOrNull() ?: return null
@@ -1324,6 +1340,10 @@ object ActionDataEntityMapper {
             EntityExtra(ActionEntity.EXTRA_TOAST_DURATION, data.duration.name),
         )
 
+        is ActionData.TalkBackGesture -> listOf(
+            EntityExtra(ActionEntity.EXTRA_TALKBACK_GESTURE_TYPE, data.gesture.name),
+        )
+
         else -> emptyList()
     }
 
@@ -1510,5 +1530,7 @@ object ActionDataEntityMapper {
         ActionId.CLEAR_RECENT_APP to "clear_recent_app",
 
         ActionId.MODIFY_SETTING to "modify_setting",
+
+        ActionId.TALKBACK_GESTURE to "talkback_gesture",
     )
 }
diff --git a/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionErrorSnapshot.kt b/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionErrorSnapshot.kt
@@ -265,6 +265,10 @@ class LazyActionErrorSnapshot(
                 }
             }
 
+            is ActionData.TalkBackGesture -> {
+                return getAppError(TALKBACK_PACKAGE_NAME)
+            }
+
             else -> {}
         }
 
@@ -317,3 +321,5 @@ interface ActionErrorSnapshot {
     fun getError(action: ActionData): KMError?
     fun getErrors(actions: List<ActionData>): Map<ActionData, KMError?>
 }
+
+private const val TALKBACK_PACKAGE_NAME = "com.google.android.marvin.talkback"
diff --git a/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionId.kt b/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionId.kt
@@ -161,4 +161,6 @@ enum class ActionId {
     CLEAR_RECENT_APP,
 
     MODIFY_SETTING,
+
+    TALKBACK_GESTURE,
 }
diff --git a/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionListItem.kt b/base/src/main/java/io/github/sds100/keymapper/base/actions/ActionListItem.kt
@@ -39,6 +39,9 @@ import androidx.compose.ui.geometry.Offset
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.CustomAccessibilityAction
+import androidx.compose.ui.semantics.customActions
+import androidx.compose.ui.semantics.semantics
 import androidx.compose.ui.text.style.TextOverflow
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
@@ -62,28 +65,45 @@ fun ActionListItem(
     onRemoveClick: () -> Unit = {},
     onFixClick: () -> Unit = {},
     onTestClick: () -> Unit = {},
+    onMoveUp: (() -> Unit)? = null,
+    onMoveDown: (() -> Unit)? = null,
 ) {
     val draggableState = rememberDraggableState {
         dragDropState?.onDrag(Offset(0f, it))
     }
 
+    val moveUpLabel = stringResource(R.string.accessibility_action_move_up)
+    val moveDownLabel = stringResource(R.string.accessibility_action_move_down)
+
     Column(modifier = modifier.fillMaxWidth()) {
         ElevatedCard(
             modifier = Modifier
                 .fillMaxWidth()
                 .heightIn(min = 48.dp)
                 .height(IntrinsicSize.Min)
                 .padding(start = 16.dp, end = 16.dp)
-                .draggable(
-                    state = draggableState,
-                    enabled = isDraggingEnabled,
-                    orientation = Orientation.Vertical,
-                    startDragImmediately = false,
-                    onDragStarted = { offset ->
-                        dragDropState?.onDragStart(index, offset)
-                    },
-                    onDragStopped = { dragDropState?.onDragInterrupted() },
-                ),
+                .semantics {
+                    if (isReorderingEnabled) {
+                        customActions = buildList {
+                            onMoveUp?.let { action ->
+                                add(
+                                    CustomAccessibilityAction(moveUpLabel) {
+                                        action()
+                                        true
+                                    },
+                                )
+                            }
+                            onMoveDown?.let { action ->
+                                add(
+                                    CustomAccessibilityAction(moveDownLabel) {
+                                        action()
+                                        true
+                                    },
+                                )
+                            }
+                        }
+                    }
+                },
             colors = CardDefaults.elevatedCardColors(
                 containerColor = if (isDragging) {
                     MaterialTheme.colorScheme.surfaceContainerHighest
@@ -100,9 +120,20 @@ fun ActionListItem(
 
                 if (isReorderingEnabled) {
                     Icon(
-                        modifier = Modifier.size(24.dp),
+                        modifier = Modifier
+                            .size(24.dp)
+                            .draggable(
+                                state = draggableState,
+                                enabled = isDraggingEnabled,
+                                orientation = Orientation.Vertical,
+                                startDragImmediately = true,
+                                onDragStarted = { offset ->
+                                    dragDropState?.onDragStart(index, offset)
+                                },
+                                onDragStopped = { dragDropState?.onDragInterrupted() },
+                            ),
                         imageVector = Icons.Rounded.DragHandle,
-                        contentDescription = null,
+                        contentDescription = stringResource(R.string.drag_handle_for, model.text),
                         tint = MaterialTheme.colorScheme.onSurface,
                     )
                 }