_
                           _  | \ _   _|  _|  _   _
                          / \ |_// \ / | / | /_| |
                          \_/ |  \_/ \_| \_| \_  |
                         ._/      http://gpodder.org/

           - -- == === ================================= === == -- -
             Copyright  2005-2011 Thomas Perl and the gPodder Team

 ==========================
 License (see COPYING file)
 ==========================

 gPodder is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 3 of the License, or
 (at your option) any later version.

 gPodder is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.

 ============
 Dependencies
 ============

   * python (>= 2.5) with sqlite3 and json support
     Python 2.6 includes "json"; for Python < 2.6, install "simplejson"
   * python-gtk2 (>= 2.12)
   * python-feedparser
   * python-mygpoclient (>= 1.4; http://thp.io/2010/mygpoclient/)
   * python-dbus

 As an alternative to python-dbus, you can use the fake D-Bus module
 provided in "tools/fake-dbus-module/".

 Dependencies for the QML UI:

   * Qt (>= 4.7.0)
   * PySide (>= 1.0.0~rc1)
   * Qt Mobility >= 1.1 Declarative Components
     (qtm-declarative from the FN PPA; use ppa:forumnokia/fn-ppa)
   * Phonon GStreamer backend (Xine backend has problems)
     (on Debian/Ubuntu, use phonon-backend-gstreamer)

 Additional dependencies if you want Bluetooth file send support:

   * gnome-obex-send OR bluetooth-sendto

 Additional dependencies for HTML episode shownotes:

   * python-webkit (Python bindings for WebKitGTK+)

 Additional dependencies for gPodder on Windows:

   * PyWin32 (http://sourceforge.net/projects/pywin32/)

 Additional dependencies for gPodder on Mac OS X:

   * ige-mac-integration (optional; when using the quartz GDK backend)

 Additional dependencies if you want to install from source:
 
   * help2man
   * python-dev
   * intltool

 Dependencies for running unittest/doctests ("make unittest"):

   * python-minimock
   * python-coverage (optional; recommended)

 ============
 Installation
 ============

 Extract the tar archive somewhere into your home directory and cd into 
 the directory where you extracted it, for example:

   tar xzvf gpodder-2.11.tar.gz
   cd gpodder-2.11/
   make install

 If you have any problems, please visit the gPodder website or mail the 
 gPodder mailing list (see below for more information).

 ================================
 Portable mode / roaming profiles
 ================================

 You can set the environment variable GPODDER_HOME to set the location for
 storing the database and downloaded files.

 You can use this to have different configurations for gPodder or to put
 gPodder's data directly on your MP3 player or USB disk, for example:

    export GPODDER_HOME=/media/usbdisk/gpodder-data/
    gpodder

 =========================================
 Feature requests, bug reports and patches
 =========================================

 Feature requests, bug report and patches should all be filed in our
 Bugzilla at http://bugs.gpodder.org - for general discussion and questions,
 please send a message to gpodder-devel (this is a subscriber-only list, so
 you have to subscribe first before sending mail there).

 For up to date information about gPodder, see the website and Wiki.

   Homepage:       http://gpodder.org/
   Wiki:           http://wiki.gpodder.org/
   Bugzilla:       http://bugs.gpodder.org/

   FAQs:           http://wiki.gpodder.org/wiki/FAQs
   Mailing List:   gpodder-devel@berlios.de
   IRC Channel:    #gpodder on FreeNode (irc.freenode.net)

 Have fun with gPodder!
 Thomas Perl <thp.io>