/
README
205 lines (113 loc) · 5.59 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
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