vty: A simple terminal UI library

[ bsd3, library, program, user-interfaces ] [ Propose Tags ]

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.

Developers: See the Graphics.Vty module.

Users: See the Graphics.Vty.Config module.

If your terminal is not behaving as expected the results of the vty-interactive-terminal-test executable should be sent to the Vty maintainter to aid in debugging the issue.

Notable infelicities: Assumes UTF-8 character encoding support by the terminal; Poor signal handling; Requires terminfo.

Project is hosted on github.com: https://github.com/coreyoconnor/vty

git clone git://github.com/coreyoconnor/vty.git

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

© Corey O'Connor; BSD3 license.

[Skip to Readme]
Versions [faq] 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, 5.17.1, 5.18, 5.18.1, 5.19, 5.19.1, 5.19.2, 5.20, 5.21, 5.22, 5.23, 5.23.1, 5.24, 5.24.1, 5.25, 5.25.1, 5.26, 5.27, 5.28, 5.28.1, 5.28.2 (info)
Change log CHANGELOG
Dependencies base (>=4.6 && <5), blaze-builder (>= && <0.4), bytestring, containers, data-default (>=0.5.3), deepseq (>=1.1 && <1.4), directory, filepath (>=1.0 && <2.0), hashable (>=1.2), lens (>= && <4.7), mtl (>= && <2.3), parallel (>=2.2 && <3.3), parsec (>=2 && <4), terminfo (>=0.3 && <0.5), text (>=0.11.3), transformers (>=, unix, utf8-string (==0.3.*), vector (>=0.7), vty [details]
License BSD-3-Clause
Maintainer Corey O'Connor (coreyoconnor@gmail.com)
Revised Revision 1 made by HerbertValerioRiedel at 2018-10-01T17:52:07Z
Category User Interfaces
Home page https://github.com/coreyoconnor/vty
Uploaded by CoreyOConnor at 2014-11-24T21:24:01Z
Distributions Arch:5.28.2, Debian:5.21, Fedora:5.25.1, LTSHaskell:5.25.1, NixOS:5.28.2, Stackage:5.25.1
Executables vty-demo
Downloads 79410 total (1950 in the last 30 days)
Rating 2.25 (votes: 2) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs uploaded by user
Build status unknown [no reports yet]




Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

For package maintainers and hackage trustees

Readme for vty-5.2.6

[back to package description]

vty is a terminal interface library.

Project is hosted on github.com: https://github.com/coreyoconnor/vty

git clone git://github.com/coreyoconnor/vty.git


  • Support for a large number of terminals. vt100, ansi, hurd, linux, screen etc etc. Anything with a sufficient terminfo entry.

  • Automatic handling of window resizes.

  • If the terminal support UTF-8 then vty supports Unicode output.

  • Handles multi-column glyphs. (Requires user to properly configure terminal.)

  • Efficient output. Output buffering and terminal state changes are minimized.

  • Minimizes repaint area. Virtually eliminating the flicker problems that plagues ncurses programs.

  • A pure, compositional interface for efficiently constructing display images.

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

  • Automatically supports refresh on Ctrl-L.

  • Automatically supports timeout after for lone ESC. The timeout is customizable.

  • Interface is designed for easy compatible extension.

  • Supports ANSI graphics modes (SGR as defined in console_codes(4)) with a type-safe interface. Gracefull fallback for terminals that do not support, or partially support the standard ANSI graphics modes.

  • Properly handles cleanup, but not due to signals.

  • Comprehensive test suite.

Known Issues

  • Terminals have numerous quirks and bugs. vty picks what works best for the author in ambigious, or buggy situations.

  • Signal handling of STOP, TERM and INT are non existent.

  • The character encoding of the terminal is assumed to be UTF-8 if unicode is used.

  • Terminfo is assumed to be correct unless there is an override configured. Some terminals will not have correct special key support (shifted F10 etc). See Config for customizing vty's behavior for a particular terminal.

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

Platform Support

Posix Terminals

Uses terminfo to determine terminal protocol. With some special rules to handle some omissions from terminfo.


cygwin only.

Development Notes

Under NixOS

After installing ncurses to user env.

LIBRARY_PATH=$HOME/.nix-profile/lib/ cabal configure --enable-tests --extra-lib-dirs=$HOME/.nix-profile/lib
LIBRARY_PATH=$HOME/.nix-profile/lib/ cabal build
LIBRARY_PATH=$HOME/.nix-profile/lib/ cabal test


As of last testing, profiling causes issues with coverage when enabled. To evaluate coverage configure as follows:

rm -rf dist ; cabal configure --enable-tests --enable-library-coverage \
  --disable-library-profiling \


rm -rf dist ; cabal configure --enable-tests --disable-library-coverage \
  --enable-library-profiling \