NAME

       wallch - Wallpaper Changer

SYNOPSIS

       wallch [options]

DECRIPTION

       Wallch   is   a   free  and  open-source application for managing your desktop background.
       It comes with various functions, such as  rotating  your  hard  drive's  wallpapers,  live
       earth,  wikipedia  picture  of  the  day, wallpaper clocks and live website.  It  supports
       Gnome (with or without Unity integration), LXDE and XFCE desktop environments.  Wallch can
       work with or without its Graphical User Interface, for extra lightweightness.

OPTIONS

       Please  notice  that all the options, except from --change, --help, --cache, --fcache, and
       --version, will be sent to  the  already running instance of Wallch, if there is one.
       --help
           Shows a menu with the available options.
       --change[=DIRECTORY]
           Picks  a random image and sets it as desktop background from  the  last  used  folder.
           However,  if a DIRECTORY is specified, then that directory is recursively searched for
           images and a random one is picked from there.
       --start
           Starts the wallpaper changing process using the last specified folder.
       --earth
           Starts the live earth process.
       --potd
           Starts the picture of the day process.
       --clock
           Starts the wallpaper clocks process.
       --website
           Starts the live website process.
       --stop
           Stops any running process, like live earth or picture of the day.
       --quit
           Closes any instances of the program.
       --next
           Proceeds to the next image, if available. This works only when  the  normal  wallpaper
           changing process is running.
       --previous
           Proceeds  to  the  previous  image,  if  available.  This  works  only when the normal
           wallpaper changing process is running.
       --pause
           Pauses the normal wallpaper changing process.
       --cache DIRECTORY
           Searches DIRECTORY recursively for supported images and caches  them.  This  allows  a
           much  better  experience   when   viewing   the images  of this DIRECTORY from Wallch,
           because they load much faster. Please note that this argument takes into consideration
           the  cache  limit  and  may  delete some cached images of the specified folder if this
           limit is exceeded. Wallch by default caches the images while they are being viewed, so
           this  option  may  only  be used if the user does not want to wait for the pictures to
           load and be cached when viewed for the first time from Wallch.
       --fcache DIRECTORY
           Same as --cache but without taking into consideration the cache limits.  If  you  open
           Wallch's  Graphical  User  Interface   afterwards,   the   limits  will  be taken into
           consideration and the extra images will be deleted. Wallch calculates which images are
           most likely not to be seen according to the last used folder, and it deletes the extra
           images from the cache, if the limit is exceeded.  This  option  is  useful   when  you
           simply  want to generate thumbnails for all the images in a folder or you simply don't
           want to wait for Wallch to calculate and delete the extra images for the time being.
       --version
           Shows the program's version.

BUGS

       If you find a bug, please report it at alexsol.developer@gmail.com, leon.vitanos@gmail.com
       or at launchpad  (https://bugs.launchpad.net/wallpaper-changer)

AUTHORS

       Leon Vitanos (leon.vitanos@gmail.com)

       Alex Solanos (alexsol.developer@gmail.com)

                                          February 2014                                 WALLCH(1)