Skip to content
This repository

A keyboard-centric VTE-based terminal, aimed at use within a window manager with tiling and/or tabbing support.

branch: master
README.rst

A keyboard-centric VTE-based terminal, aimed at use within a window manager with tiling and/or tabbing support.

Termite looks for the configuration file in the following order: $XDG_CONFIG_HOME/termite/config, ~/.config/termite/config, $XDG_CONFIG_DIRS/termite/config, /etc/xdg/termite/config.

Termite's exit status is 1 on a failure, including a termination of the child process from an uncaught signal. Otherwise the exit status is that of the child process.

DEPENDENCIES

A vte version >= 0.34. A patch is required to expose the functions needed for keyboard selection.

BUILDING

git clone --recursive https://github.com/thestinger/termite.git
cd termite && make

KEYBINDINGS

INSERT MODE

ctrl-shift-x activate url hints mode
ctrl-shift-r reload configuration file
ctrl-shift-c copy to CLIPBOARD
ctrl-shift-v paste from CLIPBOARD
ctrl-shift-u unicode input (standard GTK binding)
ctrl-tab start scrollback completion
ctrl-shift-space start command mode
ctrl-shift-t open terminal in the current directory [1]
ctrl-shift-up scroll up a line
ctrl-shift-down scroll down a line
shift-pageup scroll up a page
shift-pagedown scroll down a page
[1]

The directory can be set by a process running in the terminal. For example, with zsh:

if [[ $TERM == xterm-termite ]]; then
  . /etc/profile.d/vte.sh
  __vte_osc7
fi

For example, with bash:

if [[ $TERM == xterm-termite ]]; then
  . /etc/profile.d/vte.sh
  __vte_prompt_command
fi

COMMAND MODE

escape or ctrl-[ deactivate command mode
x activate url hints mode
v visual mode
V visual line mode
ctrl-v visual block mode
hjkl or arrow keys move cursor left/down/up/right
w or shift-right forward word
b or shift-left backward word
W or ctrl-right forward WORD (non-whitespace)
B or ctrl-left backward WORD (non-whitespace)
0 move cursor to the first column in the row
^ beginning-of-line (first non-blank character)
$ end-of-line
g jump to start of first row
G jump to start of last row
ctrl-u move cursor half a screen up
ctrl-d move cursor half a screen down
y copy to CLIPBOARD
/ forward search
? reverse search
u forward url search
U reverse url search
o open the current selection as a url
Return open the current selection as a url and exit command mode
n next search match
N previous search match
+ increase font size
- decrease font size

During scrollback search, the current selection is changed to the search match and copied to the PRIMARY clipboard buffer.

With the text input widget focused, up/down (or tab/shift-tab) cycle through completions, escape closes the widget and enter accepts the input.

In hints mode, the input will be accepted as soon as termite considers it a unique match.

Something went wrong with that request. Please try again.