Differences

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

--- Forum [2018/03/18 08:33] – Keyboard Maestro editor peternlewis
+++ Forum [2025/10/06 07:17] (current) – peternlewis
@@ Line 1: / Line 1: @@
-[[https://forum.keyboardmaestro.com|{{:forum-icon.jpg |Go To Forum}}]]
 ====== Using the Keyboard Maestro Forum ======
+The [[https://forum.keyboardmaestro.com/|Keyboard Maestro forum]] is a very helpful place to ask about creating Keyboard Maestro macros. While Stairways can answer support questions related to using Keyboard Maestro and creating macros in general, questions about creating specific macros or controlling specific applications are better asked on the forum.
+===== Creating an Account on the Forum =====
+To create an account on the forum, [[https://www.stairways.com/form/foruminvite|request an invite]].
 ===== Where To Post =====
@@ Line 7: / Line 12: @@
   * To share your completed, working, macro, post in the [[https://forum.keyboardmaestro.com/c/macro|Forum Macro Section]]
   * **Do not** use the Macro category for posting questions, even about macros. Use the Questions & Suggestions category.
-----
 ===== Before Asking =====
@@ Line 19: / Line 22: @@
 Even if you don't find what you're looking for you'll improve your knowledge of how to use Keyboard Maestro, and there's a good chance you'll ask better questions on the forum because of it.
-----
 ===== How To Get Help =====
@@ Line 29: / Line 30: @@
   * Share your completed, working, macro to help others like you.
+==== Searching the Forum for Answers ====
-----
-==== Searching the Forum for Answers ====
 There are two ways to search the Forum:
   - Using the Forum Search Tool by clicking on the magnifying glass (🔍) at the top right of the Forum window
   - Using the Google site search
     - Just like a normal Google Search, except include `site:forum.keyboardmaestro.com` along with your keywords:\\  [[https://www.google.com/search?q=site%3Aforum.keyboardmaestro.com%20YourKeywords|site:forum.keyboardmaestro.com YourKeyWords]]
+  - Using the Duck Duck Go Keyboard Maestro forum search `!kmf`
+    - [[https://duckduckgo.com/?q=!kmf+YourKeyWords|Duck Duck Go search for `!kmf YourKeyWords`]]
-----
 ==== Posting Your Question or Issue to the Forum ====
+Avoid the [[http://xyproblem.info|XY Problem]] of asking about your attempted //solution// rather than your //actual problem//:
+  * When you are asking a question, ensure you are clear what you are actually trying to accomplish, not just the difficulty you are having in a specific attempt at solving the problem.  There may be a much better way to solve the actual problem rather than resolving the difficulty with your specific attempt.
+  * Always include information about a broader picture along with any attempted solution.
+  * If someone asks for more information, do provide details.
+  * If there are other solutions you have already ruled out, share why you’ve ruled them out. This gives more information about your requirements.
-**If you are having trouble with a macro and want help, then please post:**
+If you are having trouble with a macro and want help, then please post:
   * Your question with as much detail as you can
   * If it involves processing data, provide real world (not madeup) examples of:
@@ Line 57: / Line 60: @@
 This will help others to understand your issue, and to test the macro if need be.\\
 To get the best, fastest answer to your question, provide us with the best info you can.
-----
 ===== How to Post/Upload Your Macro to the Forum =====
 From the Keyboard Maestro editor
-  - For Keyboard Maestro **Version 7+**, use the Share button (see [[Forum#Upload_Using_Share_Button|#1 below]])
+  - Use the Share button (v7.0+) (see [[Forum#Upload_Using_Share_Button|#1 below]])
-  - For **all versions** of Keyboard Maestro, save to files, then import (see [[Forum#Manual_Upload|#2, Manual Upload, below]])
+  - Save to files, then import (see [[Forum#Manual_Upload|#2, Manual Upload, below]])
-----
 ==== 1. Upload Using Share Button ====
-(Available for Keyboard Maestro version 7+ only)
 This will create a **new topic** in the forum category you select.
-    - Click on the Macro name in the Editor
+    - Select the Macro you wish to share in the Editor.
-    - Click on the Share button
+    - Adjust the width of the Macro Detail column to a sensible size for display in the forum.
-    - Change the "Category" to "Macro" if you are sharing a working macro for others to use
+    - Click on the Share button.
-    - Leave the "Category" on "General" if you are asking a question related to the macro
+    - Leave the *Category* on *Questions & Suggestions* if you are asking a question related to the macro.
-    - Click on the "Both" button
+    - Change the *Category* to *Macro Library* if you are sharing a working macro for others to use.
-    - :!: Note: If you just click on the "New Topic" button, it will NOT upload your macro.
+    - By default, both the macro and an image of the macro will be included.
+    - Click on the “New Topic” button (or before version 10.0, click the “Both” button).
-To move the uploads to an **existing topic**, see instructions below these screenshots.
+{{::share-button.png?214&nolink|}}
-{{:km-share-button.png?nolink|}}\\
+and then this popup will appear
-**and then this popup will appear**
-{{:km-share-macro-popup.png?nolink|}}
+{{::share-macro-to-forum.png?450&nolink|share-macro-to-forum}}
-**To MOVE to an existing topic, then AFTER the new topic is created:**
+==== 2. To include the macro in an Existing Topic ====
-  - Select ALL in the new topic
-  - CUT the selection
-  - Cancel/Abort the new topic
-  - Goto the existing topic
-  - Create a reply
-  - PASTE into the reply block
-See this video:  [How To Upload Macro to Existing Post in Keyboard Maestro Forum](https://www.youtube.com/watch?v=0kkNXZBpWtM)
+After the new topic is created by the *Share to Forum*:
-----
+  - Select **all** in the new topic.
+  - **Cut** the selection.
+  - **Cancel/Abort** the new topic in the forum.
+  - Goto the existing topic, and edit your message or create a reply.
+  - **Paste** into the forum editor in the topic you're working in.
+See this video:  [How To Upload Macro to Existing Post in Keyboard Maestro Forum](https://www.youtube.com/watch?v=0kkNXZBpWtM)
-==== 2.  Manual Upload ====
+==== 3.  Manual Upload ====
-**Follow these steps to manually export your macro to files, then upload**
+Follow these steps to manually export your macro to files, then upload:
   - Click on the macro name in the Keyboard Maestro editor
   - Goto //File > Export Macro//, and save wherever you'd like
@@ Line 110: / Line 106: @@
   - Enter some descriptive text,
   - Use the file upload button  in the Keyboard Maestro Forum Editor to upload both files.
-    - OR drag and drop files from the Finder into the Keyboard Maestro Forum Editor.
+    - **or** drag and drop files from the Finder into the Keyboard Maestro Forum Editor.
-    - OR using most web browsers other than Safari you can copy and paste into the Keyboard Maestro Forum Editor.
+    - **or** using most web browsers other than Safari you can copy and paste into the Keyboard Maestro Forum Editor.
       - Images in the Clipboard or files copied from the Finder can be pasted.
   - The [Select Clipboard Image File](https://forum.keyboardmaestro.com/t/select-clipboard-image-file/204) macro may also be useful for posting images.
+The items uploaded (shared) will be those items which are **selected** in the editor:
-----
-The items uploaded (shared) will be those items which are SELECTED in the editor:
   * If you have selected a macro in the macro list, then it will be uploaded
   * If you have selected one or more Actions in a Macro, then only the Action(s) will be uploaded.
-----
  --- //Original article posted by:  [[kmforum@thestoneforge.com|Christopher Stone]] 2015/11/12 20:19//