Differences

This shows you the differences between two versions of the page.

--- Troubleshooting [2021/03/05 19:40]
JMichaelTX Add Sections (DRAFT 2)
+++ Troubleshooting [2021/03/06 17:42]
JMichaelTX Major rewrite of intro -- issue with ordered list
@@ Line 1: / Line 1: @@
-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).
+{{:troubleshooting-icon-small-2.png?nolink|}}
+====== Troubleshooting ======
-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!
+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 fit 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).
-===== General Issues =====
+===== When Does the Issue First Occur =====
-==== Something Unexpected is Happening ====
+**Unexpected behavior in Keyboard Maestro may occur in the following situations:**
+I am having trouble creating an ordered list, even though I'm following the instructions in the Docwiki
+  - test 1
+  - test 2
+some text
+- Immediately after you have installed Keyboard Maestro on a specific Mac.
+- Immediately after you have updated Keyboard Maestro to a new version.
+- 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.
+- After you have created a new Macro, or added new Actions, that you have not used before.
+===== General Troubleshooting =====
+==== All Situations ====
+You should try these steps for regardless of your situation, as they are most likely to either fix or at least identify the cause of the issue.
+- Restart Your Mac
+  * As with all unexpected behavior on your Mac, the first line of recovery is to restart your Mac.
+  * You will be amazed at how often this fixes the problem.
+  * Often it will be a permanent fix, but sometimes the issue will reoccur after some time
+  * Try this first, and then you only need to do more troubleshooting if the issue returns.
+- Run the __Interactive Help Wizard__ from the Keyboard Maestro Editor Help menu
+  * Choose the "Something Expected Is NOT Happening" and Keyboard Maestro will check all of the key requirements and display the results, like this:
+--- INSERT IMAGE HERE ---
+==== Situation #1 -- New Install ====
+There are several key issues that can occur immediately after you install Keyboard Maestro.\\
+Again, first Run the __Interactive Help Wizard__ from the Keyboard Maestro Editor Help menu.  Then review the specific issues below.
+- Downloading/Installing an app in a zip package from a web site (not Apple Store) may result in Apple imposed "App Translocation", which causes Keyboard Maestro to be launched improperly.
+  * If this has happened, you should see an error message something like this:\\ `AppTranslocation Security is active, this will cause problems`
+  * To fix this, see [How To Fix Translocation Problem](https://wiki.keyboardmaestro.com/assistance/Translocation_Problem)
+- Unable to Run Some Macros due to macOS Accessibility Restrictions
+  * To fix this, see [How To Fix Accessibility Permission](https://wiki.keyboardmaestro.com/assistance/Accessibility_Permission_Problem)
+- Safari is not responding to FrontBrowser Safari related Keyboard Maestro Actions
+  * To Fix, see [How To Enable Safari to Respond to KM Actions](https://forum.keyboardmaestro.com/t/safari-10-11-5-km-actions-tokens-not-working-how-to-fix/3765)
+- Google Chrome (or Chrome-based Browsers) is not responding to FrontBrowser or Chrome related Actions
+  * To fix, see [How to Enable Google Chrome to Respond to KM Actions](https://forum.keyboardmaestro.com/t/announcement-google-chrome-68-disables-km-access-how-to-fix/10969)
+==== Situation #2 -- After Update to New Version of Keyboard Maestro ====
+If Keyboard Maestro had been running fine, and then does not work as expected after an upgrade, then do the following:
+- As usual, restart your Mac.  This will likely fix the issue.
+- Run the __Interactive Help Wizard__ from the Keyboard Maestro Editor Help menu.
+- 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:
+  * Your versions of macOS and Keyboard Maestro
+  * Observed Behavior
+  * Expected Behavior
+  * Upload example Macro that produces the issue.
+==== Situation #3 --After Working Fine for a While ====
+- 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
+    - macOS updates
+    - Install of new apps, or app updates
+    - Especially any utilities (like Clipboard managers)
+    - etc
+- 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 [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.
+    - 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.
+==== Situation #4 -- After New Macros or Actions ====
+- TBD
+===== Use the Interactive Help Wizard =====
 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.
+* Choose Interactive Help (previously Assistance) from the Keyboard Maestro Editor Help menu.
+{{:wizard-initial-display.png?nolink|}}
+* Then choose one of the following:
+  * Something unexpected is happening...
+  * Something expected is _not_ happening...
+==== Something Expected is Not Happening ====
+* Click the *Something Expected is _not_ happening* link.
+{{:wizard-expected-step-1.png?nolink|}}
+Click _Continue_
+{{:wizard-expected-step-2.png?nolink|}}
+Click _Continue_
+{{:wizard-expected-step-3.png?nolink|}}
+Click _Continue_
+{{:wizard-expected-step-4.png?nolink|}}
+==== Something Unexpected is Happening ====
 * Click the *Something unexpected is happening* link.
+{{:wizard-unexpected-med.png?nolink|}}
 * 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.
+{{:wizard-unexpected-step-2.png?nolink|}}
 * If the issue remains and there are no macros being triggered, ask Support for help.
@@ Line 315: / Line 428: @@
 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).
+==== Keyboard Issues ====
+* [How to Troubleshoot Keyboard Issues ](https://forum.keyboardmaestro.com/t/how-to-troubleshoot-keyboard-issues/7544)

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools