Add action to modify Android system settings via key mappings

CHANGELOG.md

@@ -1,3 +1,10 @@
+## [4.0.0 Beta 3](https://github.com/sds100/KeyMapper/releases/tag/v4.0.0-beta.03)
+
+#### TO BE RELEASED
+
+## Added
+- #1871 action to modify any system settings
+
 ## [4.0.0 Beta 2](https://github.com/sds100/KeyMapper/releases/tag/v4.0.0-beta.02)
 
 #### 08 November 2025

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

@@ -6,6 +6,7 @@ You can now remap ALL buttons when the screen is off (including the power button
 • Send SMS messages
 • Force stop current app or clear from recents
 • Mute/unmute microphone
+• Modify any system setting
 
 🆕 New Features
 • Redesigned Settings screen

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

@@ -21,7 +21,6 @@ import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.flowWithLifecycle
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.withStateAtLeast
-import androidx.navigation.findNavController
 import com.anggrayudi.storage.extension.openInputStream
 import com.anggrayudi.storage.extension.openOutputStream
 import com.anggrayudi.storage.extension.toDocumentFile
@@ -32,6 +31,7 @@ import io.github.sds100.keymapper.base.onboarding.OnboardingUseCase
 import io.github.sds100.keymapper.base.system.accessibility.AccessibilityServiceAdapterImpl
 import io.github.sds100.keymapper.base.system.permissions.RequestPermissionDelegate
 import io.github.sds100.keymapper.base.trigger.RecordTriggerControllerImpl
+import io.github.sds100.keymapper.base.utils.navigation.NavigationProvider
 import io.github.sds100.keymapper.base.utils.ui.ResourceProviderImpl
 import io.github.sds100.keymapper.common.BuildConfigProvider
 import io.github.sds100.keymapper.sysbridge.service.SystemBridgeSetupControllerImpl
@@ -43,12 +43,12 @@ import io.github.sds100.keymapper.system.notifications.NotificationReceiverAdapt
 import io.github.sds100.keymapper.system.permissions.AndroidPermissionAdapter
 import io.github.sds100.keymapper.system.root.SuAdapterImpl
 import io.github.sds100.keymapper.system.shizuku.ShizukuAdapter
-import javax.inject.Inject
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.flow.launchIn
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
 import timber.log.Timber
+import javax.inject.Inject
 
 abstract class BaseMainActivity : AppCompatActivity() {
 
@@ -105,6 +105,9 @@ abstract class BaseMainActivity : AppCompatActivity() {
     @Inject
     lateinit var inputEventHub: InputEventHubImpl
 
+    @Inject
+    lateinit var navigationProvider: NavigationProvider
+
     private lateinit var requestPermissionDelegate: RequestPermissionDelegate
 
     private val currentNightMode: Int
@@ -162,15 +165,14 @@ abstract class BaseMainActivity : AppCompatActivity() {
             notificationReceiverAdapter = notificationReceiverAdapter,
             buildConfigProvider = buildConfigProvider,
             shizukuAdapter = shizukuAdapter,
+            navigationProvider = navigationProvider,
+            coroutineScope = lifecycleScope,
         )
 
         permissionAdapter.request
             .flowWithLifecycle(lifecycle, Lifecycle.State.STARTED)
             .onEach { permission ->
-                requestPermissionDelegate.requestPermission(
-                    permission,
-                    findNavController(R.id.container),
-                )
+                requestPermissionDelegate.requestPermission(permission)
             }
             .launchIn(lifecycleScope)
 

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

@@ -18,6 +18,7 @@ import androidx.navigation.compose.NavHost
 import androidx.navigation.compose.composable
 import io.github.sds100.keymapper.base.actions.ChooseActionScreen
 import io.github.sds100.keymapper.base.actions.ChooseActionViewModel
+import io.github.sds100.keymapper.base.actions.ChooseSettingScreen
 import io.github.sds100.keymapper.base.actions.ConfigShellCommandViewModel
 import io.github.sds100.keymapper.base.actions.ShellCommandActionScreen
 import io.github.sds100.keymapper.base.actions.uielement.InteractUiElementScreen
@@ -164,6 +165,13 @@ fun BaseMainNavHost(
             )
         }
 
+        composable<NavDestination.ChooseSetting> {
+            ChooseSettingScreen(
+                modifier = Modifier.fillMaxSize(),
+                viewModel = hiltViewModel(),
+            )
+        }
+
         composableDestinations()
     }
 }

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

@@ -949,4 +949,24 @@ sealed class ActionData : Comparable<ActionData> {
     data object ClearRecentApp : ActionData() {
         override val id: ActionId = ActionId.CLEAR_RECENT_APP
     }
+
+    @Serializable
+    data class ModifySetting(
+        val settingType: io.github.sds100.keymapper.system.settings.SettingType,
+        val settingKey: String,
+        val value: String,
+    ) : ActionData() {
+        override val id: ActionId = ActionId.MODIFY_SETTING
+
+        override fun compareTo(other: ActionData) = when (other) {
+            is ModifySetting -> compareValuesBy(
+                this,
+                other,
+                { it.settingType },
+                { it.settingKey },
+                { it.value },
+            )
+            else -> super.compareTo(other)
+        }
+    }
 }

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

