File: README

package info (click to toggle)
lilyterm 0.9.9.4+git20150208.f600c0-5
  • links: PTS, VCS
  • area: main
  • in suites: buster, sid, stretch
  • size: 1,908 kB
  • ctags: 1,415
  • sloc: ansic: 17,821; sh: 910; makefile: 508; xml: 13
file content (231 lines) | stat: -rw-r--r-- 6,395 bytes parent folder | download
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 eazy-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) <tetralet@gmail.com>

SEE ALSO
       xterm(1)