Add action to modify Android system settings via key mappings

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

@@ -723,6 +723,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 {
+                    io.github.sds100.keymapper.system.settings.SettingType.valueOf(settingTypeString)
+                } catch (e: IllegalArgumentException) {
+                    io.github.sds100.keymapper.system.settings.SettingType.SYSTEM
+                }
+
+                ActionData.ModifySetting(
+                    settingType = settingType,
+                    settingKey = entity.data,
+                    value = value,
+                )
+            }
         }
     }
 
@@ -825,6 +845,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 +1126,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 +1305,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

@@ -231,6 +231,26 @@ class LazyActionErrorSnapshot(
                 }
             }
 
+            is ActionData.ModifySetting -> {
+                return when (action.settingType) {
+                    io.github.sds100.keymapper.system.settings.SettingType.SYSTEM -> {
+                        if (!isPermissionGranted(Permission.WRITE_SETTINGS)) {
+                            SystemError.PermissionDenied(Permission.WRITE_SETTINGS)
+                        } else {
+                            null
+                        }
+                    }
+                    io.github.sds100.keymapper.system.settings.SettingType.SECURE,
+                    io.github.sds100.keymapper.system.settings.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/ActionUiHelper.kt

@@ -651,6 +651,21 @@ 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 -> {
+            val typeString = when (action.settingType) {
+                io.github.sds100.keymapper.system.settings.SettingType.SYSTEM ->
+                    getString(R.string.modify_setting_type_system)
+                io.github.sds100.keymapper.system.settings.SettingType.SECURE ->
+                    getString(R.string.modify_setting_type_secure)
+                io.github.sds100.keymapper.system.settings.SettingType.GLOBAL ->
+                    getString(R.string.modify_setting_type_global)
+            }
+            getString(
+                R.string.modify_setting_description,
+                arrayOf(action.settingKey, action.value, typeString),
+            )
+        }
     }
 
     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,8 @@ object ActionUtils {
                     return listOf(Permission.FIND_NEARBY_DEVICES)
                 }
 
+            ActionId.MODIFY_SETTING -> return emptyList() // Permissions handled based on setting type at runtime
+
             else -> return emptyList()
         }
 
@@ -890,6 +895,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
     }
 }
 

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

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

