ggiterm - Terminal emulator for GGI ggiterm [OPTIONS] ggiterm is a terminal emulator for the GGI graphics library. It uses freetype to display internationalized and (depending on the color depth) antialiased text. It is also backwards compatible with the widespread DEC vt100 terminal, but features nifty additions to the old standard, like colors. -d, --debuglevel n If ggiterm was compiled with debugging enabled, this option selects the subsystem(s) to debug. You can debug more than one subsystem by adding the corresponding numbers. 0 Disable debugging (this is the default). 1 Initialization. Lets you know all about mode negociation, font parsing, or memory allocation. 2 Input. Debug everything that is sent to the slave program. 4 Output. Debug what the slave process sends to ggiterm in return. 8 Freetype. Details the innards of freetype rendering. 16 History. See how ggiterm stores and retrieves characters. 32 Functions. Debug every function call inside ggiterm. Be warned, debugging can dramatically slow down execution. In this case it is strongly recommended to redirect the output to a file for later analysis. -e, --exec program [ARGS] Lets you specify the program and arguments ggiterm will execute instead of the default shell. This option must be the last on the command line. -f, --font filename If this option is not provided, ggiterm will use the default GGI font. In this case, no antialiasing is available, and only the ASCII character set is garanteed to be present. You won't be able to display accented or non latin characters. filename is a file which must contain a fixed width font. It can be in any format supported by the freetype library. The most commonly found are True Type fonts (.ttf). The author suggests Microsoft Courier New (widely available), or Monofur from Tobias Kohler (much more fun and available for free athttp://www.dafont.com). Both have graphical drawing characters and allow underlining. -h, --help Show a short summary of the available options. -m, --mode Specify the graphics mode to set. This is a convenient alternative to using the GGI_DEFMODE variable. The format is the same. -s, --font-size n The font size to use for displaying text. Unfortunately this parameter does not correspond to the character's size in pixels, but rather to some internal metrics used by the font designer. So, for a given value, the size of the characters will vary from one font to another. The default value is 12. Currently this option does nothing if used with the default GGI font. -v, --version Print version and exit. ggiterm recognizes escape sequences described by the ggiterm terminfo/termcap entry, and accordingly sets the TERM environment variable to "ggiterm". This entry is basically the vt100 entry, with a few extra capabilities to allow color handling and to speed up the rendering by using GGI facilities. This means that ggiterm is backwards compatible with the vt100 specification. So, on a system which doesn't have the ggiterm entry, you can always set TERM to "vt100" and have a working ggiterm, however with reduced functionality.

Warning
This is by no means a complete vt100 emulation. Programs which directly send vt100 escape sequences to the terminal will without any doubt run into severe problems. Those are fortunately rare nowadays. Most terminal-based programs rely on curses-like libraries and will thus run fine. ggiterm sets the TERM variable to "ggiterm" (see above). The value of the SHELL variable is used to determine which shell should be spawned by ggiterm. If not specified otherwise, ggiterm uses the default GGI target. In most cases this should be just fine. If you wish to provide more options or force a particular target, you will have to set the GGI_DISPLAY and/or the GGI_DEFMODE variables (see the GGI documentation). $ GGI_DISPLAY=X:-noaccel GGI_DEFMODE=800x600 ggiterm --font cour.ttf libggi(7) ggiterm was written by Aurelien Reynaud.