mediarip README (for an english version see below)
===============

Mediarip laedt voll automatisch Videos aus der 'ZDFmediathek' herunter 
und transcodiert diese gleich in ein anderes Format falls gewuenscht.

Dazu ist keinerlei Browser oder grafische Oberflaeche noetig.

Sie muessen lediglich die Sendungen definieren, an denen sie interessiert sind.
Bei jedem Start von mediarip wird dann automatisch nach neuen Folgen ihrer Serien gesucht, 
die dann herunter geladen und anschliessend in ihr gewuenschtes Format transcodiert werden.

Tipp: Um mediarip komplett automatisiert arbeiten zu lassen, ist ein cronjob zu empfehlen.


Abhaengigkeiten
---------------

- ein paar Perl Module

    LWP::UserAgent
    DBI             # wird nur benoetigt, wenn DATA_STORE_METHOD in der CONFIG auf 'db' gesetzt ist

- mencoder,         # wird nur benoetigt, wenn CONVERT in der CONFIG auf 'yes' gesetzt wurde 
                    # muss mit der Unterstuetzung fuer folgende Bibliotheken gebaut worden sein: libmp3lame, libx264 und libxvidcore
- mplayer


aktuelle Version herunter laden 
-------------------------------

    git clone http://git.sven-burkard.de/mediarip/

oder vom github mirror:

    git clone https://github.com/svenburkard/mediarip.git



Konfiguration
-------------

Sie muessen lediglich die CONFIG Datei ihren Wuenschen entsprechend bearbeiten.
Hierbei ist zu beachten, dass manche Einstellungen Abhaengigkeiten haben.

Wenn sie als DATA_STORE_METHOD eine Datenbank verwenden, muessen sie eine entsprechende Datenbank 
mit dem Namen 'mediarip' anlegen und einen Benutzer mit den noetigen Rechten erstellen.


Anwendung
---------

Zu aller erst muessen sie eine oder mehrere Sendungen definieren, die auf neue Folgen hin ueberprueft werden sollen. 
Also lassen sie sich erst einmal die verfuegbaren Sendungen auflisten

    ./control.pl --list on

Eine beispielhafte Zeile des Ergebnisses waere z.B.: 'zdf: SOKO_5113'
Nun tragen sie einen neuen Eintrag in die MEDIA Liste ein.

    ./control.pl --add --source='zdf' --show='SOKO_5113'

Sie koennen ebenfalls einen alternativen Pfad fuer diese Sendungen definieren, wenn der standard Pfad nicht verwendet werden soll.

    ./control.pl --add --source='zdf' --show='SOKO_5113' --path='/video/'

Es koennen anschliessend ganz einfach die bereits von ihnen eingetragenen Sendungen aufgelistet werden.

    ./control.pl --list off

Natuerlich kann eine Sendung auch wieder von ihrer MEDIA Liste geloescht werden.

    ./control.pl --del --source='zdf' --show='SOKO_5113'


Weitergehende Informationen ueber das control Script erhalten sie mit 
    
    ./control.pl --help


Nun koennen sie einfach das mediarip Script aufrufen

    ./mediarip.pl


Fuer eine perfekte Konfiguration von mediarip sollten sie nun noch einen crontab Eintrag erstellen, 
damit ihre Sendungen komplett automatisch aktualisiert werden.
Das unten stehende Beispiel zeigt einen cronjob, der alle 60 Minuten das mediarip Script startet.

    */60 *    * * *  user  cd /pfad/bis/mediarip/ && /pfad/bis/mediarip/mediarip.pl


Projekt Seite
-------------
http://mediarip.de


Autor
-----
Sven Burkard - dev@sven-burkard.de

http://sven-burkard.de



mediarip README (english)
===============

Mediarip is able to download videos of the 'ZDFmediathek' fully automatially
and can also transcode them on the fly, if wanted.

Mediarip doesn't require a browser or a graphical interface.

You just have to define the shows which you are interested in.
Each time mediarip is started it checks for new episodes of the defined shows
and will download and transcode them automatically.

Tip: Starting mediarip as a cronjob is recommended for a full automatic setup. 


Dependencies
------------

- some Perl modules

    LWP::UserAgent
    DBI             # only needed, if DATA_STORE_METHOD is set to 'db' in CONFIG

- mencoder          # only needed, if CONVERT is set to 'yes' in CONFIG 
                    # built with libmp3lame, libx264 and libxvidcore  
- mplayer


Cloning
-------

    git clone http://git.sven-burkard.de/mediarip/

or, from github mirror:

    git clone https://github.com/svenburkard/mediarip.git


Configuring
-----------

You just have to fill the CONFIG file with your values.
Some settings have dependencies to other ones.

If you use a database as DATA_STORE_METHOD, you need to create a database named 'mediarip'
and a user who has access to this database.


Usage
-----

First of all, you need to add some shows, which should be checked for new episodes from mediarip.
So you look for all available shows from one source.

    ./control.pl --list on

One example line of the result could be 'zdf: SOKO_5113'
Now you need to add this entry to the MEDIA list.

    ./control.pl --add --source='zdf' --show='SOKO_5113'

You can also define a alternative path for a show, if the default path shouldn't be used.

    ./control.pl --add --source='zdf' --show='SOKO_5113' --path='/video/'

You can simply get all shows which you have added.

    ./control.pl --list off

A show can also be deleted from the MEDIA list.

    ./control.pl --del --source='zdf' --show='SOKO_5113'


You can get further information about the control script.
    
    ./control.pl --help


Now you can simply start the main script vom mediarip.

    ./mediarip.pl

For a perfect setup you should create a crontab entry for mediarip.pl. Doing so allows your shows to be updated fully automatically.
The example given below shows a cronjob that starts the mediarip script every 60 minutes. 

    */60 *    * * *  user  cd /path/to/mediarip/ && /path/to/mediarip/mediarip.pl


Project Site
------------
http://mediarip.de


Author
------
Sven Burkard - dev@sven-burkard.de

http://sven-burkard.de