lilyterm(1)

1LilyTerm(1)        A light and eazy-to-use terminal emulator       LilyTerm(1)
2
3
4

NAME

6       LilyTerm - A light and eazy-to-use terminal emulator for X.
7

SYNOPSIS

9       lilyterm [-? | -h | --help] [-v | --version] [-d DIRECTORY | --direc‐
10                tory DIRECTORY] [-g GEOMETRY | --geometry GEOMETRY] [-l | -ls
11                | --login] [-H | --hold] [-p | --profile] [-s | --separate]
12                [-T TITLE | --title TITLE] [-t NUMBER | --tab NUMBER] [-u PRO‐
13                FILE | --user_profile PROFILE] [-e COMMAND | -x COMMAND |
14                --execute COMMAND]
15

DESCRIPTION

17       LilyTerm is a terminal emulator for the X Window System, based on the
18       libvte library, and aims to be fast and lightweight.
19

OPTIONS

21       -? | -h | --help
22           Display a brief help message.
23
24       -v | --version
25           Show the version information.
26
27       -d DIRECTORY | --directory DIRECTORY
28           Specify the init directory when starting up.
29
30       -g GEOMETRY | --geometry GEOMETRY
31           Specify the geometry of window when starting.
32           A reasonable example value is "80x24+0+0", witch means "width x
33           height {+-} xoffset {+-} yoffset" (without space).
34
35       -l | -ls | --login
36           Make the shell invoked as a login shell.
37
38       -H | --hold
39           Hold the terminal window open when the command following -e/-x ter‐
40           minated.
41
42       -p | --profile
43           Got a profile sample.
44
45       -s | --separate
46           Run in separate process.
47
48       -T TITLE | --title TITLE
49           Specify the window title.
50
51       -t NUMBER | --tab NUMBER
52           Open multi tabs when starting up.
53
54       -u PROFILE | --user_profile PROFILE
55           Use a specified profile.
56
57       -e COMMAND | -x COMMAND | --execute COMMAND
58           Run a command when starting up. Must be the final option.
59
60

KEYBOARD CONTROL

62       The following key bindings may custom or disable by the right click
63       menu [Set key binding].
64
65       <Ctrl><`>           Disable/Enable hyperlinks, function keys and right
66                           click menu for temporary.
67
68       <Ctrl><T>           Add a New tab with current directory.
69
70       <Ctrl><PgUp/PgDn>   Switch to Prev/Next tab.
71
72       <Ctrl><Home/End>    Switch to First/Last tab.
73
74       <Ctrl><[/]>         Move current tab Forward/Backward.
75
76       <Ctrl><Up/Down>     Move current tab to First/Last.
77
78       <Ctrl><F1~F12>      Switch to 1st ~ 12th tab.
79
80       <Ctrl><O>           Select all the text in the Vte Terminal box.
81
82       <Ctrl><+/-/Enter>   Increase/Decrease/Reset the font size of current
83                           tab.
84
85       <Alt><F11/Enter>    Switch between fullwindow/unfullwindow and
86                           fullscreen/unfullscreen state.
87
88       <Shift><Left/Right> Emulate a mouse Scroll Up/Down event on Vte Termi‐
89                           nal box.
90
91       <Shift><Up/Down>    Asks to scroll Up/Down 1 line on Vte Terminal box.
92
93       <Shift><PgUp/PgDn>  Asks to scroll Up/Down on Vte Terminal box.
94
95       <Ctrl><Delete/Insert>
96                           Copy the text to clipboard / Paste the text in
97                           clipboard.
98
99       <Shift><Delete/Insert>
100                           Copy the text to primary clipboard / Paste the text
101                           in primary clipboard.
102                           i.e. Emulate a middle button mouse click to
103                           copy/paste the text.
104
105       Some key bindings that disabled by default but maybe useful:
106
107       <Ctrl><Q>
108              Close current tab.
109              Using <Ctrl><D> or 'exit' to close tabs is recommended.
110
111       <Ctrl><N>
112              Open a new window with current directory. (had been disabled by
113              default)
114
115       <Ctrl><E>
116              Rename the current tab. (had been disabled by default)
117

FILE

119       /etc/xdg/lilyterm.conf          System configure file
120
121       ~/.config/lilyterm/default.conf User's profile.
122
123       Use [Save settings] in the right click menu to save the current tab's
124       settings as default to the specified profile.
125

TIPS

127       Display UTF-8 character under C locale
128
129           Execute the following command under LilyTerm:
130
131               bind "set convert-meta off"
132               bind "set output-meta on"
133
134           And use the right click menu to set the text encoding to "UTF-8".
135
136       Launch LilyTerm under a chroot jail
137
138           Extract xauth info to a file (under X):
139
140               xauth extract /PathToChroot/tmp/display $DISPLAY
141
142           Mount the devpts device and /tmp (may not necessary) before chroot
143           into a chroot jail:
144
145               mount /dev/pts /PathToChroot/dev/pts -t devpts
146               mount -o bind /tmp /PathToChroot/tmp (may not necessary)
147
148           Merge the extracted xauth info and set the DISPLAY environ after
149           chroot into the chroot jail:
150
151               xauth merge /tmp/display
152               export DISPLAY=:0
153
154           Launch LilyTerm directly, or run it under Xnest/Xephyr:
155
156               xinit ~/.xinitrc -- /usr/bin/Xnest :1 -ac -geometry 800x600
157
158           or
159
160               xinit ~/.xinitrc -- /usr/bin/Xephyr :1 -ac -screen 800x600
161
162       <Ctrl><S> and <Ctrl><Q> don't work under VIM:
163
164           Use the following command to turn off 'flow-Control' under
165           LilyTerm:
166
167               stty raw
168
169           or
170
171               stty -ixon
172
173
174       BSD Users:
175
176           Please mount the procfs before launch LilyTerm:
177
178               mount -t procfs procfs /proc
179

ENVIRONMENT

181       TERM           Sets what type of terminal attempts to emulate. Please
182                      always set to "xterm" under LilyTerm.
183
184       VTE_CJK_WIDTH  Controls the width of some ideographs should be "single
185                      width (narrow)" or "double width (wide)" in a vte temi‐
186                      nal.
187                      This environment should be set before creating a vte
188                      widget.
189                      In LilyTerm, you may set the VTE_CJK_WIDTH of a new tab
190                      to 'wide' with right click menu 'New tab with specified
191                      locale' -> 'xx_XX.UTF-8 (Wide)' or 'UTF-8 (Wide)'.
192
193       PROMPT_COMMAND Customs the "Window Title" for shell.
194                      The following is a reasonable example ~/.bashrc for
195                      bash:
196
197                          case $TERM in
198                              xterm*)
199                                  PROMPT_COMMAND='echo -ne "\033]0;${HOST‐
200                          NAME}: ${PWD}\007"'
201                                  ;;
202                              *)
203                                  ;;
204                          esac
205
206                      The following is a reasonable example ~/.cshrc for
207                      csh/tcsh:
208
209                          switch ($TERM)
210                              case "xterm*":
211                                  setenv TITLE "%{\033]0;%m: %~\007%}"
212                                  breaksw
213                          endsw
214
215                          set prompt = "${TITLE}%# "
216
217                      Please visit http://tldp.org/HOWTO/Xterm-Title.html for
218                      more details.
219

AUTHOR

221       Lu, Chao-Ming (Tetralet) <tetralet@gmail.com>
222