NAME

       xscreensaver-text - prints some text to stdout, for use by screen savers.

SYNOPSIS

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

DESCRIPTION

       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".

SEE ALSO

       xscreensaver-settings(1),   xscreensaver(1),   fortune(1),   phosphor(6x),   apple2(6x),    starwars(6x),
       fontglide(6x), dadadodo(1), webcollage(6x),

COPYRIGHT

       Copyright  ©  2005-2021  by  Jamie  Zawinski.  Permission to use, copy, modify, distribute, and sell this
       software and its documentation for any purpose is hereby granted without fee,  provided  that  the  above
       copyright  notice  appear  in  all  copies and that both that copyright notice and this permission notice
       appear in supporting documentation.  No representations are made about the suitability of  this  software
       for any purpose.  It is provided "as is" without express or implied warranty.

AUTHOR

       Jamie Zawinski <jwz@jwz.org>, 20-Mar-2005.

X Version 11                                   6.08 (10-Oct-2023)                           xscreensaver-text(1)