CRT

A Crystal library of curses widgets for building terminal user interfaces.

CRT provides 23 ready-to-use widgets — from simple labels and buttons to scrolling lists, text editors, menus, file selectors, and spreadsheet-style grids — all rendered with ncurses.

Ported from Ruby CDK.

Widgets

Installation

1. Add the dependency to your shard.yml:

   dependencies:
     crt:
       github: trans/crt
   

2. Run shards install

Requires ncurses development headers (libncurses-dev, ncurses-devel, or equivalent for your system).

Usage

require "crt"

# Initialize ncurses
NCurses.init
NCurses.cbreak
NCurses.no_echo
NCurses.start_color

# Create a screen
screen = CRT::Screen.new

# Display a label
label = CRT::Label.new(screen,
  CRT::CENTER, CRT::CENTER,
  ["</B>Hello, CRT!", "Press any key to exit."],
  box: true, shadow: true)

label.draw(true)
label.wait(0)

# Clean up
label.destroy
screen.destroy
NCurses.end_win

Development

crystal spec          # Run tests
crystal build src/crt.cr --no-codegen  # Type-check without building

Contributing

1. Fork it (https://github.com/trans/crt/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

License

MIT