filterm1

Usage

Overview

Execute the specified COMMAND (default is the shell), filtering terminal input and/or output.

It can help e.g. when our terminal is unable to display non-ASCII characters or to enter them from the keyboard. It also makes writing various terminal filters easier.

INPUT and OUTPUT are names of konwert's filters - they are passed as the first argument to the konwert(1) program. filterm - OUTPUT filters only output, and filterm INPUT - only input.

The command - executes the shell as a login shell.

It differs from konwert INPUT | COMMAND | konwert OUTPUT in that the command is executed on a pseudo-terminal, so full-screen programs work correctly.

The filters have to output the characters as soon as they receive all necessary input, without buffering. trs(1) scripts are OK, but sed(1) or awk(1) or tr(1) scripts are not. In C you may use read(), getchar(), fread(), and write(), but putchar() and fwrite() only together with fflush(stdout). In C++: cin.get(), cout.put(), and cout <<. In perl: sysread, getc, read, and syswrite, but print only with $| = 1.

The input filter will have set the environment variable FILTERM=in, and the output one - FILTERM=out. This way some filters can slightly alter their behaviour when working for filterm.

Filters for filterm

See konwert(1). Additionally the following konwert's filters are designed only for filterm:

tyldy (input)

Polish ~a~c~e~l~n~o~s~x~z

lewyap (input)

Polish `a`c`e`l`n`o`s`x`z

boldpl (output)

ASCII with Polish letters shown as bold.

pinectrlchars (output)

Replaces the characters 128..159 shown by the Pine (or another program) as ^À..^ß back to the real 128..159.

512bold (output)

Changes the mapping of colors in 512-character mode, which restricts the number of colors to eight. The palette is dynamically changed to contain the eight most recently used colors. When more colors are used at once, some of them display incorrectly.

512bold1 (output)

Changes the mapping of colors in 512-character mode. Instead of ignoring the intensity, the following colors are available: black, red, green, white, blue, light magenta, light cyan, light gray; others are substituted with approximations. This gives better effect, allowing to show the intensity, with the side-effect of belying the hue of some colors.

kbdmacros (input)

Keyboard macros. A sequence of keys can be recorded with Esc Ctrl-A SEQUENCE Esc Ctrl-E SHORTCUT - after which, if you press the SHORTCUT, the SEQUENCE will be generated instead. Later such assignment can be deleted with Esc Ctrl-A Esc Ctrl-E SHORTCUT Esc Ctrl-E. Instead of Esc Ctrl- you often may press Ctrl-Alt-. The defined shortcuts, together with the above redefinable key combinations used to define them, are stored in the ~/.kbdmacros file. Note: when you redefine a sequence, all its prefixes will not be passed through immediately, but wait until it can be unambiguously told which sequence was actually input. This includes escape sequences representing some extended keys.