Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   17783 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

xscreensaver-getimage-file(1) XScreenSaver manualxscreensaver-getimage-file(1)

NAME
       xscreensaver-getimage-file  - put a randomly-selected image on the root
       window

SYNOPSIS
       xscreensaver-getimage-file [-display  host:display.screen]  [--verbose]
       [--name] [--no-cache] directory-or-URL

DESCRIPTION
       The  xscreensaver-getimage-file	program	 is  a	helper program for the
       xscreensaver hacks that manipulate images.  Specifically, it is invoked
       by  xscreensaver-getimage(1)  as needed.	 This is not a user-level com‐
       mand.

       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.

OPTIONS
       xscreensaver-getimage-file accepts the following options:

       --verbose
	   Print diagnostics.

       --name
	   Don't load an image: instead just print the file name to stdout.

       directory-or-URL
	   If a directory is specified, it will be  searched  recursively  for
	   images.   Any  images  found	 will eligible for display.  For effi‐
	   ciency, 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.

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

SEE ALSO
       X(1),  xscreensaver(1), xscreensaver-demo(1), xscreensaver-getimage(1),
       xv(1), xli(1), xloadimage(1), chbg(1)

COPYRIGHT
       Copyright © 2001-2012 by Jamie Zawinski.	 Permission to use, copy, mod‐
       ify,  distribute,  and sell this software and its documentation for any
       purpose is hereby granted without fee, provided that  the  above	 copy‐
       right  notice  appear in all copies and that both that copyright notice
       and this permission notice appear in supporting documentation.  No rep‐
       resentations  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>, 14-Apr-01

X Version 11		      5.26 (09-Dec-2013) xscreensaver-getimage-file(1)

Vote for polarhome