#1593 Deprecate open menu action

Closes #1593

Author: sds100

CHANGELOG.md

@@ -12,6 +12,7 @@ _See the changes from previous 3.0 Beta releases as well._
 ## Changed
 
 - #1577 Move unsupported actions to the bottom of the list and do not allow selecting root actions if root permission is not granted.
+- #1593 Deprecate the 'Open menu' action by not letting new key maps use it. It is a relic of the past when most apps had a 3-dot menu with a consistent content description making it somewhat easy to identify.
 
 ## Bug fixes
 

app/src/main/java/io/github/sds100/keymapper/actions/ChooseActionViewModel.kt

@@ -126,6 +126,14 @@ class ChooseActionViewModel(
         actionIds: List<ActionId>,
     ): List<SimpleListItemModel> = buildList {
         for (actionId in actionIds) {
+            // See Issue #1593. This action should no longer exist because it is a relic
+            // of the past when most apps had a 3-dot menu with a consistent content description
+            // making it somewhat easy to identify. This action should still be usable
+            // if a user already has a key map with it so just hide it from the list.
+            if (actionId == ActionId.OPEN_MENU) {
+                continue
+            }
+
             val error = useCase.isSupported(actionId)
             val isSupported = error == null
 

docs/user-guide/actions.md

@@ -169,6 +169,8 @@ This will increase or decrease a specific one of these volume streams.
 
 ### Open menu
 
+!!! attention "Deprecated in Key Mapper 3.0+"
+
 ### Toggle/enable/disable flashlight
 
 In Key Mapper 3.0+ there is the option to also set a custom brightness. This is only supported on Android 13+ and on some devices.