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 | ||
|
Troubleshooting [2023/10/11 00:02] peternlewis |
Troubleshooting [2024/06/04 22:50] (current) peternlewis |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Troubleshooting ====== | ====== Troubleshooting ====== | ||
| - | This Wiki article is intended to address situations where you find that Keyboard Maestro does not work as you expect, or works in an unexpected way, and you have been unable to identify the cause and fix it. This article aims to help you resolve this issue and make Keyboard Maestro work as you intend. This article does _not_ address _how to_ questions (please post those to the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]). | + | This Wiki article is intended to address situations where you find that Keyboard Maestro does not work as you expect, or works in an unexpected way, and you have been unable to identify the cause and fix it. This article aims to help you resolve this issue and make Keyboard Maestro work as you intend. This article does _not_ address _how to_ questions (please post those to the [[/Forum|Keyboard Maestro Forum]]). |
| ===== When Does the Issue First Occur ===== | ===== When Does the Issue First Occur ===== | ||
| Line 44: | Line 44: | ||
| ==== Situation #2 -- After a System Update ==== | ==== Situation #2 -- After a System Update ==== | ||
| + | |||
| + | If Keyboard Maestro had been running fine, and then does not work as expected after upgrading macOS: | ||
| 1. Immediately after a system update, it is wise to Restart an additional time. Many times we have found the system to not be in a totally stable state after an update, and a Restart gives a clean fresh start. | 1. Immediately after a system update, it is wise to Restart an additional time. Many times we have found the system to not be in a totally stable state after an update, and a Restart gives a clean fresh start. | ||
| Line 56: | Line 58: | ||
| 1. As usual, restart your Mac. This will likely fix the issue. | 1. As usual, restart your Mac. This will likely fix the issue. | ||
| 1. Run the _Interactive Help Wizard_ from the Keyboard Maestro Editor Help menu. | 1. Run the _Interactive Help Wizard_ from the Keyboard Maestro Editor Help menu. | ||
| - | 1. If the issue persists, then you _may_ have found a bug. To confirm and get feedback for possible workarounds, post your issue in the [Keyboard Maestro Forum](https://forum.keyboardmaestro.com/). Be sure to provide: | + | 1. If the issue persists, then you _may_ have found a bug. To confirm and get feedback for possible workarounds, post your issue in the [[/Forum|Keyboard Maestro Forum]]. Be sure to provide: |
| 1. Your versions of macOS and Keyboard Maestro. | 1. Your versions of macOS and Keyboard Maestro. | ||
| 1. Observed Behavior. | 1. Observed Behavior. | ||
| Line 78: | Line 80: | ||
| 1. If that does not help, then you can search (using the Browser Find menu) the below Keyboard Maestro specific issues to find one or more that relates to your situation. | 1. If that does not help, then you can search (using the Browser Find menu) the below Keyboard Maestro specific issues to find one or more that relates to your situation. | ||
| - | ==== Situation #5 -- After New Macros or Actions ==== | + | ==== Situation #5 -- If a Macro “Does Nothing” ==== |
| + | |||
| + | 1. The issue is most likely caused by improper macro activation. | ||
| + | 1. Use the Interactive Help in the Help menu to determine if the macro is active. | ||
| + | 1. It will also show you if the macro triggers. | ||
| + | 1. If it triggers, it might be a problem with your actions, see the next section. | ||
| + | |||
| + | ==== Situation #6 -- After New Macros or Actions ==== | ||
| 1. The issue is most likely caused by improper use of the Action. | 1. The issue is most likely caused by improper use of the Action. | ||
| 1. Click on the _Gear_ popup menu at the top right of the Action, and select _Help_ to get detailed help from the Wiki. | 1. Click on the _Gear_ popup menu at the top right of the Action, and select _Help_ to get detailed help from the Wiki. | ||
| - | 1. If the previous Action was a command to an app, then you may need a short _Pause_ after that Action. | + | 1. If the previous Action was a command to an app, changed the window or focus, then you may need a short _Pause_ after that Action. |
| - | 1. If you still can't resolve the issue, then submit a topic to the [Keyboard Maestro Forum](https://forum.keyboardmaestro.com/). Please read [Tip: How Do I Get The Best Answer in the Shortest Time?](https://forum.keyboardmaestro.com/t/tip-how-do-i-get-the-best-answer-in-the-shortest-time/10797) | + | 1. If the action might be failing, first ensure the the Keyboard Maestro Engine can display notification (otherwise it might be telling you the action is failing and you are not seeing it). |
| + | 1. You can also check for any errors reported in the Log file. Choose Open Logs Folder from the Help menu and you can see anything reported in the Engine.log file that might indicate a problem - this will also confirm that the macro is triggering - if not, check out the previous section for answers related to that. | ||
| + | 1. If you still can't resolve the issue, then submit a topic to the [[/Forum|Keyboard Maestro Forum]]. Please read [Tip: How Do I Get The Best Answer in the Shortest Time?](https://forum.keyboardmaestro.com/t/tip-how-do-i-get-the-best-answer-in-the-shortest-time/10797) | ||
| ===== Use the Interactive Help Wizard ===== | ===== Use the Interactive Help Wizard ===== | ||
| Line 165: | Line 176: | ||
| 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 [[action:Activate_a_Specific_Application|Activate a Specific 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 [[action:Activate_a_Specific_Application|Activate a Specific Application]] action when there are many applications open and your system is running out of memory) longer pauses (several seconds) may be necessary. | ||
| - | ===== Action Issues ===== | + | ===== Typing Issues ===== |
| ==== Sometimes Typing in Password Fields Drops Characters ==== | ==== Sometimes Typing in Password Fields Drops Characters ==== | ||
| Line 185: | Line 196: | ||
| You can slow the typing down by using Set Action Delay action (https://wiki.keyboardmaestro.com/action/Set_Action_Delay) to increase the delay for normal typing. Only do it for the current macro (not permanently) since this issue is relatively rare, and generally only applies to certain apps or fields. | You can slow the typing down by using Set Action Delay action (https://wiki.keyboardmaestro.com/action/Set_Action_Delay) to increase the delay for normal typing. Only do it for the current macro (not permanently) since this issue is relatively rare, and generally only applies to certain apps or fields. | ||
| + | ==== Everything is lowercase in remote desktops/virtual machines ==== | ||
| + | |||
| + | Yes, unfortunately these types of environments seem to miss the shift key and the consequential uppercasing of lettings and symbols. | ||
| ===== Clipboard Issues ===== | ===== Clipboard Issues ===== | ||
| Line 457: | Line 471: | ||
| 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. | 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. | ||
| - | |||
| - | |||
| ===== Other Issues ===== | ===== Other Issues ===== | ||
Troubleshooting.1696996947.txt.gz · Last modified: 2023/10/11 00:02 by peternlewis
Page Tools
