iPodder -- The cross-platform Podcast receiver
----------------------------------------------

http://ipodder.sourceforge.net/
Version 2.0 -- March 16, 2005.
Upgrade notes and Release notes below.

 ----------
 Late breaking news:

 If you're running iTunes, please update to the latest 4.7.x version.
 ----------

BASIC INSTRUCTIONS:

1. Launch iPodder

2. Add podcast feeds.

a. Option 1.  Copy/paste podcast feed URLs into the text input box on the
   Status tab and click Add Feed.
   
b. Option 2.  Click on the Directory tab.  Navigate the tree
   by clicking or double-clicking on the name of the directory or the folder icons. 

   Podcast feeds will have a orange dash icon next to them.  When you select a
   feed, its URL will appear at the bottom of the window.  Add the feed
   to your subscriptions by clicking Add.  It should show up in the main
   subscriptions window with state "newly-subscribed".

3. Set scheduler options

A bit of magic happens when you pick up your MP3 player and fresh content
is already there waiting for you.  Use iPodder to schedule automatic downloads
by entering the times you'd like it to run in the Tools -> Scheduler menu option.
First check the box next to "Enable scheduler".  If you'd like
iPodder to run at specific times, select the "Check at these specific times" radio
button and enter the specific times.  If you plan to listen to podcasts on
your morning commute, you might set iPodder to perform downloads a few hours
before you leave.  Alternatively, you can set iPodder to run at regular
intervals.  Select the interval from the "Repeat every" menu.  Finally, click
"Save and Close" to apply the settings.

4. Walk away

Well, not literally.  But do hide or minimize iPodder and forget about it for
a while.  Based on your scheduler settings, iPodder will check for and download
new content and transfer it to your iTunes or Windows Media Player.  Of course
if you'd like you can check for new podcasts at any time, just be prepared to
stare the download progress bar for a bit.  

5. Listen!

When you're ready to listen, sync your MP3 player and you're on your way.
If you're running Windows and leave your iPod connected, iPodder will
automatically sync it after finishing its downloads.

6. Power user tip

To help manage the volume of new content, we suggest using your music management
software to create a smart playlist of the last N songs added.


IF UPGRADING FROM 1.1 through 1.1.4:

Nothing to say here.

IF UPGRADING FROM 1.0:

Windows: Ideally everything went well and your existing settings were migrated by
the installer.  Keep reading if your settings were lost.  In iPodder 1.0 the settings
were stored in the iPodder installation directory, probably
C:\Program Files\iPodder.  Starting with version 1.1 the configuration are placed outside
the installation directory, in a user-specific directory, if possible.  The default location
is the NT-style Application directory, usually
C:\Documents and Settings\yourname\Application Data\iPodder.  If your settings were lost,
try locating these three files in the previous installation directory and copying them to
the new configuration directory: favorites.txt, history.txt, schedule.txt.

Mac: Ideally everything went well and your existing settings were migrated by
the installer.  Keep reading if your settingswere lots.  In iPodder 1.0 the
settings were stored in the iPodder installation directory, probably
/Applications/iPodder.  Starting with 1.1 the configuration files are placed
outside the installation directory, in a user-specific directory, if possible.
The default location is /Users/yourname/.iPodder.  Note that this directory
will be hidden in the finder because it begins with a (.).  You may navigate
directory to this folder by selecting Go from the Finder menu and typing in
the folder location.  If your settings were lost, try locating these three 
files in the previous installation directory and copying them to the new
configuration directory: favorites.txt, history.txt, schedule.txt.

NEW IN RELEASE 2.0:

  - New resizable GUI.
  - Check/uncheck individual episodes
  - Downloads log
  - Catchup mode downloads just the latest episode from each feed.
  - Enhanced directory browsing including refresh
  - Cleanup tab
  - Internationalization
  - Multithreaded downloads
  - Cancel downloads
  - Resume interrupted downloads
  - Check for update
  

OLDER RELEASES:

1.1.4 (November 17, 2004)

  - Enhanced, resizable podcast directory window.

1.1.3 (November 13, 2004)

- This is mostly a bugfix release, major issues resolved:
  - Changes to download directory should now be persistent in cases where it wasn't (Mac/Win)
  - Manually added feeds no longer have garbage at the end (Mac)
  - Auto-play feature can now be disabled from the Preferences tab.
  - Better handling of unicode feed titles
  - Logging improvements
  - User customizable directory roots.  Add a line like this to ipodder.cfg:
    podcast_directory_roots = [('http://some.root/','Some Root'),('http://some.other.root/','Some Other Root')]

1.1.2 (November 11, 2004)

Short-lived precursor to 1.1.3, with a minor bug.


1.1 (November 4, 2004):

- Select podcast feeds by using the integrated directory (OPML) inside
iPodder or add feeds manually from the GUI. 
- Choose your own download folder! 
- The feed list now displays the title, location, downloaded MB and
subscription state for each feed. 
- Enhanced download progress feedback. 
- Don't want to check all feeds? You can now check just one feed. 
- iPodder can now run on startup. 
- Advanced options for Power Users. 
- Automatic setting of Grouping: Podcast for iTunes/Win users. 





