Repository files navigation

• https://github.com/ruby/curses
• https://github.com/ruby/curses/issues

A Ruby binding for curses, ncurses, and PDCurses.curses is an extension library for text UI applications.

Formerly part of the Ruby standard library,curses was removed and placed in this gemwith the release of Ruby 2.1.0. (seeruby/ruby@9c5b2fd)

$ gem install curses

Requires ncurses or ncursesw (with wide character support).On Debian based distributions, you can install it with apt:

$ apt install libncurses5-dev

Or

$ apt install libncursesw5-dev

On Windows,gem install curses will build bundled PDCurses, so youdon't need to install extra libraries.However, if you prefer ncurses to PDCurses, specify the following option:

> gem install curses -- --use-system-libraries

On mingw, you need DevKit to compile the extension library.

On MacOS,ncurses menu isn't natively supported. You can install the gem with menu support using homebrew:

brew install ncursesgem install curses -- --use-system-libraries --with-ncurses-dir=/usr/local/opt/ncurses

with/usr/local/opt/ncurses the path where homebrew installed ncurses on your machine

Type the following command, and see[rdoc] of curses:

> gem server -l

• curses.gem doesn't support more than 256 color pairs. Seehttps://reversed.top/2019-02-05/more-than-256-curses-color-pairs/ for details.

After checking out the repo, runbundle install to install dependencies.

To compile the extension library, runbundle exec rake compile.

To install this gem onto your local machine, runbundle exec rake install. To release a new version, update the version number incurses.gemspec, and then runbundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the.gem file torubygems.org.

curses is released under the Ruby and 2-clause BSD licenses. See COPYING fordetails.

It includes a forked version of PDCurses, which is in the public domain:

https://github.com/Bill-Gray/PDCurses

The version for Win32 console mode in the wincon subdirectory is used.