Want to Help Test a Finder-related Macro?

Macro Name: Finder Assistant

I've been working on an ambitious macro for several days and am finding it very useful. It is somewhat complex and I'd like to have some others test it before I share it broadly. If you are interested and have some time to try it and provide feedback, please send me a direct message and I'll share the zip download with you. Keyboard Maestro v10.2 is required.

The download consists of the main macro, 45 subroutines, and a few additional files. The following screenshots an excerpt from the Read Me file will help you understand the scope.


Introductory Dialog Box

Favorite Folders File (default settings)

Example Prompt With List (when no Finder items are selected)

Example Prompt With List (when multiple Finder items are selected)

Example Prompt With List (when an 𝗢𝗽𝗲𝗻 or 𝗦𝗮𝘃𝗲 dialog is open)

When (𝙨𝙤𝙢𝙚 𝙤𝙩𝙝𝙚𝙧 𝙛𝙤𝙡𝙙𝙚𝙧) is selected, the dialog that appears

The 𝗪𝗿𝗶𝘁𝗲 option (i.e., creating new files and folders)

The 𝗧𝗮𝗴 options

Read Me Excerpt

Configuration Settings

  • Macro Settings: Finder Assistant includes several configuration settings within the macro. These settings are identified with comments (magenta) and variable actions (orange). The default settings should be initially used and only adjusted after understanding the basic operation and feactures of Finder Assistant.

  • Favorite Folders File: This is a plain text file that is created and managed by the macro, however, it can be also modified using any text editor.

  • File and Folder Templates: Default file and folder templates are provided, but others can be freely added at any time.

Hot keys

The primary and secondary hot keys for Finder Assistant,⌃⇧F and ⌃⌥⇧F, can be freely changed with one restriction: the secondary hot key must include the option key (⌥).

Executing Finder Assistant

Finder Assistant is normally executed using the primary hot key. The response is context sensitive, based on the items selected (or not) within the Finder at the time the macro is started.

  • If a Finder window is not open (or if one or more are open but none have focus), the Navigation menu is displayed.

  • If a Finder window is open, but no items are selected, a menu is displayed that includes three option: Write, Write, and Save.

  • If one or more Finder items (files and/or folders) are selected, a menu is displayed that contains up to elevan options: Move, Keep, Enclose, Zip, Copy, Replace, Alias, Tag, Write, Navigate, Save.

  • The context sensitivity includes a few other nuances that will be discovered as the macro is used.

If a macOS application (e.g., Preview) Open or Save dialog is open, the Navigation menu will appear if the secondary hot key triggers Finder Assistant. This can be used to quickly switch to a Favorite Folder.

Additional Information

Additional information is provided in the introductory dialog when Finder Assistant is first executed. The Favorite Folders File also includes helpful comments for configuration and operation.

Design Notes

  • The verbs used in Finder Assistant (i.e., Move, Keep, Enclose, Zip, Copy, Replace, Alias, Tag, Write, Navigate, Save) were selected so that menu selections could be made with the fewest possible keystrokes (i.e, each begin with a unique letter). For more information, refer to the Favorite Folders File.

  • Finder Assistant is designed to complete the various Finder tasks within the active Mission Control Desktop Space. It will effectively ignore Minimized (but not Hidden) Finder windows and also all Finder windows open in other Desktop Spaces.


This macro was inspired by at least five other macros:

Based on everything I’ve learned from others on this forum, there are probably other techniques I’ve borrowed from others. (If there are other macros that come to mind, please bring them to my attention so I can inclue the proper attribution.)



I’m looking for a few more testers. Please send me a direct message if you have an interest in this Finder-related macro.

Thank you.