User Tools
manual:Troubleshooting
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
manual:Troubleshooting [2019/06/19 01:29] peternlewis |
manual:Troubleshooting [2023/10/09 23:18] (current) peternlewis |
||
|---|---|---|---|
| Line 2: | Line 2: | ||
| See the [[:Troubleshooting|wiki Troubleshooting page]] for how to resolve any problems we have anticipated. | See the [[:Troubleshooting|wiki Troubleshooting page]] for how to resolve any problems we have anticipated. | ||
| + | |||
| + | Around 80% of all support emails we receive are related to Apple’s security permissions, including: | ||
| + | |||
| + | * [[assistance:Translocation_Problem|Translocation]] | ||
| + | * [[assistance:Accessibility_Permission_Problem|Accessibility]] | ||
| + | * [[assistance:Screen_Recording_Permission|Screen Recording]] | ||
| + | * [[assistance:Secure_Input_Problem|Secure Input Problem]] | ||
| + | |||
| + | Keyboard Maestro includes a Security preference pane in its [[manual:Preferences|Preferences]] window which summarises some of the important security settings and whether they are enabled. Ensuring that everything is enabled will resolve a lot of troubleshooting issues. | ||
| + | |||
| + | Unfortunately Apple’s permission system has been filled with bugs since Mojave, including things like: | ||
| + | |||
| + | * Checkboxes not showing up in the permission system. | ||
| + | * Checkboxes not being able to be ticked. | ||
| + | * Checkboxes showing as ticked, but not actually granting the permissions. | ||
| + | * The system telling Keyboard Maestro it has permission, when it really does not. | ||
| + | |||
| + | Remember to unlock the System Preferences which is required for changing some (but not all) permissions. | ||
| + | |||
| + | Thankfully, you can pretty much always resolve these by sufficient bashing on the permission system: | ||
| + | |||
| + | * Restart. | ||
| + | * Use `tccutil` to reset the permission system. | ||
| + | * Quit and relaunch Keyboard Maestro or the Keyboard Maestro Engine. | ||
| + | * Ensure you move the Keyboard Maestro.app to the Applications folder **using the Finder**. | ||
| + | |||
| + | Occasionally you can resolve the issues by re-installing the Keyboard Maestro.app: | ||
| + | |||
| + | * Quit Keyboard Maestro Engine | ||
| + | * Quit Keyboard Maestro (editor) | ||
| + | * Delete the Keyboard Maestro.app | ||
| + | * [[https://download.keyboardmaestro.com|Download]] a fresh copy of Keyboard Maestro. | ||
| + | * **Using the Finder**, move the Keyboard Maestro.app to the Applications folder. | ||
| + | * Launch Keyboard Maestro.app | ||
| + | |||
| + | This will not affect any existing macros. | ||
| ===== In-built Assistance ===== | ===== In-built Assistance ===== | ||
| - | If you are finding a macro is not firing when you expect it to, or something weird is happening when you don't expect it to, or choose [[Menus#Interactive_Help|Help ➤ Interactive Help menu]]) to bring up an interactive assistance system which might help you narrow down the problem. | + | The next most common issue is a macro doing nothing, or something weird is happening when you don't expect it to. In both these cases, choose [[Menus#Interactive_Help|Help ➤ Interactive Help menu]]) to bring up an interactive assistance system which might help you narrow down the problem. |
| + | |||
| + | Keyboard Maestro can detect some of the System Permission problems described above, when the system is not lying to it. | ||
| ===== How do I get more help? ===== | ===== How do I get more help? ===== | ||
manual/Troubleshooting.1560922152.txt.gz · Last modified: 2019/06/19 01:29 by peternlewis
Page Tools
