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.
luit rendering ISO 8859-1 accented characters on a UTF-8 terminal emulator.
|Original author(s)||Juliusz Chroboczek|
|Operating system||Unix and Unix-like|
|License||MIT/X Consortium License|
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 "
LC_ALL=fr_FR luit ssh legacy-machine" 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 (including line-drawing characters) 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 (one that may have matched the terminal emulator's expectations in the absence of luit), luit can misinterpret the application's output and produce corrupted output to the terminal.
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.
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.
- Coopersmith, Alan, "Luit 1.1.1 release announcement" (March 22, 2012)
- "luit manual page"
- "UTF-8 and Unicode FAQ for Unix/Linux"
- "luit author website"
- "luit home page"
- "luit notes"
- "x11-utils Debian popularity contest results"
- "Ubuntu popularity contest results"
- AIX 7.1 manual
- "Xorg luit home page"
- "Freedesktop mailing list discussion, 'luit forked?', April 2009
- Adam Jackson (August 7, 2018). "[PATCH app/luit] Retire this fork of luit". firstname.lastname@example.org (Mailing list).