Usage

Installation

console.log('shell', 'npm install --save term-ng')

CLI

  > npm install --global term-ng
  > term-ng --help

  term-ng v0.6.3

  Allow user configured enhanced terminal capabilities to be queried.

  The command will exit with status 0 if all the provided queries (except
  user-agent) are true, otherwise exits with status 1.

  If user-agent is used, the command will return the string on stdout and exit
  status 0.

  Usage:
  termng [command]

  Commands:
  has-color      Is basic color supported?
  has-256        Is 256 color supported?
  has-16m        Is 24 bit color supported?
  has-images     Are images supported? (set $TERM_IMAGES=enabled)
  has-audio      Is audio supported? (set $TERM_AUDIO=enabled)
  has-box-font   Is audio supported? (set $TERM_FONT=box)
  has-full-font  Is audio supported? (set $TERM_FONT=full)
  is-enhanced    Is the current terminal using an enhanced termcap?
                 (set $TERM_ENHANCED=enabled)
  user-agent     Print the current terminal software

  Options:
  -h, --help     Display this help.
  -v, --version  Return the current version on stdout. -vv Return name & version.
  --color        Force color depth --color=256|16m. Disable with --no-color

  © 2016 The Bespoke Pixel. Released under the MIT License.

Enhancing termcap

In some of my 'private' admin/control systems, I use a customised terminfo database that wraps some of the (very useful) enhanced OSC abilities of more recent iTerm builds into new commands available via tput (which I further wrap in fish functions).

The terminfo directory above contains iTerm.ti. Using /usr/bin/tic and ncurses' terminfo database (available from invisible-island.net), I build a new terminal type xterm-256color+iterm3, and change the Terminal type preference in iTerm to the same, setting the $TERM environment variable.

The new terminfo entries are built thusly...

cd term-ng/terminfo
curl http://invisible-island.net/datafiles/current/terminfo.src.gz
gunzip terminfo.src.gz
tic -xrs -e xterm-256color terminfo.src
tic -xsv3 iTerm.ti

This create a new, updated xterm-256color and then extends it for iTerm. This is non-destructive as it creates new entries at ~/.terminfo/. Simply delete this directory to return the terminfo databases back to the original OS provided state.

A word of caution... while this has worked very well for me, I have found that some things complain about an unrecognized term type - Homebrew is notable here. A simple workaround is to have a standard xterm-256color session profile defined to use when brewing.

API

Returned object describing terminal features.