Differences

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

--- Troubleshooting [2021/03/05 19:30]
JMichaelTX Reorganize Issue List into Sections (DRAFT)
+++ Troubleshooting [2021/03/05 21:16]
JMichaelTX Add Intro and Icon (DRAFT 2)
@@ 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.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 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).
-===== General Issues =====
+Troubleshooting Keyboard Maestro is the same as troubleshooting any other Mac app.
-==== Something Unexpected is Happening ====
+* Use the same general troubleshooting steps
+* If issue remains, examine issues specific to Keyboard Maestro
+===== 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:
+    - 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.
+===== 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.
+* Then choose one of the following:
+  * Something unexpected is happening...
+  * Something expected is _not_ happening...
+==== Something Expected is _Not_ Happening ====
+TBD.  FIXME
+==== Something Unexpected is Happening ====
 * Click the *Something unexpected is happening* link.
 * Click the *Quit the Engine* link.
@@ Line 315: / Line 346: @@
 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)
@@ Line 370: / Line 405: @@
 * Enable the Develop menu in Safari if not already enabled in Safari’s Advanced preferences.
 * Enable *Allow JavaScript from Apple Events* in the Develop menu.
+===== macOS Issues =====
 ==== Yosemite and Accessibility Settings Problems ====
@@ Line 379: / Line 417: @@
 If you must stay on version 10.10.0-2 for any reason, see the forum topic on [possible solutions](http://forum.keyboardmaestro.com/t/yosemite-accessibility-permission-problems/541/18).
+==== Mojave and Catalina Issues ====
+See Forum topics:
+  - [Resolving Catalina/Mojave Accessibility/Security Permissions Issues ](https://forum.keyboardmaestro.com/t/tip-resolving-catalina-mojave-accessibility-security-permissions-issues/16620)
-===== macOS Issues =====
+==== Big Sur Issues ====
+See Forum topics
+  - [Resolving Big Sur Accessibility, Security, and Other Issues ](https://forum.keyboardmaestro.com/t/tip-resolving-big-sur-accessibility-security-and-other-issues/20159)
+  - [macOS Big Sur: Using and Upgrading To ](https://forum.keyboardmaestro.com/t/macos-big-sur-using-and-upgrading-to/19637)

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools