File	Date	Author	Commit
database-sql	2009-06-02	Craig Maloney	[974fe7] Moving piddlepodder schema to database-sql, Cr...
CHANGELOG	2008-05-20	Craig Maloney	[7635f9] Piddlepodder 1.0
COPYING	2008-05-20	Craig Maloney	[7635f9] Piddlepodder 1.0
README	2008-05-20	Craig Maloney	[7635f9] Piddlepodder 1.0
README_PROXIES	2008-05-20	Craig Maloney	[7635f9] Piddlepodder 1.0
TODO	2009-03-10	craigm	[9643d0] More todo stuff
UPGRADE	2008-05-20	Craig Maloney	[7635f9] Piddlepodder 1.0
convert_feeds.pl	2009-02-16	Craig Maloney	[854266] Conversion script and feeds file
feeds	2009-02-16	Craig Maloney	[854266] Conversion script and feeds file
piddlepodder.db	2009-03-04	Craig Maloney	[a36036] Modified database
piddlepodder.pl	2010-08-24	Craig Maloney	[035986] More modifications, but pretty much the end of ...
piddlepodder_tables.txt	2009-02-08	Craig Maloney	[42de1a] Adding basics info for Piddlepodder with SQLite

Read Me

PiddlePodder
By Craig Maloney
(http://decafbad.net/projects/piddlepodder)

INTRODUCTION
PiddlePodder is a podcatching client written in Perl. It is based off of
the simplicity of bashpodder with a few added features.  It downloads podcasts
from a list of XML feeds, and puts them into a download directory by date.  No
effort is made to copy the resulting files to an iPod, nor will this
application interface with a directory. It's just a simple podcatcher. 

That's it. 

PiddlePodder offers the ability to mark the set of podcasts as current (catch
up). This is handy for first-time users who would otherwise be stuck
downloading every show (sometimes since the beginning of the podcast) which can
lead to hefty download times and large amounts of disk space.

INSTALLATION
This application requires the following modules to be installed:

* Digest::MD5
* XML::DOM
* LWP::Simple
* LWP::UserAgent
* Getopt::Long

Copy the piddlepodder.pl file to a location you wish to run. 
Use "chmod 755 piddlepodder.pl" to make it executable. 
Configure piddlepodder if necessary. By default the program uses the following
directories:

Download are stored in: ~/downloads/ipod
Configuration files are stored in: ~/.piddlepodder

Edit the file if you wish to change the defaults.

Run piddlepodder.pl to create the default configuration directory
(~/.piddlepodder) and the default configuration file
(~/.piddlepodder/piddlepodderrc). 

Run piddlepodder.pl again to create the sample feeds file. (Don't worry, I
refrained from putting scads of default feeds that you'll have to delete later
into this file. :) )

Next, place some feeds into ~/.piddlepodder/feeds. 

Here are some samples (OK, I couldn't resist a little promotion)

http://www.bitsmack.com/wp/?feed=rss2
http://kcrw.com/podcast/show/ls
http://magnatune.com/podcasts/xml/classical.xml
http://magnatune.com/podcasts/xml/hard_electronic.xml
http://magnatune.com/podcasts/xml/philharmonia_baroque_and_its_musicians.xml
http://magnatune.com/podcasts/xml/space_music.xml
http://magnatune.com/podcasts/xml/instrumental.xml
http://magnatune.com/podcasts/xml/new_age.xml
http://feeds.feedburner.com/IndiefeedAlt/modernRock
http://feeds.feedburner.com/IndieFeedBlues
http://feeds.feedburner.com/IndiefeedElectronica
http://feeds.feedburner.com/IndiefeedHipHop
http://feeds.feedburner.com/IndustrialRadio

Finally, run piddlepodder.pl, and enjoy your podcasts. You may also run
piddlepodder.pl -c which will "catchup", and will mark the files ready to
download as completed. Running "piddlepodder.pl -c" is highly recommended, as
there could be several gigabytes (terabytes?) of shows ready for download when
first run.

Piddlepodder maintains a file under .piddlepodder called "done" which contains
the list of the URLs it has downloaded. This file is very important to
piddlepodder, and will determine whether a show is downloaded again or not. In
future releases this file will be purged based off of the current feed links.

Piddlepodder 0.3 introduces a new file called "exceptions" under
.piddlepodder.  This file contains regular expressions of files you don't want
to download. Say you're subscribed to a massive information technology feed,
but don't care to listen to a particular topic. assuming they've regularly
named their files with that particular topic, you can add it to the exceptions
file and rest assured you'll never have to download a show about that topic
again. You may want to run piddlepodder with -debug for a while just to make
sure it's running properly.

Please let me know if you enjoy this program, or if you have any patches or
comments.