diff options
author | Simon Rettberg | 2018-10-16 10:08:48 +0200 |
---|---|---|
committer | Simon Rettberg | 2018-10-16 10:08:48 +0200 |
commit | d3a98cf6cbc3bd0b9efc570f58e8812c03931c18 (patch) | |
tree | cbddf8e50f35a9c6e878a5bfe3c6d625d99e12ba /driver/xscreensaver-getimage-file.man | |
download | xscreensaver-d3a98cf6cbc3bd0b9efc570f58e8812c03931c18.tar.gz xscreensaver-d3a98cf6cbc3bd0b9efc570f58e8812c03931c18.tar.xz xscreensaver-d3a98cf6cbc3bd0b9efc570f58e8812c03931c18.zip |
Original 5.40
Diffstat (limited to 'driver/xscreensaver-getimage-file.man')
-rw-r--r-- | driver/xscreensaver-getimage-file.man | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/driver/xscreensaver-getimage-file.man b/driver/xscreensaver-getimage-file.man new file mode 100644 index 0000000..778ad85 --- /dev/null +++ b/driver/xscreensaver-getimage-file.man @@ -0,0 +1,66 @@ +.TH XScreenSaver 1 "20-Mar-2005 (4.21)" "X Version 11" +.SH NAME +xscreensaver-getimage-file - put a randomly-selected image on the root window +.SH SYNOPSIS +.B xscreensaver-getimage-file +[\-display \fIhost:display.screen\fP] +[\--verbose] +[\--name] +[\--no-cache] +directory-or-URL +.SH DESCRIPTION +The \fIxscreensaver\-getimage\-file\fP program is a helper program +for the xscreensaver hacks that manipulate images. Specifically, it +is invoked by +.BR xscreensaver\-getimage (1) +as needed. This is not a user-level command. + +This program selects a random image from disk, and loads it on the root +window. It does this by figuring out which image-loading programs are +installed on the system, and invoking the first one it finds. +.SH OPTIONS +.I xscreensaver-getimage-file +accepts the following options: +.TP 4 +.B --verbose +Print diagnostics. +.TP 4 +.B --name +Don't load an image: instead just print the file name to stdout. +.TP 4 +.I directory-or-URL +If a directory is specified, it will be searched recursively for +images. Any images found will eligible for display. For efficiency, +the contents of the directory are cached for a few hours before it +is re-scanned. + +If a URL is specified, it should be the URL of an RSS or Atom feed +containing images. The first time it is accessed, all of the images +in the feed will be downloaded to a local cache directory. If a few +hours have elapsed since last time, the URL will be polled again, and +any new images will be cached, any images no longer in the feed +will be expired. +.TP 4 +.B --no-cache +Update the cache immediately, even if it is not time yet. This +will re-scan the directory, or re-poll the RSS feed. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xscreensaver\-demo (1), +.BR xscreensaver\-getimage (1), +.BR xv (1), +.BR xli (1), +.BR xloadimage (1), +.BR chbg (1) +.SH COPYRIGHT +Copyright \(co 2001-2012 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. +.SH AUTHOR +Jamie Zawinski <jwz@jwz.org>, 14-Apr-01 |