User Tools
manual:Search_Strings
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
|
manual:Search_Strings [2016/06/21 23:37] peternlewis |
manual:Search_Strings [2023/09/12 03:49] peternlewis v11 search strings |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Search Strings ====== | ====== Search Strings ====== | ||
| - | When searching for macros, either in the Search field in the [[Windows#Macro_Editor_Window|Macro Editor window]] or as part of a Smart Group, Keyboard Maestro looks for any macro or action that matches all the fields you specify. Each word is searched for separately (and in any order) unless you quote a phrase. | + | 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: |
| + | - [[Windows#Macro_Editor_Window|Keyboard Maestro Editor]], Search field | ||
| + | - [[Windows#Macro_Editor_Window|Keyboard Maestro Editor]], Smart Group | ||
| + | - [[action:Trigger_Macro_by_Name|Trigger Macro by Name Action]] | ||
| - | As well as plain text, you can specify some special patterns: | + | 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. |
| - | | all: | match everything (this is useful since the empty search string matches nothing) | | + | Note that the [[action:Trigger_Macro_by_Name|Trigger Macro by Name Action]] only searches among active macros. |
| - | | group: | match any macro within the named macro group (eg group:"Global Macro Group") | | + | |
| - | | global: | match any macro within any macro group that is globally active (aka universal:) | | + | |
| - | | application | match any macro within any macro group that is specific to (or excluded from) the specified application (eg application:Finder) | | + | |
| - | | enabled: | match any macro that is enabled (not necessarily active) | | + | |
| - | | disabled: | match any macro that is disabled | | + | |
| - | | trigger | match any macro within any macro group that has a trigger matching the specified string (eg trigger:typed) | | + | |
| - | | hotkey | match any macro within any macro group that has a hot key trigger matching the specified string (eg hotkey:⌘⌤C) | | + | |
| - | | name | match any macro within any macro group that has a name matching the specified string (eg name:Activate) | | + | |
| - | The options can generally be shorted to their shortest unique name. Eg: | + | **Search Qualifiers:** |
| - | * g:"Global Macro Group" | + | The qualifier can generally be shorted to its shortest unique name, as shown in the _Short Form_ column. |
| - | * gl: | + | |
| - | * a:Xcode | + | ^ Qualifier ^ Short form ^ Definition ^ Example ^ |
| - | * e: | + | | all: | al: | Match everything | `al:`\\ (Otherwise the empty search string matches nothing) | |
| - | * d: | + | | word: | w: | Match that must be at a word boundary \\ (Use quotes if Word contains spaces) | `word:amp` \\ (Matches “Turn on amp” and not “example”) | |
| + | | group: | gr: | Match any macro within the named macro group\\ (Use quotes if Name contains spaces) | `gr:"Forum Examples"` | | ||
| + | | name: | n: | Match any macro that has a name matching the specified string | `n:PDF` | | ||
| + | | 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) | | ||
| + | | deprecated: | dep: | Match anything that uses deprecated features | `dep:` | | ||
| + | | trigger: | t: | Match any macro that has a trigger matching the specified string | `t:=sig=`\\ (Typed String of “=sig=”) | | ||
| + | | action: | act: | Match an action with the specified action ID | `action:1234`\\ (Action ID of “1234”) | | ||
| + | | 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: `⌃⌥⇧⌘` | `h:⌘⌃C`\\ (CMD CTRL C)\\ \\ `h:`\\ (Matches any HotKey) | | ||
| + | | created: | cre: | Match any macro that was created less that the specified time ago | `cre:1w` | | ||
| + | | modified: | mod: | Match any macro that was modified less that the specified time ago | `mod:1d` | | ||
| + | | used: | use: | Match any macro that was used less that the specified time ago | `use:1m` | | ||
| + | | size: | siz: | Match any macro that has a storage size more than the specified size | `size:10000` | | ||
| + | | note: | not: | Match any action that contains the text in a Note | `note:custom` | | ||
| + | |||
| + | For the created:, modified:, used:, the parameter is a number followed by a letter (s for seconds, m for minutes, h for hours, d for days, or w for weeks). | ||
| + | |||
| + | You can use a negative sign (-) to negate any match (for example, "-name:PDF"). | ||
manual/Search_Strings.txt · Last modified: 2023/10/04 04:08 by peternlewis
Page Tools
