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/03/05 20:09] JMichaelTX ADD Intro section (DRAFT 1) |
Troubleshooting [2021/03/05 23:38] JMichaelTX ADD Screenshots for Wizard |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | {{:troubleshooting-icon-small-2.png?nolink|}} | ||
| ====== Troubleshooting ====== | ====== Troubleshooting ====== | ||
| Line 9: | Line 10: | ||
| ===== General Troubleshooting ===== | ===== General Troubleshooting ===== | ||
| - | - If Keyboard Maestro has been working well, as expected, for a while (let's say a week or more), and then it suddenly behaves in an unexpected manner, then most likely that is due to something that has recently changes. So, ask yourself what has changed: | + | - If Keyboard Maestro has been working well, as expected, for a while (let's say a week or more), and then it suddenly behaves in an unexpected manner, then most likely that is due to something that has recently changed. So, ask yourself what has changed: |
| - Keyboard Maestro update | - Keyboard Maestro update | ||
| - macOS updates | - macOS updates | ||
| - | - install of new apps, or app updates | + | - Install of new apps, or app updates |
| - Especially any utilities (like Clipboard managers) | - Especially any utilities (like Clipboard managers) | ||
| - etc | - etc | ||
| - If you identify a recent change, then you need to determine if that is causing the issue with Keyboard Maestro | - If you identify a recent change, then you need to determine if that is causing the issue with Keyboard Maestro | ||
| - | - The best way to do this is to try [Start up your Mac in safe mode](https://support.apple.com/guide/mac-help/start-up-your-mac-in-safe-mode-mh21245/mac). | + | - The best way to do this is to [Start up your Mac in safe mode](https://support.apple.com/guide/mac-help/start-up-your-mac-in-safe-mode-mh21245/mac). |
| + | - This will prevent all start-up items from starting. | ||
| - Then launch KM and test your macros. | - Then launch KM and test your macros. | ||
| - If they work fine then it is that change that is causing the problem. | - If they work fine then it is that change that is causing the problem. | ||
| + | - If this does not resolve your issue, then try using the Keyboard Maestro built-in _Interactive Help Wizard_. | ||
| + | - 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. | ||
| + | ===== Use the Interactive Help Wizard ===== | ||
| - | For more information about a specific Keyboard Maestro feature consult the [Keyboard Maestro Documentation](http://documentation.keyboardmaestro.com), post a question to the [Keyboard Maestro Forum](http://forum.keyboardmaestro.com), visit the [Keyboard Maestro web site](http://www.keyboardmaestro.com) or [this wiki](http://wiki.keyboardmaestro.com) or [contact_us](http://contact.stairways.com). | + | 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+) |
| - | 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! | + | * Choose Interactive Help (previously Assistance) from the Keyboard Maestro Editor Help menu. |
| + | * Then choose one of the following: | ||
| + | * Something unexpected is happening... | ||
| + | * Something expected is _not_ happening... | ||
| - | ===== General Issues ===== | + | ==== Something Expected is __Not__ Happening ==== |
| + | |||
| + | TBD. FIXME | ||
| ==== Something Unexpected is Happening ==== | ==== 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 *Something unexpected is happening* link. | ||
| + | |||
| + | {{:wizard-unexpected-med.png?nolink|}} | ||
| + | |||
| * Click the *Quit the Engine* link. | * Click the *Quit the Engine* link. | ||
| * If the issue remains, the problem is almost certainly unrelated to Keyboard Maestro. | * 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. | * 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 returns, check the recently executed macros which are listed in the window. | ||
| + | |||
| + | {{:wizard-unexpected-step-2.png?nolink|}} | ||
| + | |||
| * If the issue remains and there are no macros being triggered, ask Support for help. | * If the issue remains and there are no macros being triggered, ask Support for help. | ||
Troubleshooting.txt · Last modified: 2024/06/04 22:50 by peternlewis
Page Tools
