Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

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

Recent activity

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.