Corsair - Qtopia RSS/Podcast Aggregator v0.1

Copyright (C) 2005 Joe Rumsey (joe at rumsey dot org)

See INSTALL for help building.

To install on your PMA4xx or other device, put the .ipk file on your
device (in /media/Documents for PMA4xx), and run package manager.
Select Corsair and install it.

Corsair is an RSS aggregator designed for mobile devices, especially,
but not limited to, the Archos PMA series, and specifically meant to
handle podcast feeds.  It can maintain a list of feeds, check those
feeds for updates, download enclosures, and view descriptions of those
feeds.  Although it was originally intended solely as a podcast
aggregator, it may turn out to be a pretty good general purpose RSS
aggregator too.

The code will likely compile for any Qtopia based platform.  Binary
packages meant for the PMA4xx may even work out of the box on other
ARM based platforms.  No guarantees of any kind are made for any
platform.

This is version 0.1, and is lacking a great deal of planned
functionality, but is already very usable.  See the TODO file for
details of what's to come, or ideas for what I could use help with.

Help in testing/porting to platforms other than the Archos PMA4xx
would be especially appreciated.  I'd like the binary packages to at
least work out of the box on the Sharp Zaurus too, but I have no idea
if they will.  It can also be run on desktop Linux systems using qvfb
and qpe... but I don't know why you would other than for development
purposes.  It is designed for small screen limited capability devices
with more storage than the author knows what to do with otherwise.

Usage:
	Add some feeds:
		Click top button on left hand toolbar
		Automatically pastes text from clipboard - use Opera
		(or browser of your choice) to copy RSS feed URL to clipboard,
		then switch to Corsair and click add

	  -OR:
		Put feeds you want in $(HOME)/Documents/corsair/feeds.opml
		Standard OPML file from any RSS aggregator should work.  Let
		me know if it doesn't.  This file will be overwritten when you
		add or delete feeds.

	Update a feed:
		Click Get button (Green arrow pointing down) to check for
        updates.  (Automatically done when first adding a feed.
		Do this in the future)
		
	View descriptions of items in a feed:
		Expand a feed using the [+] buttons in the list
		Select, click "info" button (lower case i icon).
		Use Next/Prev buttons to nagivate through the feed's 
		items (won't leave the current feed)

	Download a podcast:
		If an item has an enclosure, either click Download button
		in the info window, or select it in the main list and click
		the Download toolbar button (Green arrow pointing down, same
		button as updating a feed)

		Enclosures are downloaded to $(HOME)/Documents/corsiar/shows/<ShowName>
		for now.  Still need to figure out how to get them into the
		"real" hierarchy.  But the PMA's player can play them directly
		from there, at least in the latest firmware.