Differences

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

--- Troubleshooting [2021/03/05 21:16]
JMichaelTX Add Intro and Icon (DRAFT 2)
+++ Troubleshooting [2021/03/06 17:42]
JMichaelTX Major rewrite of intro -- issue with ordered list
@@ Line 1: / Line 1: @@
-{{:troubleshooting-icon-small.png?nolink|}}
+{{:troubleshooting-icon-small-2.png?nolink|}}
 ====== Troubleshooting ======
-This Wiki article is intended to address situations where you find that Keyboard Maestro in general, or multiple Macros, is no longer working as it previously did, and you have no idea why.  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 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).
-Troubleshooting Keyboard Maestro is the same as troubleshooting any other Mac app.
+===== When Does the Issue First Occur =====
-* Use the same general troubleshooting steps
+**Unexpected behavior in Keyboard Maestro may occur in the following situations:**
-* If issue remains, examine issues specific to Keyboard Maestro
+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 =====
-  - 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:
+==== 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
@@ Line 16: / Line 71: @@
     - 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
+- 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 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.
+- 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 =====
@@ Line 31: / Line 88: @@
 * 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 ====
+==== 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|}}
-TBD.  FIXME
 ==== 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.

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools