2013-03-29 03:37:29 -07:00
. \" Manpage for Terminology
2014-08-09 02:46:47 -07:00
.TH man 1 "09 August 2014" "0.7" "Terminology man page"
2013-03-29 03:37:29 -07:00
.SH NAME
2014-01-02 05:11:33 -08:00
Terminology \- Terminal Emulator written with EFL (Enlightenment Foundation Libraries).
2013-03-29 03:37:29 -07:00
.SH SYNOPSIS
.B terminology [options]
.SH DESCRIPTION
This is an EFL terminal emulator with some extra bells and whistles.
It has many features including split terminal support, support for tabs, preview
2013-11-16 06:27:18 -08:00
icons for files and so on...
2013-03-29 03:37:29 -07:00
.SH OPTIONS
.
.TP
.B \- e, \- \- exec <cmnd>
Specify command to execute.
2014-08-09 02:46:47 -07:00
Defaults to \fB $SHELL\fP (or passwd shell or \fB /bin/sh\fP )
When used along with \fB \- S\fP /\fB \- \- split\fP , each argument is used as a command for a
split, leaving away the extra arguments.
With 3 splits, one vertical, a command on the right, an horizontal split on
the left with only a command on the bottom, the following arguments should be used:
\fB \- \- split v\- h\- \- \- e command1 $SHELL command2\fP
2013-03-29 03:37:29 -07:00
.
.TP
.B \- d=CURRENT-DIRECTORY, \- \- current\-directory=CURRENT-DIRECTORY
Change to directory for execution of terminal command.
Type: STR.
.
.TP
.B \- t=THEME, \- \- theme=THEME
Use the named edje theme or path to theme file.
Type: STR.
.
.TP
.B \- b=BACKGROUND, \- \- background=BACKGROUND
Use the named file as a background wallpaper for terminology.
Type: STR.
.
.TP
.B \- g=GEOMETRY, \- \- geometry=GEOMETRY
Terminal geometry to use (eg 80x24 or 80x24+50+20 etc.).
Type: STR.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- n=NAME, \- \- name=NAME
Set window name.
2013-03-29 03:37:29 -07:00
Type: STR.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- r=ROLE, \- \- role=ROLE
2013-03-29 03:37:29 -07:00
Set window role.
Type: STR.
.
.TP
2014-08-09 02:46:47 -07:00
.B \- s=vh\-, \- \- split=vh\-
Terminology can start with splits opened as described below.
The arguments are a string with the following characters:
\fB \- s v\fP splits terminal vertically
\fB \- s h\fP splits horizontally
\fB \- \fP defines a placeholder for a shell or a command when used with
\fB \- \- exec\fP /\fB \- e\fP
Examples:
______
| | |
$ \fB terminology -s v\fP |__|__|
______
|_____|
$ \fB terminology -s h\fP |_____|
______
|__| |
$ \fB terminology -s vh\fP |__|__|
______
| |__|
$ \fB terminology -s v-h\fP |__|__|
______
$ \fB terminology -s vh--h\fP |__|__|
\fB hv--v\fP |__|__|
Type: STR.
.
.TP
2013-03-29 03:37:29 -07:00
.B \- T=TITLE, \- \- title=TITLE
Set window title.
Type: STR.
.
.TP
.B \- i=ICON\-NAME, \- \- icon-name=ICON\-NAME
Set icon name.
Type: STR.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- f=FONT, \- \- font=FONT
2013-03-29 03:37:29 -07:00
Set font (NAME/SIZE for scalable, NAME for bitmap.
Type: STR.
.
.TP
.B \- v=VIDEO\-MODULE, \- \- video-module=VIDEO\-MODULE
Set emotion module to use. Choices are: auto, gstreamer, xine, generic.
.
2013-11-28 01:08:53 -08:00
.TP
2013-03-29 03:37:29 -07:00
.B \- l=LOGIN, \- \- login=LOGIN
Run the shell as a login shell.
Type: BOOL.
.
.TP
.B \- m=VIDEO\-MUTE, \- \- video-mute=VIDEO\-MUTE
Set mute mode for video playback.
Type: BOOL.
.
.TP
.B \- c=CURSOR\-BLINK, \- \- cursor-blink=CURSOR\-BLINK
Set cursor blink mode.
Type: BOOL.
.
.TP
.B \- G=VISUAL\-BELL, \- \- visual\-bell=VISUAL\-BELL
Set visual bell mode.
Type: BOOL.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- F, \- \- fullscreen
2013-03-29 03:37:29 -07:00
Go into the fullscreen mode from start.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- I, \- \- iconic
2013-03-29 03:37:29 -07:00
Go into an iconic state from the start.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- B, \- \- borderless
2013-03-29 03:37:29 -07:00
Become a borderless managed window.
.
.TP
.B \- O, \- \- override
Become an override-redirect window.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- M, \- \- maximized
2013-03-29 03:37:29 -07:00
Become maximized from the start.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- W, \- \- nowm
2013-03-29 03:37:29 -07:00
Terminology is run without a wm.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- H, \- \- hold
2013-03-29 03:37:29 -07:00
Don't exit when the command process exits.
.
.TP
.B \- s, \- \- single
Force single executable if multi-instance is enabled..
.
.TP
2013-06-16 14:07:58 -07:00
.B \- 2 , \- \- 256 color
Set TERM to \fB xterm-256color\fP instead of \fB xterm\fP .
.
.TP
2014-04-11 12:29:26 -07:00
.B \- \- active\-links=ACTIVATE\-LINKS
Whether to highlight links.
Type: BOOL.
.
.TP
2013-03-29 03:37:29 -07:00
.B \- V, \- \- version
Show program version.
.
.TP
2013-11-16 06:27:18 -08:00
.B \- C, \- \- copyright
2013-03-29 03:37:29 -07:00
Show copyright.
.
.TP
.B \- L, \- \- license
Show license.
.
.TP
.B \- h, \- \- help
Show this message.
.SH CONTROLS / SHORTCUTS
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+PgUp
2013-03-29 03:37:29 -07:00
Scroll terminology one page up
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+PgDn
2013-03-29 03:37:29 -07:00
Scroll terminology one page down
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Insert
2013-03-29 03:37:29 -07:00
Paste Clipboard (ctrl+v/c) selection
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Ctrl+Insert
2013-03-29 03:37:29 -07:00
Paste Primary (highlight) selection
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Plus
2013-03-29 03:37:29 -07:00
Font size up by one unit.
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Minus
2013-03-29 03:37:29 -07:00
Font size down by one unit.
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Multiply
2013-03-29 03:37:29 -07:00
Reset font size to 10.
.
.TP
2013-11-16 06:27:18 -08:00
.B Shift+Keypad\-Divide
2013-03-29 03:37:29 -07:00
Copy highlight to Clipboard (same as ctrl+c in gui apps).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+PgUp
2013-03-29 03:37:29 -07:00
Switch focus to previous terminal inside a window (when using splits).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+PgDn
2013-03-29 03:37:29 -07:00
Switch focus to next terminal inside a window (when using splits).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+t
2013-03-29 03:37:29 -07:00
Create a new terminal on top of current inside window (tabs).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+Home
2013-03-29 03:37:29 -07:00
Bring up "tab" switcher.
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+PgUp
2013-03-29 03:37:29 -07:00
Split terminal horizontally (one terminal above the other).
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+PgDn
2013-03-29 03:37:29 -07:00
Split terminal vertically (one terminal to the left of the other).
.
.TP
2013-11-16 06:27:18 -08:00
.B Alt+Home
2013-03-29 03:37:29 -07:00
Enter command mode (enter commands to control terminology itself)
.
.TP
2013-11-16 06:27:18 -08:00
.B Alt+Return
2013-03-29 03:37:29 -07:00
Paste primary selection.
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+c
2013-03-29 03:37:29 -07:00
Copy current selection to clipboard.
.
.TP
2013-11-16 06:27:18 -08:00
.B Ctrl+Shift+v
2013-03-29 03:37:29 -07:00
Paste current clipboard selection.
2013-04-28 08:44:49 -07:00
.
.TP
2013-05-06 22:51:02 -07:00
.B Ctrl+1 through Ctrl+0
2013-04-28 08:44:49 -07:00
Switch to terminal tab 1 through 10
2014-07-05 05:17:57 -07:00
.
.TP
.B Ctrl+Shift+h
Toggle displaying the miniview of the history.
2013-03-29 03:37:29 -07:00
.SH MOUSE CONTROLS
.
.TP
.B Right mouse click
Bring up controls menus.
.
.TP
.B Middle mouse click
Paste highlight selection.
.
.TP
.B Left mouse click/drag
Make a selection highlight.
.
.TP
.B Ctrl + Left mouse click/drag
Make a block selection.
.
.TP
.B Wheel
Scroll up or down in history.
.
.TP
.B Ctrl + Wheel
Zoom font size up/down.
.SH COMMAND MODE COMMANDS
To enter command mode in terminology press Alt+Home. Currently command mode
understands the following commands:
.
.TP
.B f
Reset font to default setting saved in config.
.
.TP
.B f+
Increase font size. Note that it works on scalable fonts only.
.
.TP
.B f\-
Decrease font size. Note that it works on scalable fonts only.
.
.TP
.B fb
Display big font size (10x20 bitmap, or size 20 with scalable).
.
.TP
2013-11-16 06:27:18 -08:00
.B gNxM
2013-03-29 03:37:29 -07:00
Make terminal NxM chars in size (if possible). e.g. g80x48 g40x20.
If just one number is provided, it will use the following shortcuts:
g0=80x24; g1=80x40; g2=80x60; g3=80x80; g4=120x24; g5=120x40; g6=120x60;
g7=120x80; g8=120x120
.
.TP
2013-11-16 06:27:18 -08:00
.B b
2013-03-29 03:37:29 -07:00
Reset the background (no media)
.
.TP
2013-11-16 06:27:18 -08:00
.B bPATH
2013-03-29 03:37:29 -07:00
Set the background media to an absolute file PATH
2014-02-26 14:03:27 -08:00
.SH THEMES:
Themes can be stored in ~/.config/terminology/themes/ .
2013-03-29 03:37:29 -07:00
.SH EXTENDED ESCAPES FOR TERMINOLOGY:
.
.TP
.B [\\\033][}][COMMAND][\\\000]
i.e.
1. ESC char (\\ 033 or 0x1b)
2. } char
3... sequence of UTF8 chars other than nul (\\ 000 or 0x00).
4 \\ 000 char (nul byte or 0x00 to indicate end of sequence)
e.g.
2014-02-03 08:11:38 -08:00
echo \- n '\\ 033}Hello world\\ 000'
2013-11-16 06:27:18 -08:00
2013-03-29 03:37:29 -07:00
.B Commands:
2014-02-03 08:11:38 -08:00
any values inside square brackets [] are to be replaced by some content (numbers, strings, paths, url's etc.). example:
2013-03-29 03:37:29 -07:00
aa[PATH\- OF\- FILE] should be come something like:
2014-08-05 11:38:09 -07:00
aa/tmp/file.png
2013-03-29 03:37:29 -07:00
or aa[true/false] should become something like:
2014-08-05 11:38:09 -07:00
aatrue
2013-03-29 03:37:29 -07:00
or
2014-08-05 11:38:09 -07:00
aafalse
2013-03-29 03:37:29 -07:00
\- \- \-
pn[FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
popup the given media file/url now
2013-03-29 03:37:29 -07:00
pq[FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
quque a popup for the given media file/url
2013-03-29 03:37:29 -07:00
bt[FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
set the terminal background media file/url temporarily
2013-03-29 03:37:29 -07:00
bp[FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
set the terminal background media file/url permanently
2013-03-29 03:37:29 -07:00
at[on/true/yes/off/false/no]
2014-02-03 08:11:38 -08:00
set the terminal alpha state to be on, or off temporarily
2013-03-29 03:37:29 -07:00
ap[on/true/yes/off/false/no]
2014-02-03 08:11:38 -08:00
set the terminal alpha state to be on, or off permanently
2013-03-29 03:37:29 -07:00
qs
2014-02-03 08:11:38 -08:00
query grid and font size. stdin will have written to it:
2014-08-05 11:38:09 -07:00
W;H;FW;FH
where W is the width of the terminal grid in characters
where H is the height of the terminal grid in characters
where FW is the width of 1 character cell in pixels
where FH is the height of 1 character cell in pixels
2013-03-29 03:37:29 -07:00
is[CW;H;FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
insert STRETCHED media (where image will stretch to fill the
cell area) and define expected cell area to be W cells
2014-08-05 11:38:09 -07:00
wide and H cells high, with the image/media/url.
2014-02-03 08:11:38 -08:00
where C is the replace character to be identified in later
2014-08-05 11:38:09 -07:00
text where W is the width in character cells (up to 511).
where H is the height in character cells (up to 511).
2013-11-16 06:27:18 -08:00
2014-08-05 11:38:09 -07:00
note that this escape alone has no effect. it indicates a future intention of inserting media into the terminal. the terminal will EXPECT a grid of WxH "replace characters" to follow, with each sequence of such replace characters bebung with a 'ib' escape command and ending with an 'ie' escape command.
2013-11-16 06:27:18 -08:00
2014-02-03 08:11:38 -08:00
the FULL\- PATH\- OR\- URL for all the i commands (is, ic, if, it) may be of the form:
2013-11-16 06:27:18 -08:00
2014-02-03 08:11:38 -08:00
/full/path/to/file.png
2013-11-16 06:27:18 -08:00
2014-02-03 08:11:38 -08:00
OR
2013-11-16 06:27:18 -08:00
2014-02-03 08:11:38 -08:00
/full/path/to/link\n /full/path/to/file.png
2013-11-16 06:27:18 -08:00
2014-02-03 08:11:38 -08:00
where a newline character separates a URI for a link and
a full path to a file to display in the region. the link
is the destination URI when a user may clikc on the given
media image.
2013-11-16 06:27:18 -08:00
2013-03-29 03:37:29 -07:00
example:
2013-11-16 06:27:18 -08:00
2013-03-29 03:37:29 -07:00
printf("\\ \0 33}is#5;3;%s\0 00"
"\\ \0 33}ib#####\\ \0 33}ie\\ \n "
"\\ \0 33}ib#####\\ \0 33}ie\\ \n "
"\\ \0 33}ib#####\\ \0 33}ie\\ \n ", "/tmp/icon.png");
2013-11-16 06:27:18 -08:00
2014-02-03 08:11:38 -08:00
note that '#' is the replace character, and later '#' chars if inside begin/end escapes, will be replaced by the given media indicated in the insert media escape.
2013-03-29 03:37:29 -07:00
ic[CW;H;FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
insert CENTERED media (centered in cell area). otherwise
paramaters are identical to the "is" command, but
retains aspect and is padded by blank space.
2013-03-29 03:37:29 -07:00
if[CW;H;FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
insert FILLED media (fill in cell area). otherwise paramaters
are identical to the "is" command but ensures the entire
area is filled like a background even if media goes beyond
cell bounds and is clipped.
2013-03-29 03:37:29 -07:00
it[CW;H;FULL\- PATH\- OR\- URL]
2014-02-03 08:11:38 -08:00
insert THUMB media (thumbnail cell area). otherwise paramaters
are identical to the "is" command, but uses thumbnail
generation to make a fast to load but low resolution version
(cached) of the media.
2013-03-29 03:37:29 -07:00
ib
2014-02-03 08:11:38 -08:00
begin media replace sequence run
2013-03-29 03:37:29 -07:00
ie
2014-02-03 08:11:38 -08:00
end media replace sequence run
2013-03-29 03:37:29 -07:00
.SH BUGS
2014-02-03 08:11:38 -08:00
If you find a bug or for known issues/bugs/feature requests please email enlightenment-devel@lists.sourceforge.net or visit the place where all the hard work is done http://phab.enlightenment.org/
2013-03-29 03:37:29 -07:00
.SH AUTHOR
2014-02-03 08:11:38 -08:00
Terminology was written by Carsten Haitzler <raster@rasterman.com> and others. See AUTHORS file for other contributors.