The vty package

[Tags: bsd3, library, program]

vty is terminal GUI library in the niche of ncurses. It is intended to be easy to use, have no confusing corner cases, and good support for common terminal types.

Included in the source distribution is a program test/interactive_terminal_test.hs that demonstrates the various features.

If your terminal is not behaving as expected the results of the test/interactive_terminal_test.hs program should be sent to the Vty maintainter to aid in debugging the issue.

Notable infelicities: Sometimes poor efficiency; Assumes UTF-8 character encoding support by the terminal;

You can 'darcs get' it from

© 2006-2007 Stefan O'Rear; BSD3 license.

© 2008-2009 Corey O'Connor; BSD3 license.

[Skip to ReadMe]


Versions3.0.0, 3.0.1, 3.0.2, 3.0.4, 3.1.0, 3.1.2, 3.1.4, 3.1.6, 3.1.8,,, 4.0.0,,,,,,,,,,,,,,,,,, 4.7.1, 4.7.2, 4.7.3, 4.7.4, 4.7.5, 5.0.0, 5.0.1, 5.0.2, 5.1.0, 5.1.1, 5.1.3, 5.1.4, 5.2.0, 5.2.1, 5.2.2, 5.2.3, 5.2.4, 5.2.5, 5.2.6, 5.2.7, 5.2.8, 5.2.9, 5.2.10, 5.2.11, 5.3, 5.3.1, 5.4.0
Change logNone available
Dependenciesarray, base (==4.*), bytestring, containers, ghc-prim, mtl (>= && <1.2), parallel, parsec (>=2 && <4), terminfo (==0.3.*), unix, utf8-string (==0.3.*) [details]
AuthorStefan O'Rear, Corey O'Connor
MaintainerCorey O'Connor (
CategoryUser Interfaces
Home page
UploadedThu Sep 3 04:00:32 UTC 2009 by CoreyOConnor
DistributionsDebian:5.3.1, NixOS:5.4.0, Stackage:5.4.0
Downloads18172 total (344 in last 30 days)
0 []
StatusDocs uploaded by user
Build status unknown [no reports yet]




Maintainers' corner

For package maintainers and hackage trustees

Readme for vty-

vty is a very simple terminal interface library.

Vty currently provides:

* Automatic handling of suspend/resume (SIGTSTP+SIGCONT).

* Automatic handling of window resizes.

* Supports Unicode characters on output, automatically setting and
  resetting UTF-8 mode (beware double width and combining characters!)

* Automatic computation of minimal differences.

* Minimizes repaint area, thus virtually eliminating the flicker
  problem that plagues ncurses programs.

* A pure, compositional interface for efficiently constructing display

* Automatically decodes keyboard keys into (key,[modifier]) tuples.

* Automatically supports refresh on Ctrl-L.

* Automatically supports timeout after 50ms for lone ESC (a barely
  noticable delay)

* Interface is designed for relatively easy compatible extension.

* Supports all ANSI SGR-modes (defined in console_codes(4)) with
  a simple type-safe interface.

* Properly handles cleanup, leaving the cursor at the bottom of
  the screen and erasing the last line.

Current disadvantages:

* No current support for non-ANSI terminals.

* UTF-8 support only works properly on the linux console/xterm,
  and even then only if it is not the system default.

* Minimal support for special keys on terminals other than the
  linux-console.  (F1-5 and arrow keys should work, but anything
  shifted isn't likely to.)

* Uses the TIOCGWINSZ ioctl to find the current window size, which
  appears to be limited to Linux and *BSD.

darcs get --tag=rel-3.0.0

To compile the demonstration program: ghc --make Test.hs gwinsz.c

The main documentation consists of the haddock-comments and the
demonstration program