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:08] 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 58: | 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 80: | 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 ===== | ||
Troubleshooting.1696997328.txt.gz · Last modified: 2023/10/11 00:08 by peternlewis
Page Tools
