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.
