Man page - osd_cat(1)

Packages contains this manual

Manual

XOSD

NAME
SYNOPSIS
DESCRIPTION
AUTHOR
SEE ALSO
COPYRIGHT

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

COPYRIGHT

It is distributed under the GNU General Public License.