Working with UNIX scripts

This page explains how to pass your document's text to UNIX scripts that are executable via the Script menu, or how to receive the outputs from them.

Passing text data to a script

To pass text data from CotEditor to your script, you need to put a comment at the beginning of the script and write “%%%{CotEditorXInput=xxxx}%%%” inside. Replace “xxxx” with one of the parameters below.

SelectionTo pass the text you are currently selecting.
AllTextTo pass the whole text of your document.
NoneTo pass nothing (default).

Receiving output data from a script

To make CotEditor receive output data from a script, you need to put a comment at the beginning of the script and write “%%%{CotEditorXOutput=xxxx}%%%” inside. Replace “xxxx” with one of the parameters below.

ReplaceSelectionTo replace the current selection with the contents of the output data.
ReplaceAllTextTo replace the whole text of your document with the contents of the output data.
InsertAfterSelectionTo insert the contents of the output data right after the current selection.
AppendToAllTextTo insert the contents of the output data at the end of your document.
PasteboardputsTo store the contents of the output data in clipboard.
DiscardTo do nothing (default).

See also