» Home

  » Plugins

      » Mime

            » Supported Directives

Brass Plugins: Mime

 

Supported Directives: Keyboard, Simple keypress

This directive sends multiple keypresses to the target application. Please read the important technical note on sending brackets at the end of this page.

The format of the directive is:

keys to send

 

There is no need to separate keys by the %% delimiter.

 

Examples

Send "Brass is great!", press the Enter key, and "I love it!" to an application

Brass is great!%%[RET]%%I love it!

 

Emulate pressing ALT F, then X to exit an application

[ALT]f[/ALT]%%x

 

 

Technical Notes

This directive should be self explanatory. The keypress is emulated in the target application. You can use this directive to create gesture macros for things you type regularly.

Imagine you have a standard signature that you use in Outlook for emails, in GMail for webmail and on forums for your posts. Normally you would have to set up individual signatures for each of these.

Instead you can create an action that applies to all applications (ie: has no criteria). If your signature was:

-Joe Bloggs
(Supreme Commander of the World)

 

You could create a directive as follows:

-Joe Bloggs%%{RET}%%(Supreme Commander of the World)%%{RET}

 

Now any gesture with this directive will automatically insert your signature wherever you make it.

 

Important note on escaping brackets

Sometimes you might want to start a simple keypress directive with a [ or { . But as you already know these brackets are used to specify the start of a directive. To begin a simple keypress with a bracket you must escape it with a backslash:

\[This text will be in brackets]%%{RET}

This directive would output:

[This text will be in brackets]

 

The same is true for curly braces:

\{This text will be in brackets}%%{RET}

This directive would output:

{This text will be in brackets}

 

Finally the same is true for keypresses in [ALT] or [CTRL] modifiers. This directive sends the equivalent of holding ALT and pressing [

[ALT]\[[/ALT]

 

Another example would be to emulate holding CTRL and pressing [ then G and H:

[CTRL]\[GH[/CTRL]

 

You only need to escape a bracket if it's the first character in a string. Examples:

Correct:

[ALT]ab[c[/ALT]

Incorrect:

[ALT]ab\[c[/ALT]

 

Correct:

abc{def%%[RET]

Incorrect:

abc\{def%%[RET]