Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
notcurses-info(1)					     notcurses-info(1)

       notcurses-info -	Display	information about the terminal environment

       notcurses-info [-v]

       notcurses-info  prints  all  the	information it knows about the current
       terminal	environment, including material	loaded from terminfo(5)	(based
       on  the	TERM  environment  variable), replies from the terminal	in re-
       sponse to our queries, and built-in heuristics.

       The Unicode half	block, quadrant, sextant, and Braille glyphs  are  all
       included	in the output.	If their appearance is irregular, it might be-
       hoove you to choose another font.

       The first five lines (the Notcurses initialization banner; see notcurs-
       es_init(3)) provide:

       o The Notcurses version and the derived terminal	name, possibly includ-
	 ing the terminal version.  If Notcurses  was  able  to	 unambiguously
	 query the connected terminal, the internal name for the terminal will
	 be shown.  Otherwise, the terminal described by the TERM  environment
	 variable  will	 be  displayed.	 The terminal version is only acquired
	 via query.

       o The current cell geometry, cell-pixel geometry, and the derived  win-
	 dow  pixel geometry, the size of the crender structure, the number of
	 colors	in the palette,	and whether RGB	TrueColor is supported.

       o The compiler name and version used to build Notcurses,	 the  size  of
	 the  nccell  structure,  and  the endianness with which Notcurses was
	 compiled.  This buildtime endianness must match the  runtime  endian-

       o The version of	libterminfo against which Notcurses was	compiled.

       o The version and name of the multimedia	backend.

       The next	five lines describe properties of the terminal environment:

       o The  first  line  indicates that a given capability is	present	with a
	 plus sign ('+'), or not present/detected with a minus sign ('-'):

	 o af: Foreground color	can be set

	 o ab: Background color	can be set

	 o sum:	Synchronized Update Mode is supported

	 o cup:	Arbitrary cursor moves

	 o vpa:	Cursor can be moved to an absolute vertical coordinate

	 o hpa:	Cursor can be moved to an absolute horizontal coordinate

	 o sgr0: Styling can be	reset via a single escape

	 o op: Colors can be reset via a single	escape

	 o fgop: Foreground can	be reset via a single escape

	 o bgop: Background can	be reset via a single escape

	 o bce:	The back-color-erase property is in play

       o The second line is more of the	same:

	 o bold: Boldface is available

	 o ital: Italics are available

	 o struck: Strikethrough is available

	 o ucurl: Curled underlines are	available

	 o uline: Straight underlines are available

	 o u7: Cursor position reporting

	 o ccc:	Palette	can be reprogrammed

	 o rgb:	Colors can be specified	as RGB wit eight bits/channel

	 o el: Clearing	can be performed through the end of the	line

       o The third line	also covers UTF8 and decoding capabilities:

	 o utf8: This is a UTF8	environment

	 o 2x1:	Upper- and lower-half blocks are available

	 o 2x2:	Quadrant blocks	are available

	 o 3x2:	Sextant	blocks are available

	 o 4x2:	Braille	characters are available

	 o img:	Images can be decoded

	 o vid:	Video can be decoded

	 o indn: Multiple-line scrolling is available

	 o gpm:	Connection is established to the GPM server

       o The fourth line indicates the default background color,  and  whether
	 that color is treated as transparent.

       o The  fifth  line  describes the available bitmap graphics.  If	Sixels
	 are available,	the maximum number of color registers and maximum Six-
	 el  geometry  are reported.  If Linux framebuffer graphics are	avail-
	 able, that is reported.  If the Kitty graphics	protocol is  detected,
	 that  will be reported	with "rgba graphics are	available"; if Kitty's
	 animation support is also present, that will be reported  with	 "rgba
	 pixel animation support".

       The  final eleven lines,	only printed when in a UTF8 locale, show vari-
       ous Unicode glyphs.  The	first four lines include  the  quadrant,  sex-
       tant,  and box-drawing characters.  The next four lines include the en-
       tire Braille set.  The following	two lines include many of the  Symbols
       for Legacy Computing introduced in Unicode 13.  The final line includes
       many emoji.

       -v: Be verbose.

       The behavior of notcurses-info (and indeed all of Notcurses) depends on
       the  TERM  and LANG environment variables, the installed	POSIX locales,
       and the installed terminfo(5) databases.

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

       nick black <>.

				    v2.4.3		     notcurses-info(1)


Want to link to this manual page? Use this URL:

home | help