XROOTCONSOLE(1) BSD General Commands Manual XROOTCONSOLE(1)NAME
xrootconsole -- display a file (or stdin) to a transparent window
SYNOPSIS
xrootconsole [options] [file]
DESCRIPTION
xrootconsole is a small utility which displays its input in a transparent text box on X's root window. It will read from any file listed on
the command line or, by default, from stdin. It is most useful when it reads from a FIFO; this allows you to redirect multiple commands to
the FIFO and monitor their output.
The options are as follows:
-fg color This option specifies the color to use for displaying text. The default is ``black.''
-bg color This option specifies the color to AND with the root window, for shaded transparency. The default is ``clear.''
-bw number This option specifies the width of the border around xrootconsole in pixels. The default is 0.
-bd color This option specifies the color to use for the border of the window. The default is ``black.''
-fn font This option specifies the font to use for displaying text. The default is ``fixed.''
-c number This option produces output that is number columns wide. Text is written vertically down each column in the order in which text
is received from the input file. The default is 1.
--topdown Forces xrootconsole to display new lines from its input at the top of the screen, scrolling previous lines down. Default behav-
ior is to insert new lines at the bottom and scroll the previous lines up.
--wrap Rather than truncating long lines, this option specifies that xrootconsole should wrap excess text to the following line or
lines, as necessary.
--ansi-color
Enable color support by parsing ANSI escape sequences.
-geometry geometry
This option specifies the preferred size and position of the window; see X(1). The default is ``80x10+0+0.''
-h, --help Displays a detailed usage message and exits.
-v, --version
Displays the program version and exits.
file Optionally specifies a file from which to read input; by default, xrootconsole reads from the standard input.
DIAGNOSTICS
Exit status is 0 on success, and 1 if the command fails for any reason.
AUTHORS
Eric Youngblut is the original author of xrootconsole. Bob Galloway <bob@de-fac.to> is the current maintainer. Alexandre Duret-Lutz elimi-
nated flicker by storing the background pixmap and drawing off-screen. This manual page was written by Zak Johnson <zakj@i.am>.
BSD May 19, 2000 BSD
Check Out this Related Man Page
XOSD(1) General Commands Manual XOSD(1)NAME
osd_cat - X on-screen file displayer
SYNOPSIS
osd_cat [OPTION] [FILE]...
osd_cat -b percentage|slider [OPTION]
DESCRIPTION
Display FILE, or standard input, on X screen.
-p, --pos=POS
This option tells osd_cat where to display the text. POS can be top, middle, or bottom. The default is top.
-o, --offset=OFFSET
This option specifies the offset from the top or bottom of screen the text is displayed. The default is 0.
-A, --align=ALIGN
This option tells osd_cat where to display the text. ALIGN can be left, right or center. The default is left.
-i, --indent=OFFSET
This option specifies the INDENT from the left of screen the text is displayed. The default is 0.
-f, --font=FONT
This option specifies the FONT to be used for displaying the text. The default is fixed.
-c, --color=COLOR
This option specifies the COLOR to be used for displaying the text. The default is red.
-d, --delay=TIME
This option specifies the number of seconds the text is displayed. The default is 5 seconds.
-l, --lines=LINES
This option specifies the number of LINES to scroll the display over. The default is 5.
-s, --shadow=OFFSET
This option specifies the OFFSET of the text shadow. The default is 0, which means no text shadow is created.
-S, --shadowcolour=COLOUR
This option specifies the COLOUR of the text shadow. The default is black.
-O, --outline=WIDTH
This option specifies the WIDTH of the text outline. The default is 0, which is no outline.
-u, --outlinecolour=COLOUR
This option specifies the COLOUR of the text outline. The default is black.
-a, --age[=SCROLL_AGE]
This option affects screen redrawing. If SCROLL_AGE seconds pass before a new line is ready (for example, you're reading from a
pipe), all lines are cleared at once instead of being scrolled off as new lines replace old lines. The default is 0.
When no SCROLL_AGE is explicitly given, the current value from DELAY is used.
-w, --wait
This option also affects screen redrawing. When there is data ready to be put on screen, this option will cause osd_cat to wait
until the display is clear. An alternative to scrolling.
-b, --barmode=TYPE
Lets you display a percentage or slider bar instead of just text. TYPE may be percentage or slider. In this mode no text is read
from any file, but the following options can be used:
-P, --percentage=PERCENTAGE
This option specified the position of the percentage / slider bar. PERCENTAGE may be in the range from 0 to 100, the default is 50.
-T, --text=TEXT
This option specifies an optional TEXT which gets displayed above the percentage bar. The default is empty, so no additional text
is displayed.
-h, --help
display help (which is often more up to date) and exit
With no FILE, or when FILE is -, read standard input.
AUTHOR
Martijn van de Streek <martijn@foodfight.org>, Some patching done by Malcolm Valentine <farkit@iprimus.com.au> and Tim Wright
<tim@ignavus.net>.
xosd was written by Andre Renaud <andre@ignavus.net> and is maintained by Tim Wright <tim@ignavus.net>
SEE ALSO
More information on the X OSD Library and its author can be found on http://www.ignavus.net/software.html
<http://www.ignavus.net/software.html>
COPYRIGHT
It is distributed under the GNU General Public License.
X OSD cat January 2001 XOSD(1)