@@ -22,6 +22,7 @@ import io.github.sds100.keymapper.system.camera.CameraLens
 import io.github.sds100.keymapper.system.intents.IntentExtraModel
 import io.github.sds100.keymapper.system.intents.IntentTarget
 import io.github.sds100.keymapper.system.network.HttpMethod
+import io.github.sds100.keymapper.system.settings.SettingType
 import io.github.sds100.keymapper.system.volume.DndMode
 import io.github.sds100.keymapper.system.volume.RingerMode
 import io.github.sds100.keymapper.system.volume.VolumeStream
@@ -50,6 +51,7 @@ object ActionDataEntityMapper {
 
             ActionEntity.Type.INTERACT_UI_ELEMENT -> ActionId.INTERACT_UI_ELEMENT
             ActionEntity.Type.SHELL_COMMAND -> ActionId.SHELL_COMMAND
+            ActionEntity.Type.MODIFY_SETTING -> ActionId.MODIFY_SETTING
         }
 
         return when (actionId) {
@@ -723,6 +725,26 @@ object ActionDataEntityMapper {
 
             ActionId.FORCE_STOP_APP -> ActionData.ForceStopApp
             ActionId.CLEAR_RECENT_APP -> ActionData.ClearRecentApp
+
+            ActionId.MODIFY_SETTING -> {
+                val value = entity.extras.getData(ActionEntity.EXTRA_SETTING_VALUE)
+                    .valueOrNull() ?: return null
+
+                val settingTypeString = entity.extras.getData(ActionEntity.EXTRA_SETTING_TYPE)
+                    .valueOrNull() ?: "SYSTEM" // Default to SYSTEM for backward compatibility
+
+                val settingType = try {
+                    SettingType.valueOf(settingTypeString)
+                } catch (_: IllegalArgumentException) {
+                    SettingType.SYSTEM
+                }
+
+                ActionData.ModifySetting(
+                    settingType = settingType,
+                    settingKey = entity.data,
+                    value = value,
+                )
+            }
         }
     }
 
@@ -749,6 +771,7 @@ object ActionDataEntityMapper {
             is ActionData.Sound -> ActionEntity.Type.SOUND
             is ActionData.InteractUiElement -> ActionEntity.Type.INTERACT_UI_ELEMENT
             is ActionData.ShellCommand -> ActionEntity.Type.SHELL_COMMAND
+            is ActionData.ModifySetting -> ActionEntity.Type.MODIFY_SETTING
             else -> ActionEntity.Type.SYSTEM_ACTION
         }
 
@@ -825,6 +848,7 @@ object ActionDataEntityMapper {
         is ActionData.ControlMedia.Rewind -> SYSTEM_ACTION_ID_MAP[data.id]!!
         is ActionData.ControlMedia.Stop -> SYSTEM_ACTION_ID_MAP[data.id]!!
         is ActionData.GoBack -> SYSTEM_ACTION_ID_MAP[data.id]!!
+        is ActionData.ModifySetting -> data.settingKey
         else -> SYSTEM_ACTION_ID_MAP[data.id]!!
     }
 
@@ -1105,6 +1129,11 @@ object ActionDataEntityMapper {
             EntityExtra(ActionEntity.EXTRA_SHELL_COMMAND_TIMEOUT, data.timeoutMillis.toString()),
         )
 
+        is ActionData.ModifySetting -> listOf(
+            EntityExtra(ActionEntity.EXTRA_SETTING_VALUE, data.value),
+            EntityExtra(ActionEntity.EXTRA_SETTING_TYPE, data.settingType.name),
+        )
+
         else -> emptyList()
     }
 
@@ -1279,5 +1308,7 @@ object ActionDataEntityMapper {
         ActionId.HTTP_REQUEST to "http_request",
         ActionId.FORCE_STOP_APP to "force_stop_app",
         ActionId.CLEAR_RECENT_APP to "clear_recent_app",
+
+        ActionId.MODIFY_SETTING to "modify_setting",
     )
 }

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

@@ -27,6 +27,7 @@ import io.github.sds100.keymapper.system.permissions.Permission
 import io.github.sds100.keymapper.system.permissions.PermissionAdapter
 import io.github.sds100.keymapper.system.permissions.SystemFeatureAdapter
 import io.github.sds100.keymapper.system.ringtones.RingtoneAdapter
+import io.github.sds100.keymapper.system.settings.SettingType
 
 class LazyActionErrorSnapshot(
     private val packageManager: PackageManagerAdapter,
@@ -231,6 +232,27 @@ class LazyActionErrorSnapshot(
                 }
             }
 
+            is ActionData.ModifySetting -> {
+                return when (action.settingType) {
+                    SettingType.SYSTEM -> {
+                        if (!isPermissionGranted(Permission.WRITE_SETTINGS)) {
+                            SystemError.PermissionDenied(Permission.WRITE_SETTINGS)
+                        } else {
+                            null
+                        }
+                    }
+                    SettingType.SECURE,
+                    SettingType.GLOBAL,
+                        -> {
+                        if (!isPermissionGranted(Permission.WRITE_SECURE_SETTINGS)) {
+                            SystemError.PermissionDenied(Permission.WRITE_SECURE_SETTINGS)
+                        } else {
+                            null
+                        }
+                    }
+                }
+            }
+
             else -> {}
         }
 

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

@@ -147,4 +147,6 @@ enum class ActionId {
 
     FORCE_STOP_APP,
     CLEAR_RECENT_APP,
+
+    MODIFY_SETTING,
 }

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

@@ -24,14 +24,12 @@ import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.ModalBottomSheet
 import androidx.compose.material3.OutlinedButton
 import androidx.compose.material3.SheetState
-import androidx.compose.material3.SheetValue.Expanded
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.LocalContext
-import androidx.compose.ui.platform.LocalDensity
 import androidx.compose.ui.platform.LocalUriHandler
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextAlign
@@ -413,8 +411,8 @@ private fun Preview() {
     KeyMapperTheme {
         val sheetState = SheetState(
             skipPartiallyExpanded = true,
-            density = LocalDensity.current,
-            initialValue = Expanded,
+            positionalThreshold = { 0f },
+            velocityThreshold = { 0f },
         )
 
         ActionOptionsBottomSheet(
@@ -472,8 +470,8 @@ private fun PreviewNoEditButton() {
     KeyMapperTheme {
         val sheetState = SheetState(
             skipPartiallyExpanded = true,
-            density = LocalDensity.current,
-            initialValue = Expanded,
+            positionalThreshold = { 0f },
+            velocityThreshold = { 0f },
         )
 
         ActionOptionsBottomSheet(

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

@@ -651,6 +651,13 @@ class ActionUiHelper(
         ActionData.Microphone.Mute -> getString(R.string.action_mute_microphone)
         ActionData.Microphone.Toggle -> getString(R.string.action_toggle_mute_microphone)
         ActionData.Microphone.Unmute -> getString(R.string.action_unmute_microphone)
+
+        is ActionData.ModifySetting -> {
+            getString(
+                R.string.modify_setting_description,
+                arrayOf(action.settingKey, action.value),
+            )
+        }
     }
 
     fun getIcon(action: ActionData): ComposeIconInfo = when (action) {

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

@@ -253,6 +253,7 @@ object ActionUtils {
         ActionId.INTERACT_UI_ELEMENT -> ActionCategory.APPS
         ActionId.FORCE_STOP_APP -> ActionCategory.APPS
         ActionId.CLEAR_RECENT_APP -> ActionCategory.APPS
+        ActionId.MODIFY_SETTING -> ActionCategory.APPS
 
         ActionId.CONSUME_KEY_EVENT -> ActionCategory.SPECIAL
     }
@@ -383,6 +384,8 @@ object ActionUtils {
         ActionId.INTERACT_UI_ELEMENT -> R.string.action_interact_ui_element_title
         ActionId.FORCE_STOP_APP -> R.string.action_force_stop_app
         ActionId.CLEAR_RECENT_APP -> R.string.action_clear_recent_app
+
+        ActionId.MODIFY_SETTING -> R.string.action_modify_setting
     }
 
     @DrawableRes
@@ -760,6 +763,9 @@ object ActionUtils {
                     return listOf(Permission.FIND_NEARBY_DEVICES)
                 }
 
+            // Permissions handled based on setting type at runtime
+            ActionId.MODIFY_SETTING -> return emptyList()
+
             else -> return emptyList()
         }
 
@@ -890,6 +896,8 @@ object ActionUtils {
         ActionId.INTERACT_UI_ELEMENT -> KeyMapperIcons.JumpToElement
         ActionId.FORCE_STOP_APP -> Icons.Outlined.Dangerous
         ActionId.CLEAR_RECENT_APP -> Icons.Outlined.VerticalSplit
+
+        ActionId.MODIFY_SETTING -> Icons.Outlined.Settings
     }
 }
 
@@ -936,6 +944,7 @@ fun ActionData.isEditable(): Boolean = when (this) {
     is ActionData.ShellCommand,
     is ActionData.InteractUiElement,
     is ActionData.MoveCursor,
+    is ActionData.ModifySetting,
         -> true
 
     else -> false

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

@@ -56,6 +56,7 @@ fun HandleActionBottomSheets(delegate: CreateActionDelegate) {
     HttpRequestBottomSheet(delegate)
     SmsActionBottomSheet(delegate)
     VolumeActionBottomSheet(delegate)
+    ModifySettingActionBottomSheet(delegate)
 }
 
 @Composable