User Tools

Site Tools


Search Strings

Search Strings are filters which, in addition to the text you type, can include qualifiers that may be applied to searches for Macros and Actions in:

Keyboard Maestro will search for the text you type, and all of the below qualifiers that you specify, for matches in your list of macros. Each word is searched for separately (and in any order) unless you quote a phrase.

Note that the Trigger Macro by Name Action only searches among active macros.

Search Qualifiers:

The qualifier can generally be shorted to its shortest unique name, as shown in the Short Form column.

Qualifier Short form Definition Example
all: al: Match everything al:
(Otherwise the empty search string matches nothing)
group: gr: Match any macro within the named macro group
(Use quotes if Name contains spaces)
gr:"Forum Examples"
global: gl: Match any macro within any macro group that is globally active gl:
(aka universal:)
application ap: Match any macro that is specific to (or excluded from) the specified application ap:Finder
enabled: e: Match any macro that is enabled e:
(not necessarily active)
disabled: d: Match any macro that is disabled d:
trigger: t: Match any macro that has a trigger matching the specified string t:;sig
(Typed String of “;sig”)
hotkey: h: Match any macro with specified HotKey
Match any macro with any HotKey if no HotKey is specified.
Modifier Keys must be one of these: ⌃⌥⇧⌘

(Matches any HotKey)
name: n: Match any macro that has a name matching the specified string n:PDF

You can use a negative sign (-) to negate any match (for example, “-name:PDF”).

manual/Search_Strings.txt · Last modified: 2017/08/24 23:33 by peternlewis