-
Notifications
You must be signed in to change notification settings - Fork 31
/
README
231 lines (156 loc) · 6.25 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
NAME
LilyTerm - A light and easy-to-use terminal emulator for X.
SYNOPSIS
lilyterm [-? | -h | --help] [-T TITLE | --title TITLE] [-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 COM
MAND | --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.
-t NUMBER | --tab NUMBER
Open multi tabs when starting up.
-n TAB NAMES | --tab_names TAB NAMES
Specify the tab names, separate with <Space>.
-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 ter
minated.
-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].
<Ctrl><> Disable/Enable hyperlinks, function keys and right
click menu for temporary.
<Ctrl><T> Add a New tab with current directory.
<Ctrl><PgUp/PgDn> Switch to Prev/Next tab.
<Ctrl><Home/End> Switch to First/Last tab.
<Ctrl><[/]> Move current tab Forward/Backward.
<Ctrl><Up/Down> Move current tab to First/Last.
<Ctrl><F1~F12> Switch to 1st ~ 12th tab.
<Ctrl><O> Select all the text in the Vte Terminal box.
<Ctrl><+/-/Enter> Increase/Decrease/Reset the font size of current
tab.
<Alt><F11/Enter> Switch between fullwindow/unfullwindow and
fullscreen/unfullscreen state.
<Shift><Left/Right> Emulate a mouse Scroll Up/Down event on Vte Termi
nal box.
<Shift><Up/Down> Asks to scroll Up/Down 1 line on Vte Terminal box.
<Shift><PgUp/PgDn> Asks to scroll Up/Down on Vte Terminal box.
<Ctrl><Delete/Insert>
Copy the text to clipboard / Paste the text in
clipboard.
<Shift><Delete/Insert>
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:
<Ctrl><Q>
Close current tab.
Using <Ctrl><D> or exit to close tabs is recommended.
<Ctrl><N>
Open a new window with current directory.
<Ctrl><E>
Rename the current tab.
FILE
/etc/xdg/lilyterm.conf System configure file
~/.config/lilyterm/default.conf Users profile.
Use [Save settings] in the right click menu to save the current tabs
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
<Ctrl><S> and <Ctrl><Q> dont 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 temi
nal.
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;${HOST
NAME}: ${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) <[email protected]>
SEE ALSO
xterm(1)