MLTERM(1)MLTERM(1)NAMEmlterm - Multi Lingual TERMinal emulator on X
SYNOPSISmlterm [options]
DESCRIPTIONmlterm is a multi-lingual terminal emulator written from scratch, which
supports various character sets and encodings in the world and complex
characters such as double width for East Asian, combining for Thai,
Vietnamese, and so on, and bi-direction for Arabic and Hebrew. Indic
scripts are experimentally supported. It also supports various unique
feature such as anti-alias using FreeType, multiple XIM, multiple win‐
dows, scrollbar API, scroll by mouse wheel, automatic selection of
encoding, daemon mode, and so on.
Supported encodings are: ISO-8859-[1-11], ISO-8859-[13-16], TIS-620
(same as ISO-8859-11), KOI8-R, KOI8-U, KOI8-T, GEORGIAN-PS, TCVN5712,
ISCII_(ASSAMESE|BENGALI|GUJARATI| HINDI|KANNADA|MALAYALAM|ORIYA|PUN‐
JABI|ROMAN|TAMIL|TELUGU), VISCII, CP125[0-8], CP874, EUC-JP, EUC-
JISX0213, Shift_JIS, Shift_JISX0213, ISO-2022-JP[1-3], EUC-KR, UHC,
JOHAB, ISO-2022-KR, GB2312 (EUC-CN), GBK, GB18030, ISO-2022-CN, HZ,
EUC-TW, BIG5, BIG5HKSCS, and UTF-8. If you have already set locale
(for example LANG variable; see locale(7) for detail) mlterm will auto‐
matically select proper encoding.
OPTIONS
Note that bool is to be substituted by true or false.
-A, --aa(=bool)
Use anti-aliased fonts. This option works only with Xft or cairo
for now. The default is false.
-B, --sbbg=color
Specify a background color of a scrollbar. A valid value for
color is a color name or a RGB value. The color name should be
defined in rgb.txt or "color" configuration file. The RGB
value's format should be "#RRGGBB", "#RRGGBBAA", "rgb:RR/GG/BB"
or "rgba:RR/GG/BB/AA".
-C, --ctl(=bool)
Enable complex text layouting on UTF8 encoding to support indic
scripts and RTL (right-to-let) languages such as Arabic and
Hebrew. The default is true.
-E, --km=encoding
Specify encoding. Valid encodings are listed in DESCRIPTION
section above in this man page. AUTO makes mlterm determine the
according according to the current locale (default AUTO).
-F, --sbfg=color
Specify a foreground color of a scrollbar. See --sbbg option
for valid values.
-G, --vertical=mode
Specify vertical writing mode. cjk for RTL vertical writing and
mongol for LTR one. The default is none which means horizontal
writing mode.
-H, --bright=value
Brightness of background images in percent. See -p option for
details of background images. The default is 100 (keep origi‐
nal).
-I, --icon=name
Specify a name to be used when a mlterm window is iconified.
The default is "mlterm".
-J, --dyncomb(=bool)
Enable dynamic character combining. "Dynamic" means that com‐
bining characters are stored in without combining but they are
displayed using combined form. This affects calculation of col‐
umn position, i.e., a pair of base character and combining char‐
acter is counted to be two columns in this mode, while it is
counted to be one column in the normal mode. Under this option,
a (logical) column number and a character one-to-one correspon‐
dence. even for combining characters (though not for fullwidth
characters; see -Z/--multicol option for handling of fullwidth
characters). Thus, this mode enables you to use combining char‐
acters with software which does not support combining charac‐
ters. The default is false.
-K, --metakey=value
Specify a key to be interpreted as a META key. Valid values
are: alt, meta, hyper, super, mod1, mod2, mod3, mod4, and none.
The default is none.
See -k option also.
-L, --ls(=bool)
Whether to use login shell or not. The default is false.
-M, --im= input method : [ arguments ... ]
Specify an input method.
Examples:
--im=xim
Use XIM with the default XIM server specified by standard
way (i.e., XMODIFIERS environmental variable).
--im=xim:Ami
Use XIM with Ami on the system locale.
--im=xim:kinput2:ja_JP.EUC-JP
Use XIM with kinput2 on ja_JP.EUC-JP locale.
--im=kbd:arabic
Use keyboard mapping input method in Arabic.
--im=kbd:hebrew
Use keyboard mapping input method in Hebrew.
--im=kbd:isciixxx
Use keyboard mapping input method in Indic.
--im=uim
Use uim with the default conversion engine.
--im=uim:prime
Use uim with prime conversion engine.
--im=m17nlib:ru
Use m17n library in Russian.
--im=m17nlib:or:itrans
Use m17n library in Oriya using ITRANS method.
--im=scim
Use SCIM.
--im=ibus
Use IBus.
--im=fcitx
Use Fcitx.
--im=canna
Use Canna.
--im=wnn
Use Freewnn.
--im=none
Don't use input method.
-N, --name=name
Specify application name. The default is "mlterm".
-O, --sbmod=value
Specify the side to show a scrollbar. left for left side and
right for right side. none turns off a scrollbar. autohide
shows a scrollbar only if mouse pointer is at the right edge of
the screen. The default is left.
-P, --clip(=bool)
Whether to enable CLIPBOARD (not only PRIMARY) selection. The
default is true.
-Q, --vcur(=bool)
Change interpretation of cursor keys to be natural in vertical
writing mode. This means that up and down arrow keys are
treated as backward (left arrow in horizontal LTR) and forward
(right arrow in horizontal LTR), respectively. In cjk -G/--ver‐
tical mode, left and right arrow keys are also treated as next
line (down arrow in horizontal LTR) and previous line (up arrow
in horizontal LTR), respectively, while vice versa in mongol
mode. The default is false.
-R, --fsrange=range
Set acceptable range of font size. The format is "minsize-max‐
size", where minsize and maxsize are font sizes in pixel
(default 6-30). The GUI configurator and other means for set‐
ting fontsize should honor the range.
-S, --sbview=name
Select a type of scrollbar. See SCROLLBAR section below for
details. The default is "simple" which means the built-in sim‐
ple scrollbar.
-T, --title=name
Specify a title for a mlterm window. The default is "mlterm".
-U, --viaucs(=bool)
Force to convert a selection (i.e., copy-and-paste strings)
whose type is not UTF8_STRING to the current mlterm encoding via
Unicode. See SELECTION section below for detail. The default
is false.
-V, --varwidth(=bool)
Use variable column width. You may want to use this option when
you use proportional fonts. The default is false.
-W, --sep=characterlist
Delimiter characters used for word selection, which are con‐
sulted when you double-clicked mlterm, to define what is a word.
The default is " ,.:;/|@()[]{}")
-X, --alpha=value
Alpha in pseudo or true transparent. The default is 255.
-Y, --decsp(=bool)
Use dynamically composed line drawing character set of DEC spe‐
cial. The default is false. This overrides DEC_SPECIAL in
"font" configuration file, while DEC_SPECIAL in "aafont" (for
Xft or cairo) is always overridden.
-Z, --multicol(=bool)
Treat fullwidth characters (east Asian characters in most cases;
which occupies two columns on the screen) as they occupy two
logical columns. It is the de-facto standard way to handle
fullwidth characters in east Asian terminal emulators (XFree86
xterm and kterm, cxterm, hanterm, rxvt, eterm) and other sys‐
tems such as MS-DOS, PC-9801, and so on. In most fonts, the
glyphs of fullwidth characters are designed assuming that their
width are twice of normal characters and won't display correctly
without this option. The default is true.
-0, --crbg=color
Specify background color for cursor (default is same to fore‐
ground color). Valid values for color are color names defined
in rgb.txt and color rgb string whose format is "#RRGGBB",
"#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA".
-1, --wscr=value
Specify actual window width, by percentage against calculated
value by multiplying font width by column number. This is use‐
ful when you use a proportional font which includes some glyphs
with exceptionally large width, i.e., much larger "maximum
width" than your expectation. The default is 100.
-2, --hscr=value
Specify actual screen height, like -1/--wscr does for width.
The default is 100.
-3, --contrast=value)
Contrast of background image in percent. See -p option for
details of background image. The default is 100.
-4, --gamma=value)
Gamma of background image in percent. See -p option for details
of background image. The default is 100.
-5, --big5bug(=bool)
Enable a workaround for Big5 CTEXT bugs (which had been existed
until XFree86 4.1.0). This affects Big5 selections (i.e., copy-
and-paste strings) in COMPOUND_TEXT format which mlterm sends.
The default is false.
-6, --stbs(=bool)
Don't exit backscroll mode when console applications output
something. The default is false.
-7, --bel=mode
Behavior when BEL (0x07) is received. sound for beep , visual
for blanking screen and sound|visual for the both. The default
is none which ignores BEL.
-8, --88591(=bool)
Use ISO8859-1 fonts for US-ASCII part of various encodings.
-9, --crfg=color
Specify foreground color for cursor (default is same to back‐
ground color). Valid values for color are color names defined
in rgb.txt and color rgb string whose format is "#RRGGBB",
"#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA".
-$, --mc=value
Doubleclick/tripleclick interval in millisecond. The default is
250.
-%, --logseq(=bool)
Enable logging. Contents of stream received by mlterm will be
logged under ~/.mlterm/. This option is mainly intended to be
used for debugging purposes. The default is false. Note that %
should be escaped to be supplied as a command line option on
most shells.
-&, --borderless(=bool)
Asks the window manager to use no decorations at all. Warning:
You will not be able to resize the window. You probably want to
use --geometry as well. The default is false.
-@, --screens=value
Specify number of screens (sessions) to be used in start up.
The default is 1. Note that when one of these screens are
closed, sessions which were connected to the screens do not
immediately killed.
See MULTIPLE PTY section for details.
-*, --type=value
Specify the rendering engine to be used to draw fonts. xcore is
conventional X11 core font mechanism. xft means Xft mechanism
and cairo means cairo mechanism. The default is xft.
-#, --initstr=value
Specify a string to be automatically sent after initialization
of session. The value normally will be parsed by a shell. See
-e option to execute other application at start-up time.
-a, --ac=value
Specify number of columns to be occupied by a Unicode's "East‐
AsianAmbiguous" character. The default is 1 except "ja" locale
where the default is 2. Some of asian people may want to specify
2. See Unicode Standard Annex (UAX) #11 East Asian Width found
at Unicode web site for details.
-b, --bg=color
Specify background color (default white). Valid values for
color are color names defined in rgb.txt and color rgb string
whose format is "#RRGGBB", "#RRGGBBAA", "rgb:RR/GG/BB" or
"rgba:RR/GG/BB/AA".
-c, --cp932(=bool)
Use CP932 mapping table to convert from JIS X 0208 to Unicode
when displaying JIS X 0208 characters using Unicode font in Xft
or cairo mode. This is useful when you use proprietary Japanese
true type fonts which are intended to be used with Microsoft
Windows, with mlterm with encodings (such as EUC-JP, Shift_JIS,
ISO-2022-JP, and so on) which contain JIS X 0208 as a coded
character set.
The reason is, such proprietary fonts may have glyphs only for
Unicode code points into which JIS X 0208 code points are con‐
verted using CP932 mapping table. (CP932 is a name of mapping
table which is used by Microsoft to convert from Shift_JIS [plus
Microsoft private extended characters] into Unicode. In Uni‐
code's point of view, CP932 is a name of encoding which is simi‐
lar to Shift_JIS and is used by Japanese version of Microsoft
Windows.) If you use such fonts for encodings such as EUC-JP
and Shift_JIS with JIS0208.TXT mapping table which mlterm adopts
as the standard, a few characters are mapped into Unicode code
points where the fonts don't have glyphs.
Both of CP932.TXT and JIS0208.TXT mapping tables are supplied by
Unicode Consortium, though they are regarded to be obsolete.
The default is true.
-d, --display=string
Specify X display to connect with.
-e program [ arguments ... ]
Invoke the command in the mlterm window. This option must be
the last option on the command line.
-f, --fg=color
Foreground color (default black). Valid values for color are
color names defined in rgb.txt and color rgb string whose format
is "#RRGGBB", "#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA".
-g, --geometry=geometry
Specify size and position of the window; see X(7).
-h, --help(=bool)
Show help messages.
-i, --xim(=bool)
Whether to use XIM (X Input Method). Most east Asian people
will want to enable this option. Other people can also safely
enable this. The default is true. The name of the XIM server
to be connected is specified by standard way (i.e., XMODIFIERS
environmental variable).
-j, --daemon=value
Start as a daemon process. Note that mlclient is executed if a
daemon process has already started. Possible =values are
"blend" and "genuine". See the chapter of DAEMON MODE for
details.
-k, --meta=mode
Behavior of META key. esc for sending ESC and none for ignoring
META key. The default is 8bit which sets the most significant
bit.
See -K option also.
-l, --sl=value
Specify number of lines of backlog or "unlimited". The default
is 128.
-m, --comb(=bool)
Enable combining characters by overstriking glyphs (recommended
for TIS-620, TCVN5712, and UTF-8). Note that fonts which con‐
tain combining characters which extend backward cannot be used,
since mlterm does combine characters by controlling the writing
positions. This option is automatically turned on when using
--dyncomb option. The default is true.
-n, --noucsfont(=bool)
Use non-Unicode fonts even when mlterm encoding is UTF-8. Use‐
ful when you don't have ISO10646-1 fonts and you want to use
UTF-8 encoding. The default is false.
-o, --lsp(=value)
Specify number of extra pixels between lines. The default is 0.
-p, --pic=path
Path for a wallpaper (background) image. Note that the wallpa‐
per cannot be used with pseudo transparent background.
-q, --extkey(=bool)
Enable extended keys for backscroll mode. The default is false.
Extended scroll keys are SCROLL_UP, up arrow, and "k" (for
scrolling one line backward) and SCROLL_DOWN, down arrow, and
"j" (for scrolling one line forward). Please note that concrete
keys for symbols of SCROLL_UP and SCROLL_DOWN are specified in
key configuration file. Only keys of PAGE_UP and PAGE_DOWN
(which are specified in key configuration file) are available by
default.
-r, --fade=ratio
Specify fading ratio for unfocused windows. 100 means no fading
and 0 means darkest. The default is 100
-s, --mdi(=bool)
Whether to use multiple document interface. The default is
true. If you disable this option, scrollbar and screen separa‐
tion are unavailable.
-t, --transbg(=bool)
Whether to enable pseudo transparent background. Note that
pseudo transparent background cannot be used with wallpaper.
The default is false.
-u, --onlyucsfont(=bool)
Use Unicode fonts even when mlterm encoding is not UTF-8. Use‐
ful when you have ISO10646 fonts but you don't have other fonts
and want to use non-UTF-8 encodings. Note that conversion to
Unicode is lossy. i.e. if mlterm encoding is not a subset of
Unicode like ISO-2022-JP-2 or EUC-TW, characters which are
regarded as a same character in Unicode will be displayed with
the same glyph and cannot be distinguished.
The default is false.
-v, --version
Show version information.
-w, --fontsize=value
Specify font size in pixel. The default is 16.
-x, --tw=value
Specify tab width. The default is 8.
-y, --term=string
Specify terminal type, i.e., the value of TERM variable. The
default is xterm.
-z, --largesmall=size
Specify the step of changing font size in pixel when you pushed
"Font size larger" or "Font size smaller" button on GUI configu‐
rator. The default is 1.
--ade=value
Specify character encodings detected automatically.
--auto(=bool)
Automatically detect appropriate character encoding from the
encodings specified by --ade option. The default is false.
--altbuf(=bool)
Whether to enable alternate screen buffer. This option is simi‐
lar to "titeInhibit" of xterm.
--bd=value
Specify the color to use to display bold characters.
--bdfont(=bool)
Use bold font for characters with the bold attribute. The
default is true.
--bimode=value
Specify bidi mode. Valid values are: normal, left and right.
The default is normal.
--bisep=characterlist
Specify separator characters to render bidi text.
--bl=value
Specify the color to use to display blinking characters.
--blink(=bool)
Blink cursor. The default is false.
--border=value
Specify inner border width. The default is 2. The maximum value
is 224.
--boxdraw=value
Use either unicode font or DEC Special font forcibly to draw
box-drawing characters. unicode for unicode font and decsp for
DEC special font. The default is noconv which draw them as they
are.
--co=value
Specify the color to use to display crossed-out characters.
--colors(=bool)
Whether to recognize ANSI color change escape sequences. The
default is true.
--csp=value
Specify number of extra pixels between lines. (ignored if you
specify --V option.) The default is 0.
--ciphlist=value
Specify ciphers (comma separated list) for encrypting the ssh
session.
--depth=value
Specify visual depth. (8,16,24,32) If depth is 32, you can
enable semi-transparency by specifying opacity as the value of
--alpha option or "rgba:RR/GG/BB/AA" as the value of --bg
option.
--deffont=value
DEFAULT in ~/.mlterm/*font.
--exitbs(=bool)
Whether to exit backscroll mode on receiving data from pty. The
default is false.
--fullwidth=value
Force full width regardless of EastAsianWidth.txt.
e.g.) --fullwidth=U+1234-5678,U+0123-4567
--iconpath=path
Specify the file to be used as a window icon.
--it=value
Specify the color to use to display italic characters.
--itfont(=bool)
Use italic font for characters with the italic attribute. The
default is true.
--keepalive=value
Specify interval seconds to send keepalive message to ssh
server. The default is 0.
--lborder=value
Specify inner border width of a layout manager. The default is
0. The maximum value is 224.
--ldd(=bool)
Embold glyphs by drawing doubly at 1 pixel leftward instead of
rightward. The default is false.
--locale=value
Specify locale. The default is "".
--logmsg(=bool)
Enable logging messages of mlterm to ~/.mlterm/msg.log. The
default is true.
--loecho(=bool)
Whether to use local echo mode or not. The default is false.
--maxptys=value
Specify maximum number of ptys (sessions) to be opened simulta‐
neously. It should be multiple of 32. The default is 32.
See MULTIPLE PTY section for detail.
--metaprefix=value
Specify prefix characters in pressing meta key if mod_meta_mode
= esc. The default is \x1b.
--noul(=bool)
Don't draw underline. The default is false.
--osc52(=bool)
Allow access to clipboard(selection) by OSC 52 sequence. The
default is false.
--parent=value
Specify parent Window ID. The default is 0.
--point(=bool)
Treat the value of -w option as point instead of pixel. Note
that this option works on xft, cairo or win32. The default is
false.
--scp(=bool)
Allow OSC 5379 scp. The default is false. Even if allow_scp =
false, it is possible to transfer a file to "." directory
(~/.mlterm/scp).
--serv=value
Specify a host you want to connect via ssh etc. This option is
enabled only if mlterm is built with MinGW or --enable-ssh2
option.
Value format: (<protocol>://)(<user>@)<server>(:<port>)(:<encod‐
ing>)
e.g.) mlterm--serv ssh://user@host:22:eucjp
--pubkey=value
Specify public key file for ssh connection. The default is
~/.ssh/id_rsa.pub(%HOMEPATH%termid_rsa.pub in win32).
--privkey=value
Specify private key file for ssh connection. The default is
~/.ssh/id_rsa(%HOMEPATH%termid_rsa in win32).
--restart=value
Whether to restart mlterm with all opened ptys except ssh if
SIGSEGV, SIGBUS, SIGFPE or SIGILL is received. The default is
true.
--seqfmt=value
Specify the format of logging vt100 sequence. raw for logging as
it is and ttyrec for logging by ttyrec format. The default is
raw.
--shortcut(=bool)
Whether to allow dynamic change of shortcut keys by OSC 5379
set_shortcut sequence. The default is false.
--ul=value
Specify the color to use to display underlined characters.
--ucsnoconv=value
Use unicode fonts partially regardless of -n option.
e.g.) --ucsnoconv=U+1234-5678,U+0123-4567
--urgent(=bool)
Draw the user's attention when making a bell sound in the unfo‐
cused window. The default is false.
--working-directory=value
Working directory.
--x11(=bool)
Enable x11 forwarding for ssh connection. The default is false.
GUI CONFIGURATOR
Pushing control key and mouse button 3 invokes GUI configurator (mlcon‐
fig). It can modify encoding, foreground and background color, tab
size, backlog size, font size, usage of combining character, and so on.
GUI configurator has six pages (Encoding, Font, Background, Color,
Scrollbar, and Others), OK/Apply/Cancel buttons, and four special but‐
tons.
Note this feature needs GTK+ 2.x or later.
Encoding page
Encoding-related configurations are located in this page. Note that
configurations will be enabled when you push Apply button.
Encoding
Specify encoding. (-E, --km)
Auto detect
Whether to detect appropriate character encoding automatically.
(--auto)
Encoding list
Specify character encodings detected automatically. (--ade)
Input Method
Specify which input method to be used. (-M, --im)
XIM:
XIM Server
Specify the name of XIM server to be connected. You can
input from your keyboard or you can choose one of regis‐
tered XIM servers. This doesn't have equivalent command
option. See the section of XIM Configuration File for
registration of XIM servers.
XIM locale
Specify the name of the locale to be used for connection
to the XIM server. Popular XIM servers usually have
acceptable locales to be used for connection. If you
choose registered XIM server in Input Method, this will
be set automatically. You can also input the locale name
from your keyboard.
keyboard:
Option Specify the name of key mapping table. When using ISCII
encoding, Indic key mapping is used automatically. In
other encodings, this will be automatically selected
according to the current locale.
uim:
Option Specify the name of the conversion engine to be used. If
you choose auto, the conversion engine will be automati‐
cally selected according to the current locale.
Note this feature needs uim library.
m17n library:
Option Specify the language and the input method to be used. If
you choose auto, the language and input method will be
automatically selected according to the current locale.
Note this feature needs m17n library and m17n-db.
SCIM:
No option
iBus:
No option
fcitx:
No option
wnn:
No option (JSERVER and WNNENVRC environmental variables are
available.)
canna:
No option
Bidi (UTF-8 only)
Whether to support BiDi (bi-direction). (-D, --bi)
Indic Whether to support indic scripts. (-C, --ind)
Combining
Whether to support combining characters by overstriking. (-m,
--comb)
Process received strings via Unicode
When you paste some strings into mlterm, the strings are con‐
verted into Unicode and then to mlterm encoding. (-U, --viaucs)
Font page
Configurations related to appearance (or look&feel) are located in this
page.
Font size
Font size in pixel. (-w, --fontsize)
Foreground color
Foreground color for letters. (-f, --fg)
Xft Use xft for rendering engine. (-*, --type)
Cairo Use cairo for rendering engine. (-*, --type)
Anti alias
Use anti-alias fonts by using Xft or cairo. (-A, --aa)
Variable column width
Use variable column width. (-V, --varwidth)
Vertical mode
Vertical writing mode. (-G, --vertical)
Font name
Specify XLFD, Xft or cairo font for character sets. "Select"
button shows a dialog to choose it.
Font policy
Whether to use unicode fonts (or non-unicode fonts) all the time
regardless of a selected encoding. (-u, --onlyucsfont) (-n,
--noucsfont)
Box drawing
Whether to use a unicode font or (a dec special font) all the
time to draw box drawing characters. (--boxdraw)
Line space
Specify number of extra dots between lines. (-o, --lsp)
Letter space
Specify number of extra dots between characters. (--csp)
Width ratio
Specify actual screen width. (-1, --wscr)
Height ratio
Specify actual screen height. (-2, --hscr)
Background page
Configurations related to background are located in this page.
Background color
Background color. (-b, --bg)
Picture
Specify the image file to be used for background image. (-p,
--pic)
Transparent
Pseudo transparent background. (-t, --transbg)
Picture/Transparent Brightness, Contrast, Gamma and Alpha.
Brightness, contrast, gamma alpha of the background image. (-H,
--bright) (-3, --contrast) (-4, --gamma) (-X, --alpha)
Fade ratio on unfocus
Fading ratio when window is unfocused. (-r, --fade)
Color page
Configurations related to color are located in this page.
Cursor color
Specify color to show cursor. (-9, --crfg) (-0, --crbg)
Substituting color
Specify color to show instead of bold, underlined, italic,
blinking or crossed-out attribute. (--bd) (--ul) (--it) (--bl)
(--co)
VT basic 16 colors
Customize VT basic 16 text colors.
Scrollbar page
Configurations related to scrollbar are located in this page.
Position
Specify scrollbar position. (-O, --sbmod)
View Specify name of scrollbar. (-S, --sbview)
Foreground color
Specify foreground color of scrollbar. (-F, --sbfg)
Background color
Specify background color of scrollbar. (-B, --sbbg)
Others page
Other configurations are located in this page.
Tab size
Column number of tab. (-x, --tw)
Backlog size
Number of lines of backlog. (-l, --sl)
Meta key outputs
Behavior of META key. (-k, --meta)
Bell mode
Behavior when mlterm receives BEL (0x07) code. (-7, --bel)
Save log
Whether to log sequence received from pty in ~/.mlterm/[pty].log
in raw or ttyrec format. (--logseq) (--seqfmt)
Combining = 1 (or 0) logical column(s)
Processing combining characters as if it occupies one column
logically while it occupies zero column on the screen. (-J,
--dyncomb)
Fullwidth = 2 (or 1) logical column(s)
Processing CJK fullwidth characters as it occupies two columns
logically since it occupies two columns on the screen. (-Z,
--multicol)
Ambiguouswidth = fullwidth (UTF8 only)
Processing Unicode characters with EastAsianAmbiguous property
as fullwidth. (-a, --ac)
Local echo
Whether to use local echo mode. (--loecho)
Blink cursor
Whether to blink cursor. (--blink)
Buttons
There are buttons which is independent from OK/Apply/Cancel buttons.
OK/Apply/Cancel
OK button applies the modified configuration to the current
mlterm session, saves it to "~/.mlterm/main" configuration file,
and quits the GUI Configurator. Apply button just applies the
modified configuration to the current mlterm session.
Font size (Larger and Smaller)
Change font size.
Full reset
Reset internal status.
SSH SCP
Transfer a file via SCP.
PTY List
One process of mlterm may have multiple sessions and screens.
The sessions may or may not have corresponding screen, i.e., the
number of sessions can be more than the number of screens. Such
situation can be achieved by closing a part of multiple screens
from -@/--screens option. In such case, the screen-less session
can be designated to one of screens by choosing the session
(pty) from this list and push "select" button.
CONFIGURABLE MENU
Pushing control key and mouse button 1 invokes configurable menu dis‐
player (mlterm-menu). It displays a menu with items such as "Larger
Font" or "UTF-8 encoding". Though a default menu definition is sup‐
plied, you can freely define menu items by writing a menu configuration
file. See Menu Configuration File section for detail.
Note this feature needs GTK+ 2.x or later.
MULTIPLE XIMmlterm can use multiple XIM (X Input Method) servers. The current XIM
is specified by the GUI configurator. Using this feature you can input
multiple complex languages such as Japanese and Korean. Locale to be
used for communication with XIM can also be specified for each XIM. In
the GUI configurator, you can choose one of registered pair of XIM and
its locale or you can input your favorite XIM and its locale.
The locale for XIM is only used for communication with the XIM and is
not related to the current mlterm locale. You have to properly config‐
ure the XIM locale only when your XIM has preference on the locale of
XIM client (i.e., mlterm in this case). mlterm automatically convert
the inputed string into proper encoding and you don't have to care
about it.
Of course the initial XIM is chosen by using standard configuration,
i.e., using XMODIFIERS environmental variable. See X(7) for detail on
XIM and XMODIFIERS variable.
DAEMON MODE
When invoked with -j/--daemon command line option, mlterm starts to
listen on a unix domain socket and accept requests from mlclient.
With blend mlterm will exit when the final terminal window is closed.
But with genuine, mlterm will disconnect from X server windows and
continues to work. In latter case, it's possible to stop and restart a
X server and revive the lasting sessions on mlterm.
SCROLLBARmlterm supports scrollbar API so that users can develop scrollbar
libraries with arbitrary look and feel. The scrollbar libraries can be
used by putting the libraries at the specified directory (determined on
the compilation process) and invoke mlterm with -s -S name option.
Scrollbar libraries named "sample", "sample2", "athena", "motif", "moz‐
modern", and "next" are supplied.
ANTI-ALIAS
mlterm can use True Type fonts using -A option via FreeType library
when it has been compiled with anti-alias option.
Note this feature needs XFree86 4.0.2 or above and FreeType 2.0.2 or
above.
WALLPAPERmlterm can use background image (as known as wallpaper), by using
-p/--pic option. You can also specify the brightness of the image by
using -H/--bright option.
Note this feature needs gdk-pixbuf.
MULTIPLE PTY
This is one of most unique features of mlterm. The number of windows
can be specified using -P option. Typing control + F1 opens another
window which shares the same process. The maximum number of windows
can be specified using --maxptys option.
BACKSCROLL MODEmlterm enters into backscroll mode by typing Shift + up or Shift +
PageUp key. In the mode, you can use the following keys.
j or Down
Scroll down one line.
k or Up
Scroll up one line.
d or PageDown
Scroll down one page.
u or PageUp
Scroll up one page.
Shift + space
Initialize XIM.
Shift + Insert
Insert selection.
Control + F1
Open a new pty window.
keys defined in key configuration file
PAGE_UP, PAGE_DOWN, SCROLL_UP, and SCROLL_DOWN keys are defined
in the file.
other keys
Exit from the backscroll mode.
Please note that keys other than PAGE_UP and PAGE_DOWN in key configu‐
ration file are available only when you used -q/--extkey command
option.
SELECTION
Selection is a mechanism to be used for copy-and-paste in X Window Sys‐
tem. Thus, this section describes on so-called copy-and-paste.
There are many encodings in the world. Though copy-and-paste needs
sender and receiver and each of them can use one of various encodings,
mlterm is designed to be able to receive characters from various encod‐
ings as much as possible.
There are two internationalized types of selection. One is COM‐
POUND_TEXT is the another is UTF8_STRING. COMPOUND_TEXT is
ISO2022-based and can distinguish character sets which a character
belongs to. However, the character sets which COMPOUND_TEXT supports
are limited to ISO8859-* and East Asian character sets. On the other
hand, UTF8_STRING is Unicode-based and can express all characters from
Unicode character set. However, it cannot distinguish characters from
different character sets which share one codepoint in Unicode, which
can be a problem especially for CJK Han Ideogram (in other words,
Kanji, Hanji, or Hanja). Note that UTF8_STRING is rather new and can
be used only with XFree86.
Though the receiver of copy-and-paste can request the preferable type
of selection, the sender may not support the requested type. Thus
mlterm has to be able to process both of COMPOUND_TEXT and UTF8_STRING.
On the other hand, encodings supported by mlterm (see DESCRIPTION sec‐
tion for detail) are classified into four categories;
(a) Unicode itself
UTF-8.
(b) subset of Unicode and ISO-2022-compliant
"Subset of Unicode" means that Unicode supports round-trip com‐
patibility for the encoding, i.e., the conversion of the encod‐
ing --> Unicode --> the encoding doesn't lose any information.
"ISO-2022-compliant" means that the encoding can be regarded as
a subset of ISO-2022 where a part of ISO-2022 control codes and
escape sequences are not supported. Many popular encodings
belong to this category such as ISO-8859-*, EUC-*, ISO-2022-KR,
TIS-620, TCVN5712, and so on.
(c) subset of Unicode and non-ISO-2022-compliant
Some of popular encodings such as Shift_JIS, Big5, GBK, GB18030,
Johab, and so on belongs to this category.
(d) not subset of Unicode
ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-3, EUC-TW, and so on.
All of them are ISO-2022-compliant.
Now the behavior of mlterm can be explained.
-------------------------------------------------------
encoding received selection how to process?
-------------------------------------------------------
a COMPOUND_TEXT convert to Unicode
a UTF8_STRING no need for conversion
b COMPOUND_TEXT user preference *1
b UTF8_STRING convert to the encoding *2
c COMPOUND_TEXT user preference *1
c UTF8_STRING convert to the encoding *2
d COMPOUND_TEXT no need for conversion *3
d UTF8_STRING convert to the encoding *2
-------------------------------------------------------
*1 Characters from unsupported character sets (i.e., characters which
cannot be expressed in the mlterm encoding) may appear in the selection
(received copy-and-paste string). If you want to receive characters
which are equivalent to characters which are supported in the current
mlterm encoding (i.e., characters which share the same codepoint in
Unicode), you can use -U (or --viaucs) option. Otherwise, these char‐
acters are pasted into mlterm using ISO-2022 escape sequence (when
mlterm encoding is category b). Note such ISO-2022 escape sequences
are illegal in the current mlterm encoding and the application software
will need special feature to treat them properly, though it is dis‐
played well in mlterm. When mlterm encoding is category c, such char‐
acters are simply ignored (when -U option is not enabled).
*2 Characters which cannot be converted into mlterm encoding are simply
ignored.
*3 Characters from unsupported character sets will be pasted into
mlterm using ISO-2022 escape sequence.
CONFIGURATIONmlterm loads configuration files of "main", "font", "vfont", "tfont",
"aafont", "vaafont", "taafont", "color", "key", "termcap", and "xim" on
start up. "menu" configuration file is loaded by the configurable menu
displayer (mlterm-menu). See the section of CONFIGURABLE MENU for
detail.
Configuration files for one user are to be located in "~/.mlterm/"
directory, while location for configuration files for all users depends
on the compilation option. Possible locations are "/etc/",
"/etc/X11/", "/usr/X11R6/lib/X11/mlterm/", and so on.
The names and the roles of configuration files are:
main Main configuration items which can be overridden by command line
options.
font Configurations for ordinary X fonts.
vfont Configurations for ordinary X fonts of variable column width.
tfont Configurations for ordinary X fonts of vertical writing.
aafont Configurations for Xft or cairo fonts.
vaafont
Configurations for Xft or cairo fonts of variable column width.
taafont
Configurations for Xft or cairo fonts of vertical writing.
color Designate concrete RGB values for color names.
key Key definitions for special features of mlterm.
termcap
Define mlterm's behaviors which affects terminfo and termcap
definition.
xim Define preset locales for X Input Methods which are shown in the
GUI configurator. Of course you can input XIM names and locales
for the GUI configurator which are not listed in this configura‐
tion file.
menu Define menu items which is displayed by configurable menu dis‐
player.
The contents of these configuration files (other than menu) consist of
lines of "key=value" format. Lines beginning with "#" are ignored.
Note that the configuration files are changed since version 1.9.44.
Main Configuration File
This file contains main configuration items which can be overridden by
command line options. The main configuration file "main" has the fol‐
lowing keys. Parentheses show the corresponding command-line options.
See the explanation on these command-line options for detail.
auto_detect_encodings=value (--ade)
Specify character encodings detected automatically.
allow_osc52=bool (--osc52)
Allow access to clipboard(selection) by OSC 52 sequence.
allow_scp=bool (--scp)
Allow OSC 5379 scp.
allow_change_shortcut=bool (--shortcut)
Allow dynamic change of shortcut keys by OSC 5379 set_shortcut
sequence.
alpha=name (-X, --alpha)
Alpha in pseudo or true transparent.
app_name=name (-N, --name)
Application name. auto_restart=bool (--restart) Restart mlterm
with all opened ptys except ssh if SIGSEGV, SIGBUS, SIGFPE or
SIGILL is received. If you want to get core image, specify
"false".
bel_mode=mode (-7, --bel)
Behavior when BEL (0x07) is received.
bd_color=value (--bd)
Specify the color to use to display bold characters.
bl_color=value (--bl)
Specify the color to use to display blinking characters.
bg_color=color (-b, --bg)
Background color.
bidi_mode=mode (--bimode)
Specify bidi mode.
bidi_separators=characterlist (--bisep)
Specify separator characters (\xNN is also available) to render
bidi text.
blink_cursor=bool (--blink)
Blink cursor.
box_drawing_font=value (--boxdraw)
Use either unicode font or DEC Special font forcibly to draw
box-drawing characters.
brightness=value (-H, --brightness)
Specify the amount of darkening or lightening the background
image.
big5_buggy=bool (-5, --big5bug)
Support Big5 CTEXT bugs (which exist in XFree86 4.1.0 or
before).
borderless=bool (-&, --borderless)
Don't draw window decorations.
cipher_list=value (--ciphlist)
Specify ciphers (comma separated list) for encrypting the ssh
session.
co_color=value (--co)
Specify the color to use to display crossed-out characters.
col_size_of_width_a=value (-a, --ac)
Number of columns of Unicode characters with EastAsianAmbiguous
property.
compose_dec_special_font=bool (-Y, --decsp)
Compose line drawing character set.
contrast=value (-3, --contrast)
Contrast of background image in percent.
cursor_bg_color=color (-0, --crbg)
Specify background color for cursor.
cursor_fg_color=color (-9, --crfg)
Specify foreground color for cursor.
exit_backscroll_by_pty=bool (--exitbs)
Exit backscroll mode on receiving data from pty.
encoding=encoding (-E, --km)
Specify encoding.
daemon_mode=mode (-j, --daemon)
Start as a daemon process.
default_server=value (--serv)
Specify a host you want to connect via ssh etc.
depth=value (--depth)
Specify visual depth.
display=value (-d, --display)
Specify X server to connect.
fade_ratio=ratio (-r, --fade_ratio)
Specify fading ratio when window is unfocused.
fg_color=color (-f, --fg)
Foreground color.
fontsize=value (-w, --fontsize)
Font size in pixel.
font_size_range=range (-R, --fsrange)
Range of size of usable fonts.
gamma=value (-4, --gamma)
Gamma of background image in percent.
geometry=value (-g, --geometry)
Specify size and position of the window; see X(7).
hide_underline=bool (--noul)
Don't draw underline.
icon_name=name (-I, --icon)
Icon name.
icon_path=path
Path for the image file to be used as window icon.
inner_border=value (--border)
Specify inner border width.
input_method= input method : [ arguments ... ] (-M, --im)
Specify input method.
iso88591_font_for_usascii=bool (-8, --88591)
Use ISO8859-1 fonts for US-ASCII part of various encodings.
it_color=value (--it)
Specify the color to use to display italic characters.
layout_inner_border=value (--lborder)
Specify inner border width of a layout manager.
leftward_double_drawing=bool (--ldd)
Embold glyphs by drawing doubly at 1 pixel leftward instead of
rightward.
letter_space=value (--csp)
Specify number of extra dots between letters. (ignored if you
specify --V option.) If you use multiple fonts whose widths are
different, adjust this option.
line_space=value (-o, --lsp)
Specify number of extra dots between lines. If you use multiple
fonts whose heights are different, adjust this option.
locale=value (--locale)
Specify locale.
logging_msg=bool (--logmsg)
Enable logging messages of mlterm to ~/.mlterm/msg[pid].log.
logging_vt_seq=bool (--logseq)
Enable logging vt100 sequences to ~/.mlterm/[device].log.
logsize=value (-l, --sl)
Specify number of lines of backlog or "unlimited".
max_ptys=value (--maxptys)
Specify maximum number of ptys (sessions) to be opened simulta‐
neously.
meta_prefix=value (--metaprefix)
Specify prefix characters in pressing meta key if mod_meta_mode
= esc.
mod_meta_mode=mode (-k, --meta)
Behavior of META key.
mod_meta_key=value (-K, --metakey)
Specify a key to be regarded as META.
not_use_unicode_font=bool (-n, --noucsfont)
Use non-Unicode fonts even when mlterm encoding is UTF-8.
only_use_unicode_font=bool (-u, --onlyucsfont)
Use Unicode fonts even when mlterm encoding is not UTF-8.
parent_window=value (--parent)
Specify parent Window ID.
receive_string_via_ucs=bool (-U, --viaucs)
If the received selection (i.e., copy-and-paste strings) or
strings received from XIM is not UTF8_STRING type, convert it
into Unicode and then to the current mlterm encoding, in order
to identify equivalent characters (i.e., characters which share
the same codepoint in Unicode) from various character sets. See
SELECTION section below for detail.
sb_bg_color=color (-B, --sbbg)
Background color for scrollbar.
sb_fg_color=color (-F, --sbfg)
Foreground color for scrollbar.
screen_height_ratio=value (-1, --hscr)
Specify actual screen height.
screen_width_ratio=value (-1, --wscr)
Specify actual screen width.
scrollbar_mode=mode (-O, --sbmod)
Specify scrollbar position.
scrollbar_view_name=name (-S, --sbview)
Specify name of scrollbar.
ssh_keepalive_interval=value (--keepalive)
Specify interval seconds to send keepalive message to ssh
server.
ssh_public_key=value (--pubkey)
Specify public key file for ssh connection.
ssh_private_key=value (--privkey)
Specify private key file for ssh connection.
ssh_x11_forwarding=bool (--x11)
Enable x11 forwarding for ssh connection.
step_in_changing_font_size (-z, --largesmall)
Specify changing size when font size becomes larger or smaller.
tabsize=value (-x, --tw)
Specify tab width.
termtype=string (-y, --term)
Terminal type.
title=name (-T, --title)
Title name.
type_engine=value (-*, --type)
Rendering engine for drawing fonts.
ul_color=value (--ul)
Specify the color to use to display underlined characters.
unicode_full_width_areas=value (--fullwidth)
Force full width regardless of EastAsianWidth.txt.
unicode_noconv_areas=value (--ucsnoconv)
Use unicode fonts partially regardless of -n option.
use_auto_detect=bool (--auto)
Automatically detect appropriate character encoding from the
encodings specified by auto_detect_encodings option.
use_alt_buffer=bool (--altbuf)
Use alternate screen buffer.
use_ansi_colors=bool (--colors)
Recognize ANSI color change escape sequences.
use_anti_alias=bool (-A, --aa)
Use anti alias font.
use_bold_font=bool (--bdfont)
Use bold font for characters with the bold attribute.
use_clipboard=bool (-P, --clip)
Use CLIPBOARD (not only PRIMARY) selection.
use_combining=bool (-m, --comb)
Enable combining characters.
use_cp932_ucs_for_xft=bool (-c, --cp932)
Use CP932 - UCS mapping for displaying JISX0208 by Xft or cairo.
use_dynamic_comb=bool (-J, --dyncomb)
Enable dynamic character combining.
use_extended_scroll_shortcut=bool (-q, --extkey)
Enable extended short cut keys for scrolling.
use_ctl=bool (-C, --ctl)
Enable complex text layouting on UTF8 encoding.
use_italic_font=bool (--itfont)
Use italic font for characters with the italic attribute.
use_local_echo=bool (--loecho)
Use local echo mode.
use_login_shell=bool (-L, --ls)
Whether to use login shell or not.
use_multi_column_char=bool (-Z, --multicol)
Process full width characters.
use_point_size=bool (--point)
Treat the value of -w option as point instead of pixel.
use_mdi=bool (-s, --mdi)
Use multiple document interface.
use_transbg=bool (-t, --transbg)
Use pseudo transparent background.
use_urgent_bell=bool (--urgent)
Draw the user's attention when making a bell sound in the unfo‐
cused window.
use_variable_column_width=bool (-V, --varwidth)
Use variable column width.
use_vertical_cursor=value (-Q, --vcur)
Use cursor movement for vertical writing.
use_xim=bool (-i, --xim)
Use XIM (X Input Method).
vertical_mode=value (-G, --vertical)
Use vertical writing.
wall_picture=path (-p, --pic)
Path for wallpaper image.
word_separators=characterlist (-W, --sep)
Delimiter characters (\xNN is also available) used for word
selection.
working_directory=value (--working-directory)
Working directory.
static_backscroll_mode=bool (-6, --stbs)
Don't exit backscroll mode when console applications output
something.
vt_seq_format=value (--seqfmt)
Specify the format of logging vt100 sequence.
Font Configuration Files
The font configuration files "font", "vfont", "tfont", "aafont", "vaa‐
font", and "taafont" have the following keys.
DEFAULT=fonts
DEC_SPECIAL=fonts
ISO8859_n=fonts
TIS620=fonts
ISCII_HINDI=fonts
ISCII_MALAYALAM=fonts
ISCII_ASSAMESE=fonts
ISCII_BENGALI=fonts
ISCII_GUJARATI=fonts
ISCII_KANNADA=fonts
ISCII_MALAYALAM=fonts
ISCII_ORIYA=fonts
ISCII_PUNJABI=fonts
ISCII_ROMAN=fonts
ISCII_TAMIL=fonts
ISCII_TELUGU=fonts
VISCII=fonts
KOI8_R=fonts
KOI8_U=fonts
TCVN5712=fonts
JISX0201_ROMAN=fonts
JISX0201_KATA=fonts
JISX0208_1978=fonts
JISX0208_1983=fonts
JISX0208_1990=fonts
JISX0213_2000_1=fonts
JISX0213_2000_2=fonts
KSX1001_1997=fonts
UHC=fonts (not used)
JOHAB=fonts (not used)
GB2312_80=fonts
GBK=fonts
BIG5=fonts
HKSCS=fonts
CNS11643_1992_n=fonts
ISO10646_UCS4_1=fonts
ISO10646_UCS4_1_FULLWIDTH=fonts
U+XXXX-XXXX=fonts
Specify fonts for corresponding character sets. The format is
different between "font", "vfont" "tfont" files and "aafont",
"vaafont" "taafont" files.
In "font", "vfont", "tfont" files, "font" is specified in
"NAME:PERCENT;SIZE,NAME:PERCENT;SIZE,NAME:PERCENT;..." format
where "SIZE" is font size in pixel, and "NAME" is XLFD or alias
names of X fonts. If the first "NAME" contains "%d", it is
replaced by an appropriate font size number. ":PERCENT" is mul‐
tiplied by font size and decides character width of a font. If
":PERCENT" is omitted, max font width is used for it.
In "aafont", "vaafont", "taafont" files, "font" is specified in
"FAMILY WEIGHT SLANT SIZE-ENCODING:PERCENT;SIZE,FAMILY WEIGHT
SLANT SIZE-ENCODING:PERCENT;SIZE,FAMILY WEIGHT SLANT SIZE-ENCOD‐
ING:PERCENT;..." format. The first pair of FAMILY WEIGHT SLANT
SIZE and ENCODING specifies the default font and the others with
SIZE are for specific sizes. ":PERCENT" is multiplied by font
size and decides character width of a font. If ":PERCENT" is
omitted, 'W' width is used for it.
charset_BOLD=fonts
Specify boldface fonts.
charset_ITALIC=fonts
Specify italic fonts.
charset_BOLD_ITALIC=fonts
Specify bold-italic fonts.
Color Configuration File
The color configuration file "color" has the following key.
COLORNAME=RGB
Assign a concrete color for the name COLORNAME. Default colors
used by mlterm are black, red, green, yellow, blue, magenta,
cyan, and white. and can be overridden here.
For hilighted colors, a name with "hl_" prefix will be automati‐
cally searched. i.e. for bold read character, "hl_red" is
searched instead of "red".
17 - 230 and 232 - 255 in 256 colors can be also overridden.
The format of RGB is either "RRRR-GGGG-BBBB" (where RRRR, GGGG,
and BBBB are hexadecimal value from 0 to ffff), "#RRGGBB",
"#RRGGBBAA", "rgb:RR/GG/BB" or "rgba:RR/GG/BB/AA"(where RR, GG,
and BB are hexadecimal value from 00 to ff).
If mlterm failed to parse a entry, the color will be regarded as
black.
XIM Configuration File
The X Input Methods configuration file "xim" has the following format
XIM=locale
where XIM is XIM name and locale is locale name used for communication
with the XIM server. For example,
kinput2=ja_JP.eucJP
Ami=ko_KR.eucKR
xcin-zh_CN.GB2312=zh_CN.GB2312
These settings are used to create list of XIMs by the GUI configurator.
Though a XIM which is not listed in this file can't be selected from
the list, it can be selected by specifying its name directly.
Feature Key Configuration File
The feature key configuration file "key" has the following format.
KEY=FEATURE
Here, the format for KEY is "(MASK+)KEY", where MASK is one of Control,
Shift, Mod1, Mod2, Mod3, Mod4, Mod5, Mod and Alt. You can specify mul‐
tiple "MASK+"s. You can search spellings of KEY by using xev(1) com‐
mand or searching keysym macros from
/usr/X11R6/include/X11/keysymdefs.h (or the equivalent file in your X11
include directory) and omit the prefix XK_. Double quotation marks are
not needed. You can specify Button1, Button2, Button3, Button4 or But‐
ton5 as KEY.
FEATURE is one of IM_HOTKEY, EXT_KBD, OPEN_SCREEN, NEW_PTY, OPEN_PTY,
NEXT_PTY, PREV_PTY, VSPLIT_SCREEN, HSPLIT_SCREEN, CLOSE_SCREEN,
NEXT_SCREEN, PREV_SCREEN, HEXPAND_SCREEN, VEXPAND_SCREEN, PAGE_UP,
PAGE_DOWN, SCROLL_UP, SCROLL_DOWN, INSERT_SELECTION, "STRING", or
"proto:STRING".
IM_HOTKEY
Switch conversion mode of m17n library and kdb input methods.
(default UNUSED)
EXT_KBD
Activate or deactivate kbd input method. (This feature was
obsoleted by IM_HOTKEY)
OPEN_SCREEN
Open new pty in new screen (default Ctrl+F1).
NEW_PTY
Same as OPEN_SCREEN (obsoleted).
OPEN_PTY
Open new pty in current screen (default Ctrl+F2).
NEXT_PTY
Switch to a next free pty (default Ctrl+F3).
PREV_PTY
Switch to a previous free pty (default Ctrl+F4).
HSPLIT_SCREEN
Open new pty in horizontally splitted screen (default Shift+F1).
VSPLIT_SCREEN
Open new pty in vertically splitted screen (default Shift+F2).
NEXT_SCREEN
Switch to a next unfocused screen (default Shift+F3).
PREV_SCREEN
Switch to a previous unfocused screen (default Shift+F4).
CLOSE_SCREEN
Close current screen (default Shift+F5).
HEXPAND_SCREEN
Expand current screen horizontally (default Shift+F6).
VEXPAND_SCREEN
Expand current screen vertically (default Shift+F7).
PAGE_UP
Start backscroll mode and scroll up one page (default
Shift+Prior).
PAGE_DOWN
Scroll down one page. (default Shift+Next).
SCROLL_UP
Start backscroll mode and scroll up by one line (default
Shift+Up). Note this key is enabled only when -q/--extkey
option is used.
SCROLL_DOWN
Scroll down one line (default Shift+Down). Note this key is
enabled only when -q/--extkey option is used.
INSERT_SELECTION
Insert selection (default Shift+Insert).
"STRING"
The specified string is issued when the KEY key is pressed.
Double quotation marks are required around the STRING. Note
that you cannot control the status of mlterm by sending terminal
control codes such as "\x1b]5379;encoding=utf8\x0a" because the
code sequence will be caught by your shell (or something running
on it). To deliver control sequences to mlterm directly, use
"proto:STRING" instead.
"proto:STRING"
The specified string is assumed to mlterm's original control
sequence. A list of sequences should be found in doc/en/PROTO‐
COL. For example, "proto:encoding=utf8" means changing the cur‐
rent character encoding to UTF-8.
"exesel:STRING"
The specified string is assumed to a command to be executed with
selected strings as arguments. For example, "exesel:mlclient -e
w3m" means executing "mlclient -e w3m [selected text]".
"menu:STRING"
The specified string is assumed to a configuration program to be
executed. For example, "menu:mlterm-menu" means executing
mlterm-menu.
Terminal Behavior Configuration File
This configuration file determines the behaviors of mlterm that should
match the definition of terminfo and termcap. In principle, this file
should not be edited and, instead, you should choose a proper value for
TERM variable (i.e., proper terminfo/termcap definition) which meets
mlterm's behavior. (Since mlterm' can behave as a xterm/kterm to some
extent, TERM=kterm / TERM=xterm should give acceptable results.) How‐
ever, sometimes you may not want to edit your terminfo and termcap.
Your software may don't understand terminfo nor termcap, or your ter‐
minfo/termcap entry is shared by several terminal emulators and chang‐
ing it will break other terminals. In such cases, you can configure
mlterm so that it works well on existing terminfo/termcap definitions
on your systems. This is also useful for distributors of operating
systems (like Debian) with strict policy of terminal emulators' behav‐
iors.
You can define the behaviors of mlterm for each value of TERM variable,
so that you don't need to edit termcap file each time you login into
other systems and use different value of TERM variable by -y option.
You can also specify the default behavior when TERM variable is differ‐
ent from all of specified TERM names in the termcap file.
The grammar of this configuration file is resemble to the grammar of
termcap entries. First, one or more name(s) of TERM is written. Mul‐
tiple names are connected with vertical line character '|'. Special
name '*' is for default. Then colon ':' comes, and keys are written
separated by colons. Configuration(s) for other TERM will follow after
new line.
Followings are available keys for each TERM value.
kD=sequence
Specify sequence to be outputted when Delete key is pushed
(default \E[3~).
kb=sequence
Specify sequence to be outputted when BackSpace key is pushed
(default ^H).
kh=sequence
Specify sequence to be outputted when HOME key is pushed in
application cursor key mode. (default \EOH).
@7=sequence
Specify sequence to be outputted when END key is pushed in
application cursor key mode. (default \EOF).
k1=sequence
Specify sequence to be outputted when F1 key is pushed (default
\EOP).
k2=sequence
Specify sequence to be outputted when F2 key is pushed (default
\EOQ).
k3=sequence
Specify sequence to be outputted when F3 key is pushed (default
\EOR).
k4=sequence
Specify sequence to be outputted when F4 key is pushed (default
\EOS).
k5=sequence
Specify sequence to be outputted when F5 key is pushed (default
\E[15~).
ut Specify the way how the screen is erased by control codes. If
ut is written in the termcap file, charcells are painted by the
current background color when erased; otherwise the charcells
are painted by the initial background color. Default is non-ut
behavior.
The following special characters can be used to specify sequence in
keys of kD/kb/kh/@7.
\E ESC code (0x1b).
^? DEL code (0x7f).
^A, ^B,...
Corresponding control code (0x01 - 0x1a).
Menu Configuration File
This configuration file defines the menu displayed by the configurable
menu displayer mlterm-menu. See CONFIGURABLE MENU section for detail.
SEE ALSO
Manual pages of mlclient(1), locale(7), charsets(7), UTF-8(7), and
X(7).
README.sb for development of scrollbar library.
PROTOCOL for mlterm's original control escape sequences.
Mapping tables between Unicode and local character sets (and encodings)
are found at Unicode Consortium web site (http://www.unicode.org/Pub‐
lic/MAPPINGS/). Note that mapping tables for East Asian character sets
and encodings are moved to OBSOLETE/EASTASIA directory of the site
since August 2001.
For BIG5 and BIG5HKSCS encodings, mapping tables for Unicode is taken
from ftp://xcin.linux.org.tw/pub/xcin/i18n/charset/.
Unicode Standard Annex (UAX) #11 East Asian Width, which explains East
Asian Width properties, and EastAsianWidth.txt, which defines East‐
AsianAmbiguous characters in Unicode, are supplied by Unicode Consor‐
tium (http://www.unicode.org).
FILES
"main", "font", "vfont", "tfont", "aafont", "vaafont", "taafont",
"color", "key", "termcap", "xim", and "menu"
Configuration files.
CONTACT
Subscribe mlterm-dev-en ML (http://lists.source‐
forge.net/lists/listinfo/mlterm-dev-en).
2015-08-29 MLTERM(1)
