The vty package

[Tags:bsd3, library, program, test]

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-2010 Corey O'Connor; BSD3 license.

NOTE: This version is identical to except that the restriction on vector-space 0.5.* has been lifted; i.e. nothing has changed except the Cabal file.

[Skip to Readme]


Versions 3.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, 5.5.0, 5.6, 5.7, 5.7.1, 5.8, 5.8.1, 5.9, 5.9.1, 5.10, 5.11, 5.11.1, 5.11.2, 5.11.3, 5.12, 5.13, 5.14, 5.15, 5.15.1, 5.16, 5.17 (info)
Dependencies array, base (==4.*), bytestring, containers, deepseq (==1.1.*), ghc-prim, mtl (>= && <1.2), parallel (==2.2.*), parsec (>=2 && <4), terminfo (==0.3.*), unix, utf8-string (==0.3.*), vector-space (>=0.5 && <0.8) [details]
License BSD3
Author Stefan O'Rear, Corey O'Connor
Maintainer Corey O'Connor (
Category User Interfaces
Home page
Uploaded Thu Oct 21 11:42:54 UTC 2010 by PeterSimons
Distributions Arch:5.17, Debian:5.4.0, LTSHaskell:5.16, NixOS:5.17, Stackage:5.17, Tumbleweed:5.15.1
Downloads 25017 total (662 in the last 30 days)
0 []
Status Docs uploaded by user
Build status unknown [no reports yet]
Hackage Matrix CI




Maintainer's Corner

For package maintainers and hackage trustees

Readme for vty

Readme for vty-

vty is a terminal interface library.

Vty currently provides:

* Automatic handling of window resizes.

* Supports Unicode characters on output, automatically setting and
  resetting UTF-8 mode for xterm. Other terminals are assumed to support 

* Efficient output. 

* 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 type-safe interface. 

* Properly handles cleanup.

Current disadvantages:

* The character encoding of the output terminal is assumed to be UTF-8.

* 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=vty-

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

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