Podkatzer - der einfache Podcatcher
von Guido Poschta <moolder@gmx.net>
Version vom 3.7.2006

1. Funktionalitt

Podkatzer ldt bei jedem Lauf die neuen Podcasts aller abonnierten Feeds herunter.
Zuvor werden alle Podcasts gelscht, die lter sind als das vom Benutzer angegebene Maximalalter. Die durchgefhrten Aktionen werden protokolliert und in einer HTML-Datei aufbereitet.


2. Bentigte Software

Podkatzer bentigt Perl (http://www.perl.com/download.csp) - unter Windows eignet sich gut ActivePerl (http://www.activestate.com/ActivePerl/).


3. Konfiguration

3.1. Die Datei "data\feeds.txt" enthlt die Liste der abonnierten Feeds. Dabei wird jeder Feed in einer Zeile notiert, im Format

Feedname<tab>URL der RSS-Datei<tab>Speicherdauer in Tagen

Beispiel:

Tagesschau Podcast	http://www.tagesschau.de/export/podcast	3

Demnach wird im Verzeichnis "podcasts\Tagesschau Podcasts\" der Podcast der Tagesschau gespeichert. Dateien in diesem Verzeichnis werden nach 3 Tagen gelscht.
Die Speicherdauer in Tagen ist optional. Wenn sie weggelassen oder auf 0 gesetzt wird, dann werden Podcasts dieses Feeds nie gelscht.
Wenn die Speicherdauer in Tagen auf -1 gesetzt wird, werden alle im Feed enthaltenen Podcasts ignoriert.
Der Feedname darf keine Sonderzeichen enthalten.
Falls die Zeile mit einem Doppelkreuz "#" beginnt, wird sie ignoriert.


3.2. Die Datei "data\podcasts_ignore.txt" enthlt die bereits heruntergeladenen Podcasts im Format

Feedname<tab>Podcast-Dateiname<tab>Podcast-URL<tab>Podcast-Gre in Bytes<tab>Verfftl.Datum nach Dublin Core

An dieser Datei mssen Sie keine Vernderungen vornehmen, auer sie wollen einen zuvor heruntergeladenen oder bisher ignorierten Podcast herunterladen. In diesem Fall mssen sie die entsprechende Zeile aus "data\podcasts_ignore.txt" lschen.


3.3. Die Datei "config.pl" enthlt Konfigurationen fr die Scripte von Podkatzer. Hier kann auch das Verzeichnis angepasst werden, in dem die Podcasts abgelegt werden. Verndern Sie zu diesem Zweck die Zeile

$podcastPath = 'podcasts/'; # target path for podcasts

Es ist wichtig, dass die Dateipfade mit Vorwrts-Schrgstrichen (wie bei unix), und NICHT mit Rckwrts-Schrgstrichen (wie bei Windows) notiert werden, z.B.:

$podcastPath = 'C:/mp3/podcasts/'; # target path for podcasts

Die weiteren Einstellparameter sind direkt in "config.pl" beschrieben.


4. Hinzufgen eines neuen Feeds

Fgen Sie eine Zeile zu "data\feeds.txt" im oben beschriebenen Format hinzu. Verwenden Sie "-1" als Speicherdauer in Tagen, falls Sie nicht alle bisherigen Podcasts des Feeds herunterladen wollen. Fhren Sie Podkatzer einmal aus wie unten beschrieben. Setzen sie dann die Speicherdauer in Tagen auf den von ihnen gewnschten Wert, oder lschen Sie die Speicherdauer in Tagen, um die Podcasts des Feeds auf Dauer zu speichern.


5. Podkatzer ausfhren

Unter Windows fhren Sie das Batch-File Podkatzer.bat aus, um den Programmlauf zu starten. So werden die Teile des Podkatzers automatisch nacheinander ausgefhrt:

"cleanup-podcasts.pl" lscht veraltete Podcasts
"get-feeds.pl" holt aktuelle Feeds
"fetch-podcasts.pl" holt neue Podcasts.
"log2html.pl" erzeugt eine Logdatei "Podkatzer.log.html" im HTML-Format

Diese Logdatei wird am Ende des Programmlaufs mit dem Default-Browser angezeigt.

Fr Linux mssen Sie ein bash-Script mit gleicher Funktionalitt erstellen. 


6. Troubleshooting

Typische Fehlerquellen, wenn etwas nicht funktioniert:

- Perl ist nicht installiert / nicht im PATH.
- Die Konfigurations-Dateien entsprechen nicht dem definierten Format.
- Podkatzer hat nicht die ntigen Schreibrechte (nur unter Unix). Podkatzer bentigt Schreibrechte in den Ordnern "data/" "feeds/" und "." (dem Verzeichnis, in dem das Script ausgefhrt wird).
- wget / tee / rm werden nicht gefunden.
- Es besteht keine Netzverbindung.

Um die Fehlerquelle zu identifizieren, mssen Sie die Logausgaben von Podkatzer anschauen. Viel Glck!


7. Credits

Wenn Sie Podkatzer benutzen, wrde ich mich ber eine Mail an moolder@gmx.net freuen!

Podkatzer ist freie Software im dem Sinne, das Sie sie gerne nach ihren Wnschen verndern drfen. 

Ja ich weiss, Podkatzer ist nicht schn. QuickAndDirty trifft es eher. Aber mir langt es vorerst so.

Benutzt werden die Unix-Befehle "wget", "tee" und "rm". Diese sind fr Windows als .exe Dateien aus den Unxutils (http://unxutils.sourceforge.net/) beigelegt. Danke an Karl M. Syring <syring@web.de> fr diese praktischen Ports der Unix-Befehle!
