termite/README.rst

125 lines
7.3 KiB
ReStructuredText
Raw Normal View History

2012-05-22 09:33:36 +02:00
A simple VTE-based terminal.
2012-06-08 03:14:22 +02:00
Termite looks for ``termite.cfg`` in ``$XDG_CONFIG_HOME`` (or ``~/.config`` if
unset) and then falls back to ``$XDG_CONFIG_DIRS``.
2012-05-23 11:34:02 +02:00
2012-05-23 10:31:25 +02:00
DEPENDENCIES
============
A vte version >= ``0.34``. A patch is required to expose the functions needed
for keyboard selection.
2012-05-23 10:31:25 +02:00
2012-05-22 10:59:57 +02:00
KEYBINDINGS
===========
2012-09-29 13:44:07 +02:00
INSERT MODE
-----------
2012-11-16 20:55:56 +01:00
+----------------------+---------------------------------------------+
| ``ctrl-shift-x`` | activate url hints mode |
2012-11-16 20:31:31 +01:00
+----------------------+---------------------------------------------+
| ``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:
.. code:: sh
if [[ $TERM == xterm-termite ]]; then
. /etc/profile.d/vte.sh
__vte_ps1
chpwd() {
__vte_ps1
}
fi
2012-06-07 04:12:08 +02:00
2012-07-11 09:46:27 +02:00
COMMAND MODE
2012-08-24 16:59:57 +02:00
------------
2012-08-24 16:53:39 +02:00
+------------------------+-----------------------------------------------------------+
| ``escape`` | deactivate command mode |
+------------------------+-----------------------------------------------------------+
2012-09-29 13:44:07 +02:00
| ``x`` | activate url hints mode |
2012-09-18 11:37:36 +02:00
+------------------------+-----------------------------------------------------------+
2012-08-24 16:53:39 +02:00
| ``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 |
2012-08-24 16:53:39 +02:00
+------------------------+-----------------------------------------------------------+
| ``b`` or shift-left | backward word |
+------------------------+-----------------------------------------------------------+
| ``W`` or ctrl-right | forward WORD (non-whitespace) |
+------------------------+-----------------------------------------------------------+
2012-10-02 17:22:16 +02:00
| ``B`` or ctrl-left | backward WORD (non-whitespace) |
2012-09-08 07:10:29 +02:00
+------------------------+-----------------------------------------------------------+
| ``0`` | move cursor to the first column in the row |
+------------------------+-----------------------------------------------------------+
| ``^`` | beginning-of-line (first non-blank character) |
2012-08-24 16:53:39 +02:00
+------------------------+-----------------------------------------------------------+
| ``$`` | end-of-line |
2012-08-24 16:53:39 +02:00
+------------------------+-----------------------------------------------------------+
| ``g`` | jump to start of first row |
+------------------------+-----------------------------------------------------------+
| ``G`` | jump to start of last row |
+------------------------+-----------------------------------------------------------+
2012-11-24 23:25:17 +01:00
| ctrl-u | move cursor half a screen up |
+------------------------+-----------------------------------------------------------+
| ctrl-d | move cursor half a screen down |
+------------------------+-----------------------------------------------------------+
2012-08-24 16:53:39 +02:00
| ``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 |
+------------------------+-----------------------------------------------------------+
2012-07-11 09:46:27 +02:00
During scrollback search, the current selection is changed to the search match
and copied to the PRIMARY clipboard buffer.
2012-09-29 13:48:21 +02:00
With the text input widget focused, up/down (or tab/shift-tab) cycle through
completions, escape closes the widget and enter accepts the input.
2012-09-29 13:44:07 +02:00
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.