--- name: "lilyterm" section: "1" platform: "linux" package: "lilyterm" version: "0.9.9.4+git20150208.f600c0-5" release: "Debian 10 (Buster)" platforms: ["linux"] url: "https://new.carta.tech/lilyterm" --- # lilyterm(1) A light and eazy-to-use terminal emulator for X. ## NAME LilyTerm - A light and eazy-to-use terminal emulator for X. ## SYNOPSIS **lilyterm** \[**-?** \| **-h** \| **--help**\] \[**-T** *TITLE* \| **--title** *TITLE*\] \[**-R** *ROLE* \| **--role** *ROLE*\] \[**-t** *NUMBER* \| **--tab** *NUMBER*\] \[**-n** *TAB NAMES* \| **--tab\_names** *TAB NAMES*\] \[**-d** *DIRECTORY* \| **--directory** *DIRECTORY*\] \[**-g** *GEOMETRY* \| **--geometry** *GEOMETRY*\] \[**-l** \| **-ls** \| **--login**\] \[**-ut**\] \[**-H** \| **--hold**\] \[**-s** \| **--separate**\] \[**-j** \| **--join**\] \[**-p** \| **--profile**\] \[**-u** *PROFILE* \| **--user\_profile** *PROFILE*\] \[**-v** \| **--version**\] \[**-e** *COMMAND* \| **-x** *COMMAND* \| **--execute** *COMMAND*\] ## DESCRIPTION LilyTerm is a terminal emulator for the X Window System, based on the **libvte** library, and aims to be fast and lightweight. ## OPTIONS - **-?** \| **-h** \| **--help** Display a brief help message. **-T** *TITLE* \| **--title** *TITLE* Specify the window title. **-R** *ROLE* \| **--role** *ROLE* Specify the WM\_WINDOW\_ROLE string of window. **-t** *NUMBER* \| **--tab** *NUMBER* Open multi tabs when starting up. **-n** *TAB NAMES* \| **--tab\_names** *TAB NAMES* Specify the tab names, separate with \. **-d** *DIRECTORY* \| **--directory** *DIRECTORY* Specify the init directory when starting up. **-g** *GEOMETRY* \| **--geometry** *GEOMETRY* Specify the geometry of window when starting.\ A reasonable example value is "80x24+0+0", witch means "width x height {+-} xoffset {+-} yoffset" (without space). - **-l** \| **-ls** \| **--login** Make the shell invoked as a login shell. - **-ut** Disable recording the session in lastlog, utmp and wtmp. - **-H** \| **--hold** Hold the terminal window open when the command following -e/-x terminated. - **-s** \| **--separate** Run in separate process. - **-j** \| **--join** Integrate new created tabs to the last accessed window.\ It may be useful for launching multi commands with LilyTerm in a shell script. - **-p** \| **--profile** Got a profile sample. **-u** *PROFILE* \| **--user\_profile** *PROFILE* Use a specified profile. - **-v** \| **--version** Show the version information. **-e** *COMMAND* \| **-x** *COMMAND* \| **--execute** *COMMAND* Run a command when starting up. Must be the final option. ## KEYBOARD CONTROL The following key bindings may custom or disable by the right click menu **\[Set key binding\]**. - **\\<\`\>** Disable/Enable hyperlinks, function keys and right click menu for temporary. - **\\** Add a New tab with current directory. - **\\** Switch to Prev/Next tab. - **\\** Switch to First/Last tab. - **\\<\[/\]\>** Move current tab Forward/Backward. - **\\** Move current tab to First/Last. - **\\** Switch to 1st ~ 12th tab. - **\\** Select all the text in the Vte Terminal box. - **\\<+/-/Enter\>** Increase/Decrease/Reset the font size of current tab. - **\\** Switch between fullwindow/unfullwindow and fullscreen/unfullscreen state. - **\\** Emulate a mouse Scroll Up/Down event on Vte Terminal box. - **\\** Asks to scroll Up/Down 1 line on Vte Terminal box. - **\\** Asks to scroll Up/Down on Vte Terminal box. - **\\** Copy the text to clipboard / Paste the text in clipboard. - **\\** Copy the text to primary clipboard / Paste the text in primary clipboard.\ i.e. Emulate a middle button mouse click to copy/paste the text. Some key bindings that disabled by default but maybe useful: - **\\** Close current tab.\ *Using* **\\** *or '***exit***' to close tabs is recommended.* - **\\** Open a new window with current directory. - **\\** Rename the current tab. ## FILE - **/etc/xdg/lilyterm.conf** System configure file - **~/.config/lilyterm/default.conf** User's profile. Use **\[Save settings\]** in the right click menu to save the current tab's settings as default to the specified profile. ## TIPS **Display UTF-8 character under C locale** Execute the following command under LilyTerm: bind "set convert-meta off"\ bind "set output-meta on" And use the right click menu to set the text encoding to "**UTF-8**". **Launch LilyTerm under a chroot jail** Extract **xauth info** to a file (under X): xauth extract /PathToChroot/tmp/display $DISPLAY Mount the **devpts** device and **/tmp** (may not necessary) before chroot into a chroot jail: mount /dev/pts /PathToChroot/dev/pts -t devpts\ mount -o bind /tmp /PathToChroot/tmp (may not necessary) Merge the extracted **xauth info** and set the **DISPLAY** environ after chroot into the chroot jail: xauth merge /tmp/display\ export DISPLAY=:0 Launch LilyTerm directly, or run it under **Xnest**/**Xephyr**: xinit ~/.xinitrc -- /usr/bin/Xnest :1 -ac -geometry 800x600 or xinit ~/.xinitrc -- /usr/bin/Xephyr :1 -ac -screen 800x600 **\\ and \\ don't work under VIM:** Use the following command to turn off '**flow-Control**' under LilyTerm: stty raw or stty -ixon **BSD Users:** Please mount the procfs before launch LilyTerm: mount -t procfs procfs /proc ## ENVIRONMENT - **TERM** Sets what type of terminal attempts to emulate. Please always set to "**xterm**" under LilyTerm. - **VTE\_CJK\_WIDTH** Controls the width of some ideographs should be "single width (narrow)" or "double width (wide)" in a vte teminal.\ This environment should be set **before** creating a vte widget.\ In LilyTerm, you may set the VTE\_CJK\_WIDTH of a new tab to 'wide' with right click menu 'New tab with specified locale' -\> 'xx\_XX.UTF-8 (Wide)' or 'UTF-8 (Wide)'. - **PROMPT\_COMMAND** Customs the "Window Title" for shell.\ The following is a reasonable example ~/.bashrc for bash: case $TERM in\ \ xterm\*)\ PROMPT\_COMMAND='echo -ne "\\033\]0;${HOSTNAME}: ${PWD}\\007"'\ ;;\ \ \*)\ ;;\ esac The following is a reasonable example ~/.cshrc for csh/tcsh: switch ($TERM)\ case "xterm\*":\ setenv TITLE "%{\\033\]0;%m: %~\\007%}"\ breaksw\ endsw set prompt = "${TITLE}%# " Please visit *http://tldp.org/HOWTO/Xterm-Title.html* for more details. ## AUTHOR Lu, Chao-Ming (Tetralet) \ ## SEE ALSO [xterm(1)](/xterm/1.md)