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.