1notcurses-info(1)                                            notcurses-info(1)
2
3
4

NAME

6       notcurses-info - Display information about the terminal environment
7

SYNOPSIS

9       notcurses-info [-v]
10

DESCRIPTION

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
17       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
21       The first five lines (the Notcurses initialization banner; see notcurs‐
22       es_init(3)) provide:
23
24       • 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
31       • 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
35       • 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
40       • The version of libterminfo against which Notcurses was compiled.
41
42       • The version and name of the multimedia backend.
43
44       The next five lines describe properties of the terminal environment:
45
46       • The  first  line  indicates that a given capability is present with a
47         plus sign ('+'), or not present/detected with a minus sign ('-'):
48
49         • af: Foreground color can be set
50
51         • ab: Background color can be set
52
53         • sum: Synchronized Update Mode is supported
54
55         • vpa: Cursor can be moved to an absolute vertical coordinate
56
57         • hpa: Cursor can be moved to an absolute horizontal coordinate
58
59         • sgr0: Styling can be reset via a single escape
60
61         • op: Colors can be reset via a single escape
62
63         • fgop: Foreground can be reset via a single escape
64
65         • bgop: Background can be reset via a single escape
66
67         • bce: The back-color-erase property is in play
68
69         • rect: Rectangular editing is available
70
71       • The second line is more of the same:
72
73         • bold: Boldface is available
74
75         • ital: Italics are available
76
77         • struck: Strikethrough is available
78
79         • ucurl: Curled underlines are available
80
81         • uline: Straight underlines are available
82
83         • u7: Cursor position reporting
84
85         • ccc: Palette can be reprogrammed
86
87         • rgb: Colors can be specified as RGB wit eight bits/channel
88
89         • el: Clearing can be performed through the end of the line
90
91       • The third line also covers UTF8 and decoding capabilities:
92
93         • utf8: This is a UTF8 environment
94
95         • 2x1: Upper- and lower-half blocks are available
96
97         • 2x2: Quadrant blocks are available
98
99         • 3x2: Sextant blocks are available
100
101         • 4x2: Braille characters are available
102
103         • img: Images can be decoded
104
105         • vid: Video can be decoded
106
107         • indn: Multiple-line scrolling is available
108
109         • gpm: Connection is established to the GPM server
110
111         • kbd: The Kitty keyboard protocol is in use
112
113       • 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
118       • 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
126       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
129       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

OPTIONS

137       -v: Be verbose.
138

NOTES

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

SEE ALSO

145       tack(1), notcurses(3), terminfo(5)
146

AUTHORS

148       nick black <nickblack@linux.com>.
149
150
151
152                                    v3.0.8                   notcurses-info(1)
Impressum