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.1 released

This release moves the location for per-user configuration files in accordance with the XDG Base Directory Specification. Furthermore, a show-only mode is introduced for t3learnkeys, which allows easy printing of the sequences produced by specific keystrokes.

22-Mar-2012

libt3key version 0.2.0 released

This release replaces the custom storage backend by libt3config. To achieve this, the strings describing the keys have changed, making this an incompatible upgrade.

06-Jan-2012

libt3key version 0.1.5 released

This release adds a description for PuTTY (when configured to set TERM to putty) and fixes the build scripts to avoid older XCB versions.

Download

The source for libt3key is available here. Older releases are available here. 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-2012 G.P. Halkes
libt3key is distributed under the GNU General Public License version 3.