term-ng
v3.0.4
Published
Terminal/$TERM feature snooping and whitelisting
Downloads
88
Maintainers
Readme
term-ng
Enables enhanced node.js/fish-shell/XTerm/iTerm3 feature integration.
Publishing Status
Development Status
Documentation/Help
TermNG (Next Generation)
- Senses 24bit colour (truecolor) when
$TERM_COLOR=16m
environment variable is set. - Adds
--color=16m
to front of process.argv before wrapping thesupports-color
module. - Indicate enhanced media support by setting:
$TERM_IMAGES=enabled
: Allow rendering of inline images using OSC sequences.$TERM_AUDIO=enabled
: Allow enhanced audio.
- Indicate that you use a font that has box drawing or full extended characters.
$TERM_FONT=box
: Terminal font has UTF8 box drawing characters.$TERM_FONT=full
: Terminal font has full UTF8 extras (such as Menlo, DejaVu Mono).
- Sense $TERM suffixes to indicate enhanced termcap capabilities.
In fish, it's a simple as defining a universal, exported variable.
set -Ux TERM_IMAGES enabled
set -Ux TERM_FONT full
In bash an export TERM_IMAGES=enabled
in ~/.bashrc
will do the trick. I don't use tcsh or zsh anymore so can't remember exactly which files are used when those shells are invoked interactively. Fish is almost always invoked interactively - which is kind of the point of fish, it being the 'Friendly INTERACTIVE Shell' after all! Write scripts for portablility (sh/bash/perl even node) then write fish functions to interact with those scripts from the keyboard... but I digress.
Usage
Terminal Color Test
From inside the package directory, running npm run-script colors
will generate a preview of the entire color gamut your terminal is capable of. Output of a recent iTerm shown below:
Documentation
Full documentation can be found at https://thebespokepixel.github.io/term-ng/