Terminal Kit

A full-blown terminal lib featuring: 256 colors, styles, keys & mouse handling, input field, progress bars, screen buffer (including 32-bit composition and image loading), text buffer, and many more...

Whether you just need colors & styles, build a simple interactive command line tool or a complexe terminal application: this is the absolute terminal lib for Node.js!

It does NOT depend on ncurses.

Some tutorials are available at blog.soulserv.net/tag/terminal.

Screenshot, PleaZe!

This is a fraction of what Terminal-Kit can do, with only few lines of code. Click any image to see the documentation related to the feature!

← Word-wrapping

← Table with automatic column computing, cell fitting and word-wrapping

← Surfaces and Sprites

← Load and draw an image inside the terminal

Key features

New: Document model for building rich app GUI

New: Spinner

New: Table with automatic column computing, cell fitting and word-wrapping

New: Promises can be used instead of callback everywhere

New: Word-wrapping along full terminal width or a pre-defined column-width

New: ScreenBuffer HD 32-bit (RGBA) surfaces with composition and image loading

• colors, 256 colors or even 24-bit colors, if the terminal supports it
• styles (bold, underline, italic, and many more)
• style mixing
• chainable
• string formatting
• short style markup
• terminal window title
• cursor positioning
• keyboard input
• mouse support (GPM is supported for the Linux Console)
• input field
• single line menu
• single column menu
• grid/table menu
• progress bar
• interactive 'yes or no'
• screen & off-screen buffers (a concept similar to SDL's Surface)
• text buffers
• change the terminal color palette
• draw an image file (PNG, JPEG, GIF) directly inside the terminal
• event-driven

Quick examples

1// Require the lib, get a working terminal
2var term = require( 'terminal-kit' ).terminal ;
3
4// The term() function simply output a string to stdout, using current style
5// output "Hello world!" in default terminal's colors
6term( 'Hello world!\n' ) ;
7
8// This output 'red' in red
9term.red( 'red' ) ;
10
11// This output 'bold' in bold
12term.bold( 'bold' ) ;
13
14// output 'mixed' using bold, underlined & red, exposing the style-mixing syntax
15term.bold.underline.red( 'mixed' ) ;
16
17// printf() style formatting everywhere:
18// this will output 'My name is Jack, I'm 32.' in green
19term.green( "My name is %s, I'm %d.\n" , 'Jack' , 32 ) ;
20
21// Since v0.16.x, style markup are supported as a shorthand.
22// Those two lines produce the same result.
23term( "My name is " ).red( "Jack" )( " and I'm " ).green( "32\n" ) ;
24term( "My name is ^rJack^ and I'm ^g32\n" ) ;
25
26// Width and height of the terminal
27term( 'The terminal size is %dx%d' , term.width , term.height ) ;
28
29// Move the cursor at the upper-left corner
30term.moveTo( 1 , 1 ) ;
31
32// We can always pass additional arguments that will be displayed...
33term.moveTo( 1 , 1 , 'Upper-left corner' ) ;
34
35// ... and formated
36term.moveTo( 1 , 1 , "My name is %s, I'm %d.\n" , 'Jack' , 32 ) ;
37
38// ... or even combined with other styles
39term.moveTo.cyan( 1 , 1 , "My name is %s, I'm %d.\n" , 'Jack' , 32  ) ;
40
41// Get some user input
42term.magenta( "Enter your name: " ) ;
43term.inputField(
44	function( error , input ) {
45		term.green( "\nYour name is '%s'\n" , input ) ;
46	}
47) ;

♥♥ I want to READ THE DOC NOW! ♥♥

License: MIT