Keyboard Maestro Wiki

**This is an old revision of the document!**

The Filter action is extremely powerful for editing the contents of a variable, clipboard or file.

Select the source for the filter, which can be the System Clipboard, a Named Clipboard, the Trigger Clipboard (v8+), a variable, some tokenised text (v8+), or a file (v8+).

Prior to v8.0 there were separate Variable and Clipboard Filter actions.

Select the filter to use from the with pop-up.

The available filters are described in the Filters user manual section.

Select where the result should go - back to the source or to a clipboard, variable or file. Prior to v8.0 the result was always saved back to the source.

The list of possible filters will likely expand, so if you have specific filtering needs that you think might be of general interest, please let us know. In the mean time, remember that you can apply scripted filters using an AppleScript or shell script.

For example the Execute Shell Script action:

is roughly equivalent to the Uppercase filter, for the System Clipboard, except that it only works with ASCII characters.

Note that the definition of what a character, word, or line is is more than a little ambiguous, so if you have strict requirements for your definition you will need to calculate it yourself to ensure you get the answer you require. For example, the line count will return the number of lines, with a minimum of one, which will not necessarily be the same as the number of end-of-line characters, and the number of characters may or may not count multi-plane unicode characters as one character, and we wont even attempt to define what is and isn’t a single word.

See Also

Actions

Forum

Keywords