xscreensaver-text(6)

xscreensaver-text6

Prints some text to stdout, for use by screen savers.

Usage

xscreensaver-text [--verbose] [--columns N] [--lines N] [--latin1] [--date] [--text STRING] [--file PATH] [--program CMD] [--url URL]

Overview

The xscreensaver-text script prints out some text for use by various screensavers, according to the options set in the ~/.xscreensaver file. This may dump the contents of a file, run a program, or load a URL. The text is reformatted and wrapped as appropriate.

Options

xscreensaver-text accepts the following options:

--verbose or --v

Print diagnostics to stderr. Multiple -v switches increase the amount of output.

--columns N or --cols N

Where to wrap lines; default 72 columns.

--lines N

Truncate output to at most this many lines. Default: unlimited.

--latin1

Convert any UTF-8 characters in the input to their closest Latin1 equivalent for output.

Command line options may be used to override the settings in the ~/.xscreensaver file:

--date

Print the host name and current time.

--text STRING

Print out the given text. It may contain % escape sequences as per strftime(2).

--file PATH

Print the contents of the given file, re-formatting it as per the other options.

--program CMD

Run the given program and print its output, re-formatting it as per the other options.

--url URL

Download and print the contents of the web page. If it contains HTML, RSS, or Atom, it will be converted to plain-text. This re-downloads the document every time it is run.

Environment

HTTP_PROXY, HTTPS_PROXY, http_proxy, or https_proxy

to get the default proxy host and port.

Bugs

URLs should be cached, use "If-Modified-Since", and obey "Expires".

Author

Jamie Zawinski <[email protected]>, 20-Mar-2005.

From xscreensaver 6.15-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.