====== README ====== Overview ======== Provided a well-formed RSS feed with enclosures, WallCast will automatically change the desktop wallpaper with a "new" wallpaper, if it's available. This program is being distributed under the terms of the MIT License. This means that you can use, modify, redistribute freely this program verbatim or modified as long as you provide the license along with the software. Requirements: ============= * XDG python library * PIL (Python Imaging Library) * Feedparser (Universal Feedparser, by Mark Pilgrim) Usage: ====== Fetching the latest wallpaper: $ python wallcast.py Fetching randomly one out of the wallpapers: $ python wallcast.py --random .. note:: This option is far from optimized ; it may takes some time before it picks the right wallpaper. Options: -------- * `-d`, `--debug`: display a debug message at runtime * `-r`, `--random`: pick randomly a wallpaper from the feed. * `-f`, `--feed`: overrides the rss_url value from configuration * `-w`, `--min-width`: overrides the min_width value from configuration. must be an integer. Configuration: -------------- The configuration file (``wallcast.conf``) helds a few options. When you run `wallcast` for the first time, this file is being created, using default values. You may edit these values and adapt the to your needs. The syntax follows the usual configuration file (sections / options) Sample:: [general] min_width = 1280 rss_url = http://mix.li/feed.xml desktop_type = GNOME * `rss_url`: The feed URL. * `min_width`: The minimum width (in pixels) of the wallpaper you want to have on your desktop * `desktop_type`: the type of desktop. At the moment, wallcast will just be able to change GNOME wallpapers, but more desktop environments are planned (KDE, OSX, ...). Where is the wallcast.conf file? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If your desktop environment follows the XDG standards, this file is located here ``$XDG_CONFIG_DIR/wallcast/wallcast.conf`` Copyright notices: ================== The test samples are coming from the mix.li website. These pictures are (c) 2009 Olivier Meunier and distributed under the Creative Commons BY-NC-ND terms.