My Keyboard Maestro Macros, Shortcuts, AppleScripts, etc.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 13 commits ahead of michaelfox:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
• Keyboard Maestro - Export macros
• Keyboard Maestro - Export macros.kmmacros
• Keyboard Maestro - Export

Keyboard Maestro Macro Export

This macro set does two things well:

  1. Easily export all your macros with kmexport.php.
  2. Export macro groups with images using the export macros


Creates .kmmacros files for all of the following:

  • Your entire Keyboard Maestro Collection macros/Keyboard Maestro Macros.plist
  • Each Group within your collection macros/groups/{{Group Name}}.plist
  • Each Macro within your groups macros/groups/{{Group Name}}/{{Macro Name}}.plist

Using kmexport.php

Clone the repo:

git clone "Keyboard Maestro Macros" && cd "Keyboard Maestro Macros"

Get Composer for dependency management:

curl -s | php

Install dependencies:

php composer.phar install

Export the macros:


Exporting macros to a Markdown file with images

I wish this was built into Keyboard Maestro but here is a way to easily generate a formatted list, with images, of a macro group you wish to share with others (especially for somewhere like Github).

  • Setup kmmexport.php, as above.
  • Add the [macro group](/• Keyboard Maestro - Export macros.kmmacros) to Keyboard Maestro.
  • Set the variables in [• Keyboard Maestro _ Export macro - set variables](/• Keyboard Maestro - Export macros/Keyboard Maestro _ Export macro - set variables.kmmacros) to your liking.
  • Change the repeat action n times in [Keyboard Maestro | Export macro group with image](/• Keyboard Maestro - Export macros/Keyboard Maestro | Export macro group with image.kmmacros) to the number of macros in the group you wish to export.
  • Execute [Keyboard Maestro | Export macro group with image](/• Keyboard Maestro - Export macros/Keyboard Maestro | Export macro group with image.kmmacros).
  • Cleanup the markdown file to your liking. In particular, ensure no newlines (\n) were added at the end of the filenames. If you find this happens often, you may need to increase the pauses within the macros, as the previous steps are dependent on processing power.
  • Share!

What you get:

  • A markdown file of the macros, with images. See [• Keyboard Maestro _ Export macro](/• Keyboard Maestro - Export for an example.
  • The entire group of macros in one kmmacros file.
  • Each individual kmmacros file.

Like it?

Get a discount on Keyboard Maestro.

If you have feature suggestions, please open an issue. If you have contributions, open a pull request. I'd love to make this project as reliable and efficent as is possible.


The author(s) of this module should be contacted via the issue tracker.