Go to file
Daniel Micay d9486de556 update docs to run __vte_ps1 on new shells too 2012-11-07 12:08:05 -05:00
util@d7ca0bd7db no need for templated function to be static 2012-10-14 15:08:06 -04:00
.gitignore Add a .gitignore 2012-06-08 15:07:11 -04:00
.gitmodules add util repo as submodule 2012-10-05 10:57:49 -04:00
Makefile Makefile: fix deps for install target 2012-10-26 23:19:37 -04:00
README.rst update docs to run __vte_ps1 on new shells too 2012-11-07 12:08:05 -05:00
TODO.rst document the existence of url hints 2012-09-18 05:37:36 -04:00
expose_select_text.patch no longer need to set cursor visibility 2012-08-30 04:32:03 -04:00
termite.cc add support for opening terminal in set directory 2012-10-21 18:50:23 -04:00
termite.cfg Merge remote-tracking branch 'origin/better-hints' 2012-10-14 13:48:47 -04:00
termite.desktop termite.desktop: Utility -> System 2012-10-27 16:30:59 -04:00
termite.terminfo add terminfo for italic, support was added in vte 2012-10-08 17:05:54 -04:00
url_regex.hh url_regex.hh: make path component optional 2012-10-07 11:45:37 -04:00

README.rst

A simple VTE-based terminal.

Termite looks for ``termite.cfg`` in ``$XDG_CONFIG_HOME`` (or ``~/.config`` if
unset) and then falls back to ``$XDG_CONFIG_DIRS``.

DEPENDENCIES
============

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

KEYBINDINGS
===========

INSERT MODE
-----------

+-----------------------+---------------------------------------------+
| ``ctrl-shift-escape`` | 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]_ |
+-----------------------+---------------------------------------------+

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

       .. code:: sh

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

              __vte_ps1

              chpwd() {
                __vte_ps1
              }
            fi


COMMAND MODE
------------

+------------------------+-----------------------------------------------------------+
| ``escape``             | 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)                            |
+------------------------+-----------------------------------------------------------+
| ``$``                  | end-of-line                                               |
+------------------------+-----------------------------------------------------------+
| ``^``                  | beginning-of-line                                         |
+------------------------+-----------------------------------------------------------+
| ``g``                  | jump to start of first row                                |
+------------------------+-----------------------------------------------------------+
| ``G``                  | jump to start of last row                                 |
+------------------------+-----------------------------------------------------------+
| ``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                                     |
+------------------------+-----------------------------------------------------------+

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.

After hints mode is activated, as single number or a comma separated list of
hint numbers can be entered, which will be opened in the browser.