@@ -0,0 +1,198 @@
+package io.github.sds100.keymapper.base.actions
+
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.displayCutoutPadding
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.imePadding
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.lazy.items
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.outlined.Settings
+import androidx.compose.material3.BottomAppBar
+import androidx.compose.material3.CircularProgressIndicator
+import androidx.compose.material3.DropdownMenuItem
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.ExposedDropdownMenuBox
+import androidx.compose.material3.ExposedDropdownMenuDefaults
+import androidx.compose.material3.HorizontalDivider
+import androidx.compose.material3.ListItem
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedTextField
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.material3.TopAppBar
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.unit.dp
+import androidx.lifecycle.compose.collectAsStateWithLifecycle
+import io.github.sds100.keymapper.base.R
+import io.github.sds100.keymapper.base.utils.ui.compose.SearchAppBarActions
+import io.github.sds100.keymapper.common.utils.State
+import kotlinx.coroutines.flow.update
+
+@Composable
+fun ChooseSettingScreen(modifier: Modifier = Modifier, viewModel: ChooseSettingViewModel) {
+    val state by viewModel.settings.collectAsStateWithLifecycle()
+    val query by viewModel.searchQuery.collectAsStateWithLifecycle()
+    val settingType by viewModel.selectedSettingType.collectAsStateWithLifecycle()
+
+    ChooseSettingScreen(
+        modifier = modifier,
+        state = state,
+        query = query,
+        settingType = settingType,
+        onQueryChange = { newQuery -> viewModel.searchQuery.update { newQuery } },
+        onCloseSearch = { viewModel.searchQuery.update { null } },
+        onSettingTypeChange = { viewModel.selectedSettingType.value = it },
+        onClickSetting = viewModel::onSettingClick,
+        onNavigateBack = viewModel::onNavigateBack,
+    )
+}
+
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+private fun ChooseSettingScreen(
+    modifier: Modifier = Modifier,
+    state: State<List<SettingItem>>,
+    query: String? = null,
+    settingType: io.github.sds100.keymapper.system.settings.SettingType,
+    onQueryChange: (String) -> Unit = {},
+    onCloseSearch: () -> Unit = {},
+    onSettingTypeChange: (io.github.sds100.keymapper.system.settings.SettingType) -> Unit = {},
+    onClickSetting: (String, String?) -> Unit = { _, _ -> },
+    onNavigateBack: () -> Unit = {},
+) {
+    Scaffold(
+        modifier = modifier.displayCutoutPadding(),
+        topBar = {
+            TopAppBar(
+                title = { Text(stringResource(R.string.choose_setting_title)) },
+            )
+        },
+        bottomBar = {
+            BottomAppBar(
+                modifier = Modifier.imePadding(),
+                actions = {
+                    SearchAppBarActions(
+                        onCloseSearch = onCloseSearch,
+                        onNavigateBack = onNavigateBack,
+                        onQueryChange = onQueryChange,
+                        enabled = state is State.Data,
+                        query = query,
+                    )
+                },
+            )
+        },
+    ) { innerPadding ->
+        Surface(
+            modifier = Modifier
+                .fillMaxSize()
+                .padding(innerPadding),
+        ) {
+            Column(modifier = Modifier.fillMaxSize()) {
+                // Setting type dropdown
+                var expanded by remember { mutableStateOf(false) }
+
+                ExposedDropdownMenuBox(
+                    expanded = expanded,
+                    onExpandedChange = { expanded = it },
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .padding(16.dp),
+                ) {
+                    OutlinedTextField(
+                        value = when (settingType) {
+                            io.github.sds100.keymapper.system.settings.SettingType.SYSTEM ->
+                                stringResource(R.string.modify_setting_type_system)
+                            io.github.sds100.keymapper.system.settings.SettingType.SECURE ->
+                                stringResource(R.string.modify_setting_type_secure)
+                            io.github.sds100.keymapper.system.settings.SettingType.GLOBAL ->
+                                stringResource(R.string.modify_setting_type_global)
+                        },
+                        onValueChange = {},
+                        readOnly = true,
+                        label = { Text(stringResource(R.string.modify_setting_type_label)) },
+                        trailingIcon = { ExposedDropdownMenuDefaults.TrailingIcon(expanded = expanded) },
+                        modifier = Modifier.fillMaxWidth().menuAnchor(),
+                        singleLine = true,
+                    )
+                    ExposedDropdownMenu(
+                        expanded = expanded,
+                        onDismissRequest = { expanded = false },
+                    ) {
+                        DropdownMenuItem(
+                            text = { Text(stringResource(R.string.modify_setting_type_system)) },
+                            onClick = {
+                                onSettingTypeChange(io.github.sds100.keymapper.system.settings.SettingType.SYSTEM)
+                                expanded = false
+                            },
+                        )
+                        DropdownMenuItem(
+                            text = { Text(stringResource(R.string.modify_setting_type_secure)) },
+                            onClick = {
+                                onSettingTypeChange(io.github.sds100.keymapper.system.settings.SettingType.SECURE)
+                                expanded = false
+                            },
+                        )
+                        DropdownMenuItem(
+                            text = { Text(stringResource(R.string.modify_setting_type_global)) },
+                            onClick = {
+                                onSettingTypeChange(io.github.sds100.keymapper.system.settings.SettingType.GLOBAL)
+                                expanded = false
+                            },
+                        )
+                    }
+                }
+
+                HorizontalDivider()
+
+                // Settings list
+                when (state) {
+                    State.Loading -> {
+                        Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
+                            CircularProgressIndicator()
+                        }
+                    }
+                    is State.Data -> {
+                        if (state.data.isEmpty()) {
+                            Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
+                                Text(
+                                    text = stringResource(R.string.choose_setting_empty),
+                                    style = MaterialTheme.typography.bodyLarge,
+                                )
+                            }
+                        } else {
+                            LazyColumn(modifier = Modifier.fillMaxSize()) {
+                                items(state.data) { item ->
+                                    ListItem(
+                                        headlineContent = { Text(item.key) },
+                                        supportingContent = item.value?.let { { Text(it) } },
+                                        modifier = Modifier.clickable {
+                                            onClickSetting(item.key, item.value)
+                                        },
+                                    )
+                                    HorizontalDivider()
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}