[Bug-gnupod] Documentation on dealing with podcasts

[Jacinta Richardson]

First of all, thank-you so very much for this tool, it is absolutely awesome
that I can manage my iPod via scripts and on the command-line.  As a Perl
programmer, I find it much easier to knock up a script to rename titles than to
work out how to automate that through a GUI!

The documentation for 4.8 Dealing with podcasts is very slim.  I was trying to
add podcasts for the first time today, and found that when I added podcast files
using gnupod_addsong:

        gnupod_addsong -m /mnt/usb podcasts/*

that my 4th Gen Nano iPod would refuse to see them as Podcast files even after I
had created a playlist as recommended in the documentation.  This turned out to
be because the media value (and possibly some other flags) was set incorrectly.
   It took me several hours of mounting and unmounting to finally spot what was
going on.

I think it would be helpful if the documentation was expanded, as below:

##############################################
4.8 Dealing with podcasts

Do not add podcast files in the same way as you add regular songs.  In order for
your iPod to distinguish between Podcasts and songs, we need to make sure the
media type is set correctly.  To add a single podcast do the following:

        gnupod_addsong.pl -p "Podcast Title" --playlist-is-podcast podcast.mp3

You can add multiple podcasts to the same title as well:

        gnupod_addsong.pl -p "Podcast Title" --playlist-is-podcast podcasts/*

This also tells the iPod to skip this file when shuffling files.  See
gnupod_addsong.pl -h for more options.

If you want to create additional podcast playlists you just need to set the
podcast flag to '1':

         <playlist name="Test Podcast" podcast="1">
           <iregex artist="John Doe" />
         </playlist>

Such a playlist will show up as a Podcast after running mktunes.pl

gnupod_addsong.pl can also download podcasts and create such playlists itself:

        gnupod_addsong.pl -p "Heute Morgen" --playlist-is-podcast
http://pod.drs.ch/heutemorgen_mpx.xml

Running this command will create a Playlist called 'Heute Morgen' (-p) and set
podcast="1" (--playlist-is-podcast). gnupod_addsong.pl will then fetch the
podcast from http://pod.drs.ch/heutemorgen_mpx.xml, download all (new) files and
add them to the 'Heute Morgen' playlist!

##############################################

All the best,

        J

-- 
   ("`-''-/").___..--''"`-._          |  Jacinta Richardson         |
    `6_ 6  )   `-.  (     ).`-.__.`)  |  Perl Training Australia    |
    (_Y_.)'  ._   )  `._ `. ``-..-'   |      +61 3 9354 6001        |
  _..`--'_..-_/  /--'_.' ,'           | address@hidden |
 (il),-''  (li),'  ((!.-'             |   www.perltraining.com.au   |