Go to file
Daniel Micay 4ed94191a9 update README 2012-07-05 23:13:26 -04:00
.gitignore Add a .gitignore 2012-06-08 15:07:11 -04:00
Makefile Makefile: cleanup 2012-06-27 01:36:39 -04:00
README.rst update README 2012-07-05 23:13:26 -04:00
termite.c use the cursor-moved event to fix visual mode 2012-07-05 22:59:14 -04:00
termite.cfg expose option for wrapping scrollback search 2012-07-04 23:41:53 -04:00
termite.terminfo termite.terminfo: proper support for setting title 2012-06-25 23:19:58 -04:00
termite.vim add termite.vim to work around hardcoding in vim 2012-06-27 00:39:17 -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.30.

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

* ``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-shift-f``: start forward search
* ``ctrl-shift-b``: start reverse search
* ``ctrl-shift-j``: start forward url search
* ``ctrl-shift-k``: start reverse url search
* ``ctrl-shift-n``: jump to next search match
* ``ctrl-shift-p``: jump to previous search match
* ``ctrl-tab``: start scrollback completion
* ``ctrl-shift-space``: start selection mode

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

With the scrollback search/completion widget open, up/down cycle through
completions, escape closes the widget and enter accepts the input.

TEXT SELECTION MODE
-------------------

* ``escape``: deactivate selection mode
* ``v``: visual mode
* ``h``/``j``/``k``/``l`` or arrow keys: move cursor left/down/up/right

TODO
====

* tab and shift-tab bindings for completion
* better url matching regex
* hint mode overlay for urls (like elinks/vimperator/pentadactyl)
* scrollback search needs to be improved upstream [1]_
* expose keybindings in ``termite.cfg``

TEXT SELECTION
--------------

* _vte_terminal_select_text would be perfect for extending this, but it isn't
  exposed in the API
* does not currently work in ncurses applications
* needs to be extended to more than just the basic ``h``/``j``/``k``/``l``

.. [1] https://bugzilla.gnome.org/show_bug.cgi?id=627886