User Tools
manual:URL_Schemes
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:URL_Schemes [2019/06/20 22:29] peternlewis |
manual:URL_Schemes [2023/09/12 22:33] peternlewis |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== Command Line Tool ====== | ||
| + | |||
| + | Keyboard Maestro includes a command line tool to let you execute macros from the shell command line. The tool is named `keyboardmeastro` and is located within the `Keyboard Maestro.app` application. Assuming the application is installed in the Applications folder, the command line tool will reside at: | ||
| + | |||
| + | ``` | ||
| + | /Applications/Keyboard Maestro.app/Contents/MacOS/keyboardmeastro | ||
| + | ``` | ||
| + | |||
| + | You may want to create a shell alias for it, or add `/Applications/Keyboard Maestro.app/Contents/MacOS` to your PATH, or you can link to it from `/usr/local/bin` with the command: | ||
| + | |||
| + | ```bash | ||
| + | sudo ln -s '/Applications/Keyboard Maestro.app/Contents/MacOS/keyboardmeastro' /usr/local/bin/keyboardmeastro | ||
| + | ``` | ||
| + | |||
| + | Use `--help` to list out the argument options. | ||
| + | |||
| + | The command can pass a value to the macro (available via the [[token:TriggerValue|%TriggerValue%]] token), and execute the macro asynchronously, or wait for the macro to finish, receiving a result (returned via the [[action:Return_Result|Return Result]] action) which is output the stdout. | ||
| + | |||
| + | Alternatively, the command can ask to edit the specified macro in the Keyboard Maestro editor. | ||
| + | |||
| ====== URL Schemes ====== | ====== URL Schemes ====== | ||
| Line 6: | Line 26: | ||
| ^ Example Editor URL Command ^ Description ^ | ^ Example Editor URL Command ^ Description ^ | ||
| - | | `keyboardmaestro://u=support%40stairways.com/s=ABCDEFGH0123456789` | enter your username/serial number. | | + | | `keyboardmaestro://u=support%40stairways.com/s=ABCDEFGH0123456789` | Enter your username/serial number. | |
| - | | `keyboardmaestro://m=Activate%20Application%20Switcher`\\ `keyboardmaestro://m=D2F427A1-51E3-4719-820B-4C25B6FF7329` | edit a specific macro or macro group.\\ You may used either the Macro Name, or UUID. | | + | | `keyboardmaestro://m=Activate%20Application%20Switcher`\\ `keyboardmaestro://m=D2F427A1-51E3-4719-820B-4C25B6FF7329` | Edit a specific macro or macro group.\\ You may used either the Macro Name, or UUID. | |
| - | | `keyboardmaestro://q=Activate` | filter macros with this keyword. | | + | | `keyboardmaestro://q=Activate` | Filter macros with this keyword. | |
| - | | `keyboardmaestro://g=All%20Macros/q=Activate` | select a macro group and filter macros with this keyword. | | + | | `keyboardmaestro://g=All%20Macros/q=Activate` | Select a macro group and filter macros with this keyword. | |
| - | | `keyboardmaestro://a=Execute` | filter actions with this keyword. | | + | | `keyboardmaestro://a=Execute` | Filter actions with this keyword. | |
| - | | `keyboardmaestro://c=All%20Actions/a=Execute` | select action category and filter actions with this keyword. | | + | | `keyboardmaestro://c=All%20Actions/a=Execute` | Select action category and filter actions with this keyword. | |
| --- | --- | ||
manual/URL_Schemes.txt · Last modified: 2023/09/12 22:34 by peternlewis
Page Tools
