1notcurses-info(1) notcurses-info(1)
2
6 notcurses-info - Display information about the terminal environment
7
9 notcurses-info [-v]
10
12 notcurses-info prints all the information it knows about the current
13 terminal environment, including material loaded from terminfo(5) (based
14 on the TERM environment variable), replies from the terminal in re‐
15 sponse to our queries, and built-in heuristics.
16 The Unicode half block, quadrant, sextant, and Braille glyphs are all
18 included in the output. If their appearance is irregular, it might be‐
19 hoove you to choose another font.
20 The first five lines (the Notcurses initialization banner; see notcurs‐
22 es_init(3)) provide:
23 • The Notcurses version and the derived terminal name, possibly includ‐
25 ing the terminal version. If Notcurses was able to unambiguously
26 query the connected terminal, the internal name for the terminal will
27 be shown. Otherwise, the terminal described by the TERM environment
28 variable will be displayed. The terminal version is only acquired
29 via query.
30 • The current cell geometry, cell-pixel geometry, and the derived win‐
32 dow pixel geometry, the size of the crender structure, the number of
33 colors in the palette, and whether RGB TrueColor is supported.
34 • The compiler name and version used to build Notcurses, the size of
36 the nccell structure, and the endianness with which Notcurses was
37 compiled. This buildtime endianness must match the runtime endian‐
38 ness.
39 • The version of libterminfo against which Notcurses was compiled.
41 • The version and name of the multimedia backend.
43 The next five lines describe properties of the terminal environment:
45 • The first line indicates that a given capability is present with a
47 plus sign ('+'), or not present/detected with a minus sign ('-'):
48 • af: Foreground color can be set
50 • ab: Background color can be set
52 • sum: Synchronized Update Mode is supported
54 • vpa: Cursor can be moved to an absolute vertical coordinate
56 • hpa: Cursor can be moved to an absolute horizontal coordinate
58 • sgr0: Styling can be reset via a single escape
60 • op: Colors can be reset via a single escape
62 • fgop: Foreground can be reset via a single escape
64 • bgop: Background can be reset via a single escape
66 • bce: The back-color-erase property is in play
68 • rect: Rectangular editing is available
70 • The second line is more of the same:
72 • bold: Boldface is available
74 • ital: Italics are available
76 • struck: Strikethrough is available
78 • ucurl: Curled underlines are available
80 • uline: Straight underlines are available
82 • u7: Cursor position reporting
84 • ccc: Palette can be reprogrammed
86 • rgb: Colors can be specified as RGB wit eight bits/channel
88 • el: Clearing can be performed through the end of the line
90 • The third line also covers UTF8 and decoding capabilities:
92 • utf8: This is a UTF8 environment
94 • 2x1: Upper- and lower-half blocks are available
96 • 2x2: Quadrant blocks are available
98 • 3x2: Sextant blocks are available
100 • 4x2: Braille characters are available
102 • img: Images can be decoded
104 • vid: Video can be decoded
106 • indn: Multiple-line scrolling is available
108 • gpm: Connection is established to the GPM server
110 • kbd: The Kitty keyboard protocol is in use
112 • The fourth line indicates the default background color, and whether
114 that color is treated as transparent by the terminal (only kitty is
115 known to do this), and the default foreground color. pmouse indi‐
116 cates whether pixel-precise mouse events are supported.
117 • The fifth line describes the available bitmap graphics. If Sixels
119 are available, the maximum number of color registers and maximum Six‐
120 el geometry are reported. If Linux framebuffer graphics are avail‐
121 able, that is reported. If the Kitty graphics protocol is detected,
122 that will be reported with "rgba graphics are available"; if Kitty's
123 animation support is also present, that will be reported with "rgba
124 pixel animation support".
125 To the right of this material is the Notcurses homepage's URI, and the
127 Notcurses logo (the latter only if bitmap graphics are available).
128 The final eleven lines, only printed when in a UTF8 locale, show vari‐
130 ous Unicode glyphs. The first four lines include the quadrant, sex‐
131 tant, and box-drawing characters. The next four lines include the en‐
132 tire Braille set. The following two lines include many of the Symbols
133 for Legacy Computing introduced in Unicode 13. The final line includes
134 many emoji.
135
137 -v: Be verbose.
138
140 The behavior of notcurses-info (and indeed all of Notcurses) depends on
141 the TERM and LANG environment variables, the installed POSIX locales,
142 and the installed terminfo(5) databases.
143
145 tack(1), notcurses(3), terminfo(5)
146
148 nick black <nickblack@linux.com>.
149 v3.0.8 notcurses-info(1)