Luit


luit is a utility program used to translate the character set of a computer program so that its output can be displayed correctly on a terminal emulator that uses a different character set. Whereas iconv converts the character set of strings or text files at rest, luit converts the input and output of programs running interactively.

Overview

The main purpose of luit is to allow "legacy" applications that use character sets other than UTF-8 to work with contemporary terminal emulators.
luit may be required today when connecting to a "legacy" host that only supports an older encoding, such as ISO 8859-1. For example, instead of running "ssh legacy-machine", a user may have to run "" to properly render French accented characters on a UTF-8 terminal.
luit is also used to properly render the output of applications that use ISO 2022 character set switching. ISO 2022 is an older standard that allowed an application to "switch" between different fonts, e.g., to mix line-drawing characters with text or to display text in multiple languages and character sets. UTF-8 itself does not support switching fonts; the encoding is stateless and gives each unique character its own numerical encoding. It can be used to translate between these two encodings.
Examples of programs that require translation to run correctly on a UTF-8 terminal include earlier versions of emacs/MULE, and programs that use ISO 2022 shift sequences in ANSI escape codes that switch to an alternate character set in order to draw line-drawing characters.
luit is invoked automatically by xterm when necessary to translate program output into UTF-8, for programs running on a local computer. When connecting remotely to another computer, the user must run luit directly.
luit interprets application output according to the locale's character set with ISO 2022 shifts and ECMA-48 escape sequences. If an application is speaking a different language than the locale's character set, luit can misinterpret the application's output and produce corrupted output to the terminal.

History

luit was written in 2001 by Juliusz Chroboczek, when major Linux distributions began migrating to the Unicode character set from "legacy" encodings such as ISO 8859-1. It has since become a widely installed base utility, present on more than half of all Linux computer systems by some estimates. It is also part of IBM's AIX.

Implementations

There are two versions of luit: one maintained by Thomas Dickey as part of xterm, and another by Freedesktop.org. Linux distributions generally ship the latter version as part of their X11 utilities package. However, while migrating to GitLab, the latter fork was discontinued because it was unmaintained.