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.
- -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
COPYRIGHT
It is distributed under the GNU General Public
License.