ghalkes:~# command line tools

Tilde Terminal Toolkit

libt3key

The libt3key library provides functions for retrieving the character sequences used by terminals to represent keys pressed by the user. Although the terminfo database provides part of this information, it lacks information for the sequences returned by modern terminals/terminal emulators for many combinations of modifiers with other keys. For example, many terminal emulators provide separate character sequences for Control combined with the cursor keys, which is not stored in the terminfo database.

Many programs contain their own databases with this information. This library tries to be a database usable by many programs, such that all programs can benefit from the information collected.

News

libt3key version 0.2.10 released

This release shuffles a few keys around in the xterm keymap, to make it work on more terminals that claim to be xterm, and adds a link for rxvt-unicode-256color.

30-Nov-2019

libt3key version 0.2.9 released

This release adds those keybindings for mrxvt which are different from the rxvt bindings. It also removes support for Xlib (XCB is still supported) for the t3learnkeys program.

16-Mar-2018

libt3key version 0.2.8 released

This release updates the key database for the linux console to include the Application Keypad mode keys, and adds more fallbacks from the terminfo database.

04-Feb-2018

Documentation

The documentation for libt3key can be generated using doxygen, using the doxygen.conf file in the source package. Documentation for the latest version can also be found here. It includes descriptions of both the configuration files and the API.

Download

The source for libt3key is available here (signature). Older releases are available here. All releases are signed with the GPG key for gpg@ghalkes.nl (0x5A22F7B45F39DE51).

libt3key requires GNU libtool to be compiled. Furthermore, it requires (n)curses or ncurses's libtinfo for access to the terminfo database. The t3learnkeys program may be compiled with X11 support, in which case the XCB or Xlib libraries and headers are also required.

Binary packages for libt3key are available from the Tilde repositories.

Contact

You can reach me at: libt3key @ REMOVE ghalkes.nl.

Copyright Notice

Copyright © 2011-2019 G.P. Halkes
libt3key is distributed under the GNU General Public License version 3.