Skip to content
A keyboard-centric VTE-based terminal, aimed at use within a window manager with tiling and/or tabbing support.
C++ Python Makefile
Find file
New pull request


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.


The vte-ng project is required until VTE exposes the necessary functions for keyboard text selection and URL hints (if ever). A simple patch has been submitted upstream but they're unwilling to expose functionality that's not required by GNOME Terminal even if there's no extra maintenance (it already exists internally) and no additional backwards compatibility hazards.

If no browser is configured and $BROWSER is unset, xdg-open from xdg-utils is used as a fallback.


git clone --recursive
cd termite && make



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 selection 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

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

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

For example, with bash:

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


q or escape or ctrl-[ enter insert 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 a half screen up
ctrl-d move cursor a half screen down
ctrl-b move cursor a full screen up (back)
ctrl-f move cursor a full screen down (forward)
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 enter insert 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.


Internal padding can be added by using CSS to style the VTE widget. Adding the follow snippet to $XDG_CONFIG_HOME/gtk-3.0/gtk.css (or ~/.config/gtk-3.0/gtk.css) will add uniform 2px padding around the edges:

VteTerminal {
    padding: 2px;

This can also be used to add varying amounts of padding to each side via standard usage of the CSS padding property.

Something went wrong with that request. Please try again.