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 [2021/02/12 01:03]
peternlewis ACLs
Troubleshooting [2021/03/05 19:30]
JMichaelTX Reorganize Issue List into Sections (DRAFT)
Line 3: Line 3:
 We always respond to email, however email is no longer a guaranteed medium and spam filters can delete your message to us or our message to you.  Messages sent using the feedback form will always get to us, emails sent to us will pretty much always get to us, but if you do not receive a response within a couple business days check your spam filters to see if they have trapped our reply. ​ If you use the feedback form and want a reply, make sure you enter your email address! We always respond to email, however email is no longer a guaranteed medium and spam filters can delete your message to us or our message to you.  Messages sent using the feedback form will always get to us, emails sent to us will pretty much always get to us, but if you do not receive a response within a couple business days check your spam filters to see if they have trapped our reply. ​ If you use the feedback form and want a reply, make sure you enter your email address!
  
-{{INLINETOC 3-4}} +===== General Issues ===== 
 + 
 +==== Something Unexpected is Happening ==== 
 + 
 +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 Interactive Help (previously Assistance) from the Help menu. 
 +* Click the *Something unexpected is happening* link. 
 +* Click the *Quit the Engine* link. 
 +* If the issue remains, the problem is almost certainly unrelated to Keyboard Maestro. 
 +* Click the *Launch the Engine* link to relaunch the Keyboard Maestro Engine. 
 +* If the issue returns, check the recently executed macros which are listed in the window. 
 +* If the issue remains and there are no macros being triggered, ask Support for help. 
 + 
 + 
 +===== Macro Issues =====
  
 ==== Macros Not Firing (Triggered) ==== ==== Macros Not Firing (Triggered) ====
 +
  
 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+)
Line 33: Line 49:
  
 The macros are all enabled by the Keyboard Maestro Engine. ​ You can start it by launching the Keyboard Maestro application,​ or have the engine start automatically by enabling the “Launch Engine at Login” preference in the Keyboard Maestro General Preferences pane. The macros are all enabled by the Keyboard Maestro Engine. ​ You can start it by launching the Keyboard Maestro application,​ or have the engine start automatically by enabling the “Launch Engine at Login” preference in the Keyboard Maestro General Preferences pane.
- 
-==== Something Unexpected is Happening ==== 
- 
-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 Interactive Help (previously Assistance) from the Help menu. 
-* Click the *Something unexpected is happening* link. 
-* Click the *Quit the Engine* link. 
-* If the issue remains, the problem is almost certainly unrelated to Keyboard Maestro. 
-* Click the *Launch the Engine* link to relaunch the Keyboard Maestro Engine. 
-* If the issue returns, check the recently executed macros which are listed in the window. 
-* If the issue remains and there are no macros being triggered, ask Support for help. 
  
 ==== Run-Away Login Macros ==== ==== Run-Away Login Macros ====
Line 65: Line 69:
     - 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.
  
 +==== Macros Not Being Saved ====
  
-==== App Freezes ​(Locks upSpinning Beachball) or Other Strange Behavior due to SIMBL ====+If your macros are not being saved (ieyou make changes in Keyboard Maestro, and then quit and relaunch Keyboard Maestro and the changes are lost, and Keyboard Maestro Engine never notices any changesthen this is likely because Keyboard Maestro cannot save the macros file.  In Keyboard Maestro, choose Help -> Open Preferences Folder, and ensure that that folder is writeable and that the Keyboard Maestro Macros.plist file it contains is writeable. ​ If you're still having the problem, consider using the Disk Utility’s Fix Permissions action, and/or removing the Keyboard Maestro preferences folder, creating a new once, and moving the contents of the old one to the new one.
  
-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: +==== Timing ​Between Actions ​====
- +
-`/​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]]. +
- +
- +
-==== Timing ====+
  
 Here's a common situation: You've written your macro, you're sure you've included all the steps, but the macro fails in some way, e.g. it seems to skip steps. This is often caused by timing issues: Keyboard Maestro executes an action in the macro before the receiving program is ready for that action. ​ Here's a common situation: You've written your macro, you're sure you've included all the steps, but the macro fails in some way, e.g. it seems to skip steps. This is often caused by timing issues: Keyboard Maestro executes an action in the macro before the receiving program is ready for that action. ​
Line 88: Line 86:
 Often, adding pauses to your macro will solve the timing issues. A pause of 0.3 seconds is often enough, but in some cases (e.g. a '​Switch to application'​ action when there are many applications open and your system is running out of memory) longer pauses (several seconds) may be necessary. Often, adding pauses to your macro will solve the timing issues. A pause of 0.3 seconds is often enough, but in some cases (e.g. a '​Switch to application'​ action when there are many applications open and your system is running out of memory) longer pauses (several seconds) may be necessary.
  
-==== Typed String Triggers Not Working ​====+===== Action Issues =====
  
-See [Not Being Able To Enter a Hot Key](#​Not_Being_Able_To_Enter_a_Hot_Key).+==== Sometimes Typing in Password Fields Drops Characters ====
  
-==== Not Being Able To Enter Hot Key ====+When Keyboard Maestro simulates ​keystroke, it simulates both the press and the release. ​ If the key is already being held down by you (eg because you pressed the key as a trigger), then Keyboard Maestro notices this, and first releases the key, and then presses and releases the key.
  
-If Typed String triggers are not working, or if you try to create ​hot key and find that when you select ​the hot key it turns blue, but then when you type keystroke ​it is not noticedthen there are two possible causes.+Howeverin a password field (or any time Secure Input is enabled), Keyboard Maestro and other applications cannot see the state of the keyboard (for obvious security reasons). ​ Because of this, Keyboard Maestro does not know that you are still holding down a key and therefore cannot know to release it.  So if it tries to simulate ​the same key that you are holding down, in password field, ​it will still simulate the press and release, but because the key is already held downthe press will not do anything and the keystroke will be lost.
  
-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 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 Macso check that panel closely.+This happens most commonly ​when you have a hot key trigger with the same key (eg Control-T) ​as a key you want to type in to a password field (eg "Hello there"​).  ​Because it is a password field, the only indication will be a missing bullet (•) (so ten instead ​of 11 bullets) and then an "​invalid password"​ errorwhich makes this problem hard do diagnose 
  
-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]]. 
  
-==== Secure Input Mode ==== +===== Clipboard Issues ​=====
- +
-Mac OS X will not let applications watch the keyboard when you are in a password field (to prevent hackers getting hold of your passwords). ​ However, the system can sometimes get into a state where it thinks it is permanently in a password fields. ​ Almost anything that asks for a password could cause the problem (eg, 1Password extension, VPN connections,​ Mail, etc).  Quitting the appropriate affected application or restarting will resolve the issue (until it reappears). Terminal has a Secure Keyboard Entry mode, as does Webroot SecureAnywhere by default. +
- +
-Keyboard Maestro 6 and later detects the case where the Secure Input Mode flag is left on and alerts you to the issue. +
- +
-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. +
- +
-And a final new cause for this may be Parallels Version 8, which apparently can interfere with the keyboard event queue and/or hot keys.  Restarting Parallels may help. +
- +
-There is a [[https://​forum.keyboardmaestro.com/​t/​disable-secure-input/​2410|forum topic]] on the subject and the Smile Software folks have a [very good page](http://​smilesoftware.com/​textexpander/​secureinput.html) on this subject (as it affects TextExpander similarly to Keyboard Maestro) which lists a lot of possible causes. +
- +
-Note that there is nothing Keyboard Maestro can do to “work around” Secure Input Mode - it is a system security feature that has been erroneously left on.  Keyboard Maestro can detect and report it, but it can no more work around the problem that it could bipass any other security features of Mac OS X. +
- +
-As of 7.1+, Keyboard Maestro will tell you if it detects the system is in Secure Input Mode and if possible indicate the process which is causing the issue in the Keyboard Maestro status menu or by clicking the yellow warning triangle in the bottom right corner of the Keyboard Maestro editor. ​ For older versions, there is a [[https://​forum.keyboardmaestro.com/​t/​keyboard-maestro-find-app-with-secure-input-macro/​2504|macro to find the offending app]] on the forum. +
- +
- +
-==== Macros Not Being Saved ==== +
- +
-If your macros are not being saved (ie, you make changes in Keyboard Maestro, and then quit and relaunch Keyboard Maestro and the changes are lost, and Keyboard Maestro Engine never notices any changes) then this is likely because Keyboard Maestro cannot save the macros file.  In Keyboard Maestro, choose Help -> Open Preferences Folder, and ensure that that folder is writeable and that the Keyboard Maestro Macros.plist file it contains is writeable. ​ If you're still having the problem, consider using the Disk Utility’s Fix Permissions action, and/or removing the Keyboard Maestro preferences folder, creating a new once, and moving the contents of the old one to the new one. +
- +
-==== Not Working With Parallels ==== +
- +
-In Parallels, make sure the ”Enabled Mac OS X system shortcuts” preference is enabled, which will ensure Parallels reads the keyboard from the keyboard queue. +
- +
-==== The Case of the Vanishing Insertion Cursor in Mail ==== +
- +
-When I hide Mail, and then show it later, the insertion cursor has disappeared,​ what’s up with that? +
- +
-Congratulations,​ you have found a bug, but it is a bug in Mac OS X and/or Mail.  You can reproduce this vanishing insertion cursor without Keyboard Maestro by quitting Keyboard Maestro and the Keyboard Maestro Engine, switch to Mail, create a new Mail message, with the insertion point blinking away.  Command-Tab to the Finder, then Command-Tab,​ select Mail, press H to hide it, select the Finder. ​ Then Command-Tab,​ select Mail. You can now type, but there is no insertion point. ​ Switching the front two windows twice restores the cursor. +
- +
-But, aha!  You have Keyboard Maestro! ​ Why do something manually when you can automate the process. ​ Make a macro that is triggered when you activate Mail, with actions: +
- +
-* Bring Window With Index 2 to Front +
-* Bring Window With Index 2 to Front +
- +
-Problem solved until Apple get around to fixing the issue. ​ This bug in Mail appears to be resolved in Yosemite. +
- +
-==== Scripts Are Not Working Because the Path is Wrong When Executed in Keyboard Maestro ==== +
- +
-In essence, the _default_ path in a Keyboard Maestro Execute Shell Script is **nothing**,​ since Keyboard Maestro executes scripts using the bash shell in non-interactive mode. +
- +
-To learn how to set a path in a Keyboard Maestro Execute Shell Script Action, see  +
-[[action:​Execute_a_Shell_Script#​Path_in_Shell_Scripts|Execute a Shell Script]]+
  
 ==== Sometimes the Wrong Thing is Pasted ==== ==== Sometimes the Wrong Thing is Pasted ====
Line 189: Line 140:
 * Explicitly specify the actions and add an explicit Pause. Eg, Command-C, Pause 1 Second, Set Named Clipboard to Current Clipboard. * Explicitly specify the actions and add an explicit Pause. Eg, Command-C, Pause 1 Second, Set Named Clipboard to Current Clipboard.
 * Increase the inbuilt pause after a Command key is simulated (see the [Preferences](http://​www.keyboardmaestro.com/​documentation/​5/​preferences.html) section of the documentation). * Increase the inbuilt pause after a Command key is simulated (see the [Preferences](http://​www.keyboardmaestro.com/​documentation/​5/​preferences.html) section of the documentation).
- 
-==== Sometimes Typing in Password Fields Drops Characters ==== 
- 
-When Keyboard Maestro simulates a keystroke, it simulates both the press and the release. ​ If the key is already being held down by you (eg because you pressed the key as a trigger), then Keyboard Maestro notices this, and first releases the key, and then presses and releases the key. 
- 
-However, in a password field (or any time Secure Input is enabled), Keyboard Maestro and other applications cannot see the state of the keyboard (for obvious security reasons). ​ Because of this, Keyboard Maestro does not know that you are still holding down a key and therefore cannot know to release it.  So if it tries to simulate the same key that you are holding down, in a password field, it will still simulate the press and release, but because the key is already held down, the press will not do anything and the keystroke will be lost. 
- 
-This happens most commonly when you have a hot key trigger with the same key (eg Control-T) as a key you want to type in to a password field (eg "Hello there"​). ​ Because it is a password field, the only indication will be a missing bullet (•) (so ten instead of 11 bullets) and then an "​invalid password"​ error, which makes this problem hard do diagnose.  ​ 
  
 ==== Removing Styles Changes The Text ==== ==== Removing Styles Changes The Text ====
Line 233: Line 176:
     Set Clipboard to Styled Text %CurrentClipboard%     Set Clipboard to Styled Text %CurrentClipboard%
     Filter Clipboard: Remove Styles     Filter Clipboard: Remove Styles
 +
 +
 +
 +===== Keyboard Maestro App Issues =====
 +
 +==== 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]].
 +
 +==== Secure Input Mode ====
 +
 +Mac OS X will not let applications watch the keyboard when you are in a password field (to prevent hackers getting hold of your passwords). ​ However, the system can sometimes get into a state where it thinks it is permanently in a password fields. ​ Almost anything that asks for a password could cause the problem (eg, 1Password extension, VPN connections,​ Mail, etc).  Quitting the appropriate affected application or restarting will resolve the issue (until it reappears). Terminal has a Secure Keyboard Entry mode, as does Webroot SecureAnywhere by default.
 +
 +Keyboard Maestro 6 and later detects the case where the Secure Input Mode flag is left on and alerts you to the issue.
 +
 +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.
 +
 +And a final new cause for this may be Parallels Version 8, which apparently can interfere with the keyboard event queue and/or hot keys.  Restarting Parallels may help.
 +
 +There is a [[https://​forum.keyboardmaestro.com/​t/​disable-secure-input/​2410|forum topic]] on the subject and the Smile Software folks have a [very good page](http://​smilesoftware.com/​textexpander/​secureinput.html) on this subject (as it affects TextExpander similarly to Keyboard Maestro) which lists a lot of possible causes.
 +
 +Note that there is nothing Keyboard Maestro can do to “work around” Secure Input Mode - it is a system security feature that has been erroneously left on.  Keyboard Maestro can detect and report it, but it can no more work around the problem that it could bypass any other security features of Mac OS X.
 +
 +As of 7.1+, Keyboard Maestro will tell you if it detects the system is in Secure Input Mode and if possible indicate the process which is causing the issue in the Keyboard Maestro status menu or by clicking the yellow warning triangle in the bottom right corner of the Keyboard Maestro editor. ​ For older versions, there is a [[https://​forum.keyboardmaestro.com/​t/​keyboard-maestro-find-app-with-secure-input-macro/​2504|macro to find the offending app]] on the forum.
  
 ==== Preference Write Failed ==== ==== Preference Write Failed ====
Line 256: Line 229:
 chmod -R -a "​everyone deny delete" ​ ~/​Library/​Application\ Support/​Keyboard\ Maestro chmod -R -a "​everyone deny delete" ​ ~/​Library/​Application\ Support/​Keyboard\ Maestro
 ``` ```
 +
 +==== App Translocation Security ====
 +
 +To resolve App Translocation,​ in the Finder, move the Keyboard Maestro.app anywhere (the /​Applications folder is generally the best place for it).
 +
 +In macOS Sierra, Apple added a strange security feature called App Translocation (sometimes known as Gatekeeper Path Randomization) which means that after downloading an application,​ if you do not move the resulting application somewhere (anywhere!),​ the application will be run as if it is located at a randomly chosen path by the system. ​ The consequence of this is that Launch Engine at Login will not work (because the Keyboard Maestro Engine will have a random, different, path each time), and version updates will fail (because Keyboard Maestro cannot replace itself).
 +
 +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 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:
 +
 +''/​private/​var/​folders/​9t/​ld0kwsdn6mx13x87bw01bh_w0000gn/​T/​AppTranslocation/​A5CA1CC2-10E0-4DD2-9962-7E484D2CFFED/​d/​Keyboard Maestro.app/​Contents/​MacOS/​Keyboard Maestro''​
 +
 +If you still cannot get the flag removed, you can use the Terminal command:
 +
 +    xattr -dr com.apple.quarantine "/​Applications/​Keyboard Maestro.app"​
 +
 +assuming that `Keyboard Maestro.app` is in the Applications folder.
 +
 +
 +
 +===== Palette Issues =====
  
 ==== No Palettes or Dialogs Appear ==== ==== No Palettes or Dialogs Appear ====
Line 266: Line 263:
  
 If you wish to briefly hide all the palettes (eg while watching a video), you can use the [Conceal Macro Palettes until Application Switch](https://​wiki.keyboardmaestro.com/​action/​Conceal_Macro_Palettes) action. If you wish to briefly hide all the palettes (eg while watching a video), you can use the [Conceal Macro Palettes until Application Switch](https://​wiki.keyboardmaestro.com/​action/​Conceal_Macro_Palettes) action.
-==== The Select Menu Item Action Is Not Working in Photoshop, Finale or Another Application ==== 
- 
-Cross platform apps, including often Adobe apps, and Finale, do not necessarily update or even build their menu bar until the menu is selected with the mouse. ​ When asked for the menus via the accessibility subsystem, the menus are either not there, or not currently correctly built for the context (eg, menus may be disabled or invisible when they should not be). 
- 
-Options to force the application into updating its menus include: 
- 
-* Switch out and back to the application,​ and then use the Select Menu Item action. 
-* Simulate a click in the menu bar, and then use the Select Menu Item action. 
-* Desperate measures, simulate a click in the menu bar, and then use arrows and typeahead (Insert Text by Typing) to select the menu item. 
- 
-Often, simulating a click in the menu bar to the right of the Help menu will be sufficient to cause the menus to be rebuild. 
  
 ==== White Menus or White Switchers or Palettes ==== ==== White Menus or White Switchers or Palettes ====
Line 286: Line 272:
  
 This issue appears to have been resolved in 10.9.3 and later. This issue appears to have been resolved in 10.9.3 and later.
 +
 +
 +
 +===== Trigger Issues =====
 +
 +==== Typed String Triggers Not Working ====
 +
 +See [Not Being Able To Enter a Hot Key](#​Not_Being_Able_To_Enter_a_Hot_Key).
 +
 +==== Not Being Able To Enter a Hot Key ====
 +
 +If Typed String triggers are not working, or if you try to create a hot key and find that when you select the hot key it turns blue, but then when you type a keystroke it is not noticed, then there are two possible causes.
 +
 +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 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]].
 +
 +
 +
 +===== Script Issues =====
 +
 +==== Execute Script Actions are Not Working ====
 +
 +Your variables are sent to your scripts by placing them in environment variables. However, the total size of the environment variables is 256k.  Therefore if the total size of your variables exceeds about 256k scripts will stop working. ​ Adjust your variables to reduce the total size.
 +
 +
 +
 +==== Scripts Are Not Working Because the Path is Wrong When Executed in Keyboard Maestro ====
 +
 +In essence, the _default_ path in a Keyboard Maestro Execute Shell Script is **nothing**,​ since Keyboard Maestro executes scripts using the bash shell in non-interactive mode.
 +
 +To learn how to set a path in a Keyboard Maestro Execute Shell Script Action, see 
 +[[action:​Execute_a_Shell_Script#​Path_in_Shell_Scripts|Execute a Shell Script]]
 +
 +
 +
 +===== User Interface Issues =====
  
 ==== Stuck Modifiers Keys and Wacom Drivers ==== ==== Stuck Modifiers Keys and Wacom Drivers ====
  
 It appears that recent versions of Wacom’s drivers can result in stuck modifier keys (Option, Shift, Command, Control) when used with Keyboard Maestro, either when pressing hot keys or when Keyboard Maestro is simulating keystrokes. ​ See the forum post [Keyboard misbehavior triggered by...?​](https://​forum.keyboardmaestro.com/​t/​keyboard-misbehavior-triggered-by/​4481/​34). It appears that recent versions of Wacom’s drivers can result in stuck modifier keys (Option, Shift, Command, Control) when used with Keyboard Maestro, either when pressing hot keys or when Keyboard Maestro is simulating keystrokes. ​ See the forum post [Keyboard misbehavior triggered by...?​](https://​forum.keyboardmaestro.com/​t/​keyboard-misbehavior-triggered-by/​4481/​34).
 +
 +
 +
 +===== Issues with Other Apps =====
 +
 +==== The Case of the Vanishing Insertion Cursor in Mail ====
 +
 +When I hide Mail, and then show it later, the insertion cursor has disappeared,​ what’s up with that?
 +
 +Congratulations,​ you have found a bug, but it is a bug in Mac OS X and/or Mail.  You can reproduce this vanishing insertion cursor without Keyboard Maestro by quitting Keyboard Maestro and the Keyboard Maestro Engine, switch to Mail, create a new Mail message, with the insertion point blinking away.  Command-Tab to the Finder, then Command-Tab,​ select Mail, press H to hide it, select the Finder. ​ Then Command-Tab,​ select Mail. You can now type, but there is no insertion point. ​ Switching the front two windows twice restores the cursor.
 +
 +But, aha!  You have Keyboard Maestro! ​ Why do something manually when you can automate the process. ​ Make a macro that is triggered when you activate Mail, with actions:
 +
 +* Bring Window With Index 2 to Front
 +* Bring Window With Index 2 to Front
 +
 +Problem solved until Apple get around to fixing the issue. ​ This bug in Mail appears to be resolved in Yosemite.
 +
 +
 +==== The Select Menu Item Action Is Not Working in Photoshop, Finale or Another Application ====
 +
 +Cross platform apps, including often Adobe apps, and Finale, do not necessarily update or even build their menu bar until the menu is selected with the mouse. ​ When asked for the menus via the accessibility subsystem, the menus are either not there, or not currently correctly built for the context (eg, menus may be disabled or invisible when they should not be).
 +
 +Options to force the application into updating its menus include:
 +
 +* Switch out and back to the application,​ and then use the Select Menu Item action.
 +* Simulate a click in the menu bar, and then use the Select Menu Item action.
 +* Desperate measures, simulate a click in the menu bar, and then use arrows and typeahead (Insert Text by Typing) to select the menu item.
 +
 +Often, simulating a click in the menu bar to the right of the Help menu will be sufficient to cause the menus to be rebuild.
  
 ==== Google Chrome Actions are Not Working ==== ==== Google Chrome Actions are Not Working ====
Line 307: Line 362:
 An alternative cause can be because the actions work by executing the AppleScript via a osascript, and it is possible for all [[#Execute Script Actions are Not Working]]. An alternative cause can be because the actions work by executing the AppleScript via a osascript, and it is possible for all [[#Execute Script Actions are Not Working]].
  
-==== Safari Actions are Not Working ===+==== Safari Actions are Not Working ​====
  
 The Safari (and Chrome) actions work by making AppleScript requests. The Safari (and Chrome) actions work by making AppleScript requests.
Line 316: Line 371:
 * Enable *Allow JavaScript from Apple Events* in the Develop menu. * Enable *Allow JavaScript from Apple Events* in the Develop menu.
  
-==== Execute Script Actions are Not Working ==== 
- 
-Your variables are sent to your scripts by placing them in environment variables. However, the total size of the environment variables is 256k.  Therefore if the total size of your variables exceeds about 256k scripts will stop working. ​ Adjust your variables to reduce the total size. 
- 
-==== Yosemite GM and Accessibility Settings Problems ==== 
 ==== Yosemite and Accessibility Settings Problems ==== ==== Yosemite and Accessibility Settings Problems ====
  
Line 329: Line 379:
 If you must stay on version 10.10.0-2 for any reason, see the forum topic on [possible solutions](http://​forum.keyboardmaestro.com/​t/​yosemite-accessibility-permission-problems/​541/​18). If you must stay on version 10.10.0-2 for any reason, see the forum topic on [possible solutions](http://​forum.keyboardmaestro.com/​t/​yosemite-accessibility-permission-problems/​541/​18).
  
-==== App Translocation Security ==== 
  
-To resolve App Translocation,​ in the Finder, move the Keyboard Maestro.app anywhere (the /​Applications folder is generally the best place for it). 
  
-In macOS Sierra, Apple added a strange security feature called App Translocation (sometimes known as Gatekeeper Path Randomization) which means that after downloading an application,​ if you do not move the resulting application somewhere (anywhere!),​ the application will be run as if it is located at a randomly chosen path by the system. ​ The consequence of this is that Launch Engine at Login will not work (because the Keyboard Maestro Engine will have a random, different, path each time), and version updates will fail (because Keyboard Maestro cannot replace itself).+===== macOS Issues =====
  
-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 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.+===== Virtual Machine 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:+==== Not Working With Parallels ====
  
-''/​private/​var/​folders/​9t/​ld0kwsdn6mx13x87bw01bh_w0000gn/​T/​AppTranslocation/​A5CA1CC2-10E0-4DD2-9962-7E484D2CFFED/​d/​Keyboard Maestro.app/​Contents/​MacOS/​Keyboard Maestro''​+In Parallels, make sure the ”Enabled Mac OS X system shortcuts” preference is enabled, which will ensure Parallels reads the keyboard from the keyboard queue.
  
-If you still cannot get the flag removed, you can use the Terminal command: 
  
-    xattr -dr com.apple.quarantine "/​Applications/​Keyboard Maestro.app"​ 
  
-assuming that `Keyboard Maestro.app` is in the Applications folder.+===== Other Issues =====
  
 ==== Other troubleshooting information ==== ==== Other troubleshooting information ====
  
 See also the [Troubleshooting page](http://​www.keyboardmaestro.com/​documentation/​6/​troubleshooting.html) of the Keyboard Maestro documentation and [Philippe Martin’s Debugging Macros](http://​flipmartin.net/​software/​tips-and-tricks-for-keyboard-maestro#​dbg) section of his extensive [Tips & Tricks for Keyboard Maestro](http://​flipmartin.net/​software/​tips-and-tricks-for-keyboard-maestro) article. See also the [Troubleshooting page](http://​www.keyboardmaestro.com/​documentation/​6/​troubleshooting.html) of the Keyboard Maestro documentation and [Philippe Martin’s Debugging Macros](http://​flipmartin.net/​software/​tips-and-tricks-for-keyboard-maestro#​dbg) section of his extensive [Tips & Tricks for Keyboard Maestro](http://​flipmartin.net/​software/​tips-and-tricks-for-keyboard-maestro) article.
 +
Troubleshooting.txt · Last modified: 2023/10/11 00:08 by peternlewis