Juice -- The cross-platform Podcast receiver
--------------------------------------------

http://juicereceiver.sourceforge.net/
Version 2.2.2-a1 -- July 2006

New since 2.2.2-a1
------------------

* 1463540: Handle filenames with spaces (thanks, vladekk!)

* 1530020: Automatic cleanup should delete downloads for disabled subs

* 1534122: Cleanup code should respect feeds sharing directories

New in 2.2.2-a1
---------------

* Fixed problems with Unicode in feeds and filenames. 

* Made the log less verbose with respect to GUID matches on changed
  enclosure names.

* Added cleanup_sort_by_size option. 

* Fixed 1523785: problem with new FeedBurner URLs.

* Fixed 1524119: catch another kind of timeout. 

* Better error handling for oneclick registration and episode playing. 

* Removed Todd Maffin's OPML from the directory, as it's gone. Also added
  PodLook. 

* Fixed some problems with the updater. 

* Updated release process.

* Added Baris Atasoy's Turkish translation. 

* Fixed 1525166: Can't export non-ascii subscriptions to OPML.

New in 2.2
----------

1. iPodder -> Juice name change

2. Expanded support for various one-click subscription mechanisms.
   On Windows: a File Types tab in Preferences to set these behaviors.

3. Clipboard support for feed/podcast URLs on Windows/Mac

4. Winamp support for playing and enqueuing files. (Windows only)

5. User guide, linked from Start -> iPodder -> UserGuide on Windows.

6. Downloaded files are named after the final URL instead of the
   initial URL when HTTP redirects are encountered.

7. Enriched the history data we save, to allow us to support a number of
   new features.  For example, script-powered download URLs should work
   now.

8. The history database cleans up after itself, deleting history
   records for items that are both old and no longer present in
   the feed.

9. Allow re-downloading files that have gone missing by marking
   them as Removed.

10. New languages: Danish, Basque, Finnish, Italian, Korean, Greek

11. Added support for password-protected proxies (HTTP Basic and Digest).

12. Added support for password-protected feeds and downloads
   (HTTP Basic and Digest).  Please note: protected downloads must live
   on the same domain as the feed in order for this to work.

13. Download code now respects content-disposition header for download
   files whose names are different than the URL at which they're located.

14. Fixed BitTorrent abort/resume.  Partially downloaded BitTorrents now
   show up with Partial status instead of Downloaded.

15. Fixed a bug in Windows Media Player support that resulte in Date Added
   not getting set.  Date-based auto-playlists work now.

16. Feedmanager OPML fetcher now runs in a background thread unless we're
   about to do a download run.

17. Directory root for newly added directories, where we'll put
    directories that haven't yet been added to the stable release.

18. Moved scheduler configuration data into ipodder.cfg

19. Minor refactors: moved iPodder.py to ipodder/core.py,
    moved iPodderWindows.py to the gui directory.

20. Python24 compatibility fixes (ongoing)


------------------

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 2.0.5:

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.1:

  - One-click subscription support enabled as voted on in the ipodder-dev
    Yahoo! groups list and documented here:
    http://pswg.jot.com/WikiHome/DraftPublications/OneClickSpec2

  - Synch subscriptions to remote OPML file (under File -> Preferences ->
    Feed manager).

  - Auto cleanup.  Ability to specify on a per-feed basis that episodes older
    than N days should be auto-cleaned up.  Cleanups take place immediately
    after each check for new episodes.  These options are set in the feed
    properties window, reachable by double-clicking on the feed or from the
    right-click menu for the feed.

  - Genre overriding in iTunes.  See File -> Preferences -> Player.

  - New translations: Spanish, Galego, Catalan, Russian, Serbo-Croation,
    Hungarian, Chinese, Swedish, Brazilian Portuguese, Polish.

  - Accessibility improvements: saner focus behavior, new Ctrl-L
    accelerator for the Scheduler, Shift-F10 for right-click, space bar
    toggling in the episodes window and downloads tab.

  - Feed manager OPML text entry box is drag and drop aware.

  - Catchup behavior is configurable: it can permanently (default)
    or temporarily skip older episodes.

  - Close window behavior is configurable: it can cause the app to
    go to the background (default) or cause the app to quit.

  - Hitting Del key in the feeds list deletes selected feeds.

  - Update checker can be disabled (under File -> Preferences).

  - Windows app will now wake rather than complain if a second copy is running.

  - New right-click option for feeds: Open downloads folder

  - Right-click menus in the episodes and downloads tab link to show
    notes and hyperlinks found within RSS item description.

  - A window now pops up when the disk space falls below the minimum,
    instead of seeming to freeze.

  - Cleaned up episodes are removed from Downloads tab.

  - iPodder/Mac now sets iTunes grouping to 'Podcast', just like Windows.

  - Updated Windows installer: detects running iPodder, new look.

  - Plugin architecture supporting the new right-click menus.  In progress.

  - New localization architecture supports drop-in .py catalog files.

  - New skinning code for store Level 2.

  - Better stability against iTunes version changes.

  - Partial fix for the UnicodeDecodeError for download directories
    with non-ascii characters.  May not work for non-Western encodings.

  - Partial fix for URLs with ? in them.  Downloads proceed but player
    integration still buggy.

  - Manual updates by dropping in an 700KB update file (lightly tested).

-----------------

OLDER RELEASES:

2.0 (March 16, 2005)

  - 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

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.