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 [2021/05/29 19:02] JMichaelTX ADD internal links to Situations |
Troubleshooting [2021/11/01 06:00] peternlewis |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | {{:troubleshooting-icon-small-2.png?nolink|}} | ||
| ====== 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 intended. This article does _not_ address _how to_ questions (please post those to the 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 [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]). |
| ===== When Does the Issue First Occur ===== | ===== When Does the Issue First Occur ===== | ||
| Line 10: | Line 9: | ||
| 1. Immediately after you have installed Keyboard Maestro on a specific Mac -- See [[#Situation_1_--_New_Install|Situation #1]]. | 1. Immediately after you have installed Keyboard Maestro on a specific Mac -- See [[#Situation_1_--_New_Install|Situation #1]]. | ||
| 2. Immediately after you have updated Keyboard Maestro to a new version -- See [[#Situation_2_--_After_Update_to_New_Version_of_Keyboard_Maestro|Situation #2]]. | 2. Immediately after you have updated Keyboard Maestro to a new version -- See [[#Situation_2_--_After_Update_to_New_Version_of_Keyboard_Maestro|Situation #2]]. | ||
| - | 3. Keyboard Maestro's behavior changes unexpectedly, and without apparent cause, some time (say a week or more) after it has been running as expected without any issues -- See [[#Situation_3_--_After_Working_Fine_for_a_While|Situation #3]]. | + | 3. Keyboard Maestro’s behavior changes unexpectedly, and without apparent cause, some time (say a week or more) after it has been running as expected without any issues -- See [[#Situation_3_--_After_Working_Fine_for_a_While|Situation #3]]. |
| 4. After you have created a new Macro, or added new Actions, that you have not used before -- See [[#Situation_4_--_After_New_Macros_or_Actions|Situation #4]]. | 4. After you have created a new Macro, or added new Actions, that you have not used before -- See [[#Situation_4_--_After_New_Macros_or_Actions|Situation #4]]. | ||
| Line 21: | Line 20: | ||
| 1. **Restart Your Mac** | 1. **Restart Your Mac** | ||
| 1. As with all unexpected behavior on your Mac, the first line of recovery is to restart your Mac. | 1. As with all unexpected behavior on your Mac, the first line of recovery is to restart your Mac. | ||
| - | 1. You will be amazed at how often this fixes the problem. | ||
| 1. Often it will be a permanent fix, but sometimes the issue will reoccur after some time | 1. Often it will be a permanent fix, but sometimes the issue will reoccur after some time | ||
| 1. Try this first, and then you only need to do more troubleshooting if the issue returns. | 1. Try this first, and then you only need to do more troubleshooting if the issue returns. | ||
| 1. **Run the [[Troubleshooting#Use_the_Interactive_Help_Wizard|Interactive Help Wizard]] from the Keyboard Maestro Editor Help menu** | 1. **Run the [[Troubleshooting#Use_the_Interactive_Help_Wizard|Interactive Help Wizard]] from the Keyboard Maestro Editor Help menu** | ||
| - | 1. Choose the "Something Expected Is NOT Happening" | + | 1. Choose the “Something expected is not happening” or “Something unexpected is happening” |
| 1. Keyboard Maestro will check all of the key requirements and display the results, like this: | 1. Keyboard Maestro will check all of the key requirements and display the results, like this: | ||
| {{ :wizard-expected-status-results.png?nolink |}} | {{ :wizard-expected-status-results.png?nolink |}} | ||
| + | 1. See [[Troubleshooting#Run-Away_Login_Macros|Options for Launching Keyboard Maestro Editor]] | ||
| 3. **More Help From Apple**\\ | 3. **More Help From Apple**\\ | ||
| [If an app freezes or quits unexpectedly on Mac - Apple Support](https://support.apple.com/guide/mac-help/if-an-app-freezes-or-quits-unexpectedly-mchlp2579/10.14/mac/10.14) | [If an app freezes or quits unexpectedly on Mac - Apple Support](https://support.apple.com/guide/mac-help/if-an-app-freezes-or-quits-unexpectedly-mchlp2579/10.14/mac/10.14) | ||
Troubleshooting.txt · Last modified: 2023/10/11 00:08 by peternlewis
Page Tools
