User Tools
Troubleshooting
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
Troubleshooting [2018/03/18 04:30] peternlewis Keyboard Maestro editor |
Troubleshooting [2019/09/17 23:00] peternlewis |
||
|---|---|---|---|
| Line 9: | Line 9: | ||
| A relatively common situation occurs when a macro you expect to fire is not firing. Here is what to do: (v8+) | A relatively common situation occurs when a macro you expect to fire is not firing. Here is what to do: (v8+) | ||
| - | * Choose Assistance from the Help menu. | + | * Choose Interactive Help (previously Assistance) from the Help menu. |
| * Click the *Something expected is not happening* link. | * Click the *Something expected is not happening* link. | ||
| * Keyboard Maestro will verify that things look good, specifically: | * Keyboard Maestro will verify that things look good, specifically: | ||
| Line 38: | Line 38: | ||
| Generally Keyboard Maestro will only do what you tell it to do, but sometimes that can still result in something you don’t expect happening. Here is what to do: (v8+) | Generally Keyboard Maestro will only do what you tell it to do, but sometimes that can still result in something you don’t expect happening. Here is what to do: (v8+) | ||
| - | * Choose Assistance from the Help menu. | + | * Choose Interactive Help (previously Assistance) from the Help menu. |
| * Click the *Something unexpected is happening* link. | * Click the *Something unexpected is happening* link. | ||
| * Click the *Quit the Engine* link. | * Click the *Quit the Engine* link. | ||
| Line 64: | Line 64: | ||
| - Then Hold down <kbd>⌘</kbd><kbd>⌃</kbd><kbd>⌥</kbd><kbd>⇧</kbd> when you launch Keyboard Maestro. | - Then Hold down <kbd>⌘</kbd><kbd>⌃</kbd><kbd>⌥</kbd><kbd>⇧</kbd> when you launch Keyboard Maestro. | ||
| - As noted above, this will prevent the //Engine// from starting, and you can fix, disable, or delete the macro causing the issue. | - As noted above, this will prevent the //Engine// from starting, and you can fix, disable, or delete the macro causing the issue. | ||
| + | |||
| + | |||
| + | ==== App Freezes (Locks up, Spinning Beachball) or Other Strange Behavior due to SIMBL ==== | ||
| + | |||
| + | If Keyboard Maestro freezes, locks-up or is exhibiting very strange behavior, check to see if you have [[https://en.wikipedia.org/wiki/SIMBL|SIMBL]] installed in this folder: | ||
| + | |||
| + | `/Library/Application Support/SIMBL/` | ||
| + | |||
| + | **SIMBL** is very clever, but some of its extensions can lead to bizarre behavior, crashes, freezes and other strange, unexpected behavior in one or more apps or the macOS itself. So if you have it installed, pretty much all bets are off as far as stability goes for your Mac. See [[https://macremover.com/uninstallguides/2018/06/19/remove-mysimbl-macos/|How to remove mySIMBL and SIMBL in macOS]]. | ||
| Line 89: | Line 98: | ||
| If Access for Assistive Devices is not enabled, then Keyboard Maestro cannot watch the keyboard for keystrokes. Keyboard Maestro warns you of this when you launch it, as well as with a small yellow warning triangle in the bottom right corner of the main window. Click on the triangle and follow the instructions to enable access for assistive devices. In Mavericks, the accessibility preferences are in the System Preferences Security & Privacy panel, Privacy pane - there are some reports that Mavericks can get confused if you have two different versions of Keyboard Maestro on your Mac, so check that panel closely. | If Access for Assistive Devices is not enabled, then Keyboard Maestro cannot watch the keyboard for keystrokes. Keyboard Maestro warns you of this when you launch it, as well as with a small yellow warning triangle in the bottom right corner of the main window. Click on the triangle and follow the instructions to enable access for assistive devices. In Mavericks, the accessibility preferences are in the System Preferences Security & Privacy panel, Privacy pane - there are some reports that Mavericks can get confused if you have two different versions of Keyboard Maestro on your Mac, so check that panel closely. | ||
| - | Choose Assistance (v8+) from the Help menu and click the *Something unexpected is happening* link and Keyboard Maestro will tell you if there are any obvious issues. | + | Choose Interactive Help (v9+) (previously Assistance in v8) from the Help menu and click the *Something unexpected is happening* link and Keyboard Maestro will tell you if there are any obvious issues. |
| An alternative cause for this issue is [[#Secure Input Mode]]. | An alternative cause for this issue is [[#Secure Input Mode]]. | ||
| Line 99: | Line 108: | ||
| Keyboard Maestro 6 and later detects the case where the Secure Input Mode flag is left on and alerts you to the issue. | Keyboard Maestro 6 and later detects the case where the Secure Input Mode flag is left on and alerts you to the issue. | ||
| - | Choose Assistance (v8+) from the Help menu and click the *Something unexpected is happening* link and Keyboard Maestro will tell you if there are any obvious issues. | + | Choose Interactive Help (v9+) (previously Assistance in v8) from the Help menu and click the *Something unexpected is happening* link and Keyboard Maestro will tell you if there are any obvious issues. |
| A related, very unusual case is that Terminal has a Secure Keyboard Entry mode (in the Terminal menu) - if you turn that on, that may also cause problems. | A related, very unusual case is that Terminal has a Secure Keyboard Entry mode (in the Terminal menu) - if you turn that on, that may also cause problems. | ||
| Line 315: | Line 324: | ||
| Manually moving the application **in the Finder** will turn off App Translocation. Moving it by other means (eg, PathFinder, Hazel, Keyboard Maestro, whatever) will not remove translocation. | Manually moving the application **in the Finder** will turn off App Translocation. Moving it by other means (eg, PathFinder, Hazel, Keyboard Maestro, whatever) will not remove translocation. | ||
| - | Choose Assistance (v8+) from the Help menu and click the *Something unexpected is happening* link and Keyboard Maestro will tell you if there are any obvious issues. | + | Choose Interactive Help (v9+) (previously Assistance in v8) from the Help menu and click the *Something unexpected is happening* link and Keyboard Maestro will tell you if there are any obvious issues. |
| You can determine if an application is running Translocated by looking at it with the Activity Monitor. Double click on the process in the listing to inspect it, and then look at its Open Files and Ports. One of the first entries will be the application executable, and if it is being Translocated it will have a long path, something like this: | You can determine if an application is running Translocated by looking at it with the Activity Monitor. Double click on the process in the listing to inspect it, and then look at its Open Files and Ports. One of the first entries will be the application executable, and if it is being Translocated it will have a long path, something like this: | ||
Troubleshooting.txt · Last modified: 2023/10/11 00:08 by peternlewis
Page Tools
