

                        |'\     |   |         /''\   /  |
                        |./    .|  .|         |  |   \__|
                    /'\ |  /\ / | / | /| |'   |  |      |
                    \_/ |  \/ \_| \_| \_ |    \../ o    |
                   \_/     www.perli.net/projekte/gpodder

           - -- == === ================================= === == -- -


 gPodder 0.4 README
 ==================
 Copyright (c) 2005 Thomas Perl <thp@perli.net>
 Released on 06.09.2005 under the GNU GPL


 ============================
 1) What's new in version 0.4
 ============================

 Here is a (probably incomplete) list of new features/bugfixes in 0.4:

   *) Re-designed download progress dialog
   *) gPodder configuration file handling: gpodder.conf
   *) Made threading + GUI more stable
   *) Added setup screen to configure download dir + player application
   *) Added list of already downloaded podcasts (with ability to play)
   *) Error messages on download failure
   *) "Cancel" button in the download progress dialog
   *) More messages are displayed in general at certain occassions
   *) Possibility to do multi-select of podcasts (download more at once)
   *) Fixed handling of "%20" (space) in URLs (will write decent filenames)
   *) Expand the whole podcast tree on display by default
   *) Remove dependency on xmms - choose any audio player you want in setup
   *) Minor code clean-ups

 ===============
 2) Dependencies
 ===============

 Debian/Ubuntu users can install the dependencies with:
 
   apt-get install python python-glade2 python-gtk2 wget xmms

 Other users: Please install the above packages somehow ;)
 Please keep in mind that as of version 0.4 you might use 
 basically any other media player instead of xmms.

 =====================
 3) How to run/install
 =====================

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

   tar xzvf gpodder-0.4.tar.gz
   cd gpodder-0.4/
 
 After that you can start gPodder 0.4 by starting it with the following 
 command:

   ./gpodder.py
 
 Currently there is no way to automatically install it system-wide, but 
 if you are whiz enough you will figure out how to do it anyway - if not, 
 you can always write an e-mail to me :)

 =============
 4) How to use
 =============

 gPodder was designed with usability in mind. Saying that gPodder is 
 self-explaining saves me from writing long documentation, but here is a 
 quick summary how i use gPodder:

   a) Click "Add Feed" and enter some feed url
   b) gPodder will automatically download the feed index
   c) Double-click the episode you want to download
   d) The episode will be downloaded
   e) After successful download the episode disappears from the list
   f) All your downloaded episodes appear when you click on
      "downloaded podcasts" - here you can listen to the podcasts
   g) To check for new episodes, click "Update feed cache"
 
 =============
 5) Known bugs
 =============

 Here is a short list of known bugs which i (or someone else) will fix 
 soon hopefully:

   *) Should do more testing with different feeds (report non-working feeds!)
   *) Make selection list more cute (replace URLs with nice captions)

 =========================================
 6) Feature requests, bug reports, patches
 =========================================

 Feel free to mail me about feature requests, bug reports, patches or nearly
 anything that comes to your mind relating gPodder:

   eMail: thp@perli.net
   www: http://www.perli.net/projekte/gpodder/


 Last but not least... have fun with gPodder :)

                                    -- Thomas Perl, September 6th 2005


