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 [2019/03/21 18:10] JMichaelTX ADD entry for SIMBL |
Troubleshooting [2021/02/12 01:03] peternlewis ACLs |
||
|---|---|---|---|
| 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 98: | 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 108: | 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 236: | Line 236: | ||
| ==== Preference Write Failed ==== | ==== Preference Write Failed ==== | ||
| - | If Keyboard Maestro cannot write to its preferences folder, it should alert you to the problem. Alternatively, if changes you are making to macros, variables, or Named Clipboards or the like are not sticking, the problem is likely caused by incorrect ownership or permissions of the Keyboard Maestro preference folder or its contents. This most often happens after a poor migration or backup restore of the folder. | + | If Keyboard Maestro cannot write to its preferences folder, it should alert you to the problem by beeping every time you make changes to a macro. Alternatively, if changes you are making to macros, variables, or Named Clipboards or the like are not sticking, the problem is likely caused by incorrect ownership or permissions of the Keyboard Maestro preference folder or its contents. This most often happens after a poor migration or backup restore of the folder. |
| Quit Keyboard Maestro, and open the Keyboard Maestro Preferences folder - in the Finder, hold the Option key down, select the menu Go ➤ Library, then drill down into Application Support and find the Keyboard Maestro folder. | Quit Keyboard Maestro, and open the Keyboard Maestro Preferences folder - in the Finder, hold the Option key down, select the menu Go ➤ Library, then drill down into Application Support and find the Keyboard Maestro folder. | ||
| Line 243: | Line 243: | ||
| Then also look at the contents of the folder and ensure all the files and folders have the correct owners and permissions (you can select multiple files in the Finder and then hold the Option key down and choose File ➤ Show Inspector to look at all of them). Correct the ownership and permissions if necessary. | Then also look at the contents of the folder and ensure all the files and folders have the correct owners and permissions (you can select multiple files in the Finder and then hold the Option key down and choose File ➤ Show Inspector to look at all of them). Correct the ownership and permissions if necessary. | ||
| + | |||
| + | Sometimes saving preferences may fail due to a spurious access-control list (ACL), which cannot be corrected from the Finder. From the Terminal, you can check the ACL with `ls -el` and fix it with `chmod -a or -N`, for example, | ||
| + | |||
| + | ``` | ||
| + | chmod -N ~/Library/Application\ Support/Keyboard\ Maestro/Keyboard\ Maestro\ Macros.plist | ||
| + | ``` | ||
| + | |||
| + | or, in more drastic cases: | ||
| + | |||
| + | ``` | ||
| + | chmod -R -a "everyone deny delete" ~/Library/Preferences/com.stairways.* | ||
| + | chmod -R -a "everyone deny delete" ~/Library/Application\ Support/Keyboard\ Maestro | ||
| + | ``` | ||
| ==== No Palettes or Dialogs Appear ==== | ==== No Palettes or Dialogs Appear ==== | ||
| Line 324: | Line 337: | ||
| 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
