User Tools

Site Tools


Troubleshooting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision Both sides next revision
Troubleshooting [2019/09/17 23:00]
peternlewis
Troubleshooting [2021/02/12 01:03]
peternlewis ACLs
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 ====
Troubleshooting.txt · Last modified: 2023/10/11 00:08 by peternlewis