summaryrefslogtreecommitdiff
path: root/docs/README
blob: 3cd44391f4ec8639b761f5f1bc370eca9dfd116f (plain)
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
# x-vdr (Installations-Skript fuer einen VDR mit Debian als Basis)
# von Marc Wernecke - www.zulu-entertainment.de
# 05.03.2009

x-vdr ist ein interaktives Installations-Skript fuer einen VDR (Video Disk Recorder) mit Debian als Basis.

Dieses Skript steht ausschliesslich fuer die private, nicht kommerzielle Nutzung zur Verfuegung.
Das Benutzen geschieht auf eigene Gefahr und es wird keine Haftung fuer Schaeden an Mensch oder Computer uebernommen.

Viele Anregungen fuer das Skript stammen aus dem VDR-Wiki (http://www.vdr-wiki.de)
und von Mitgliedern des VDR-Portal (http://www.vdr-portal.de).

Der VDR ist von Klaus Schmidinger (http://www.cadsoft.de/people/kls/vdr/)

Die Plugins und Utilities sind von vielen, vielen lieben Leuten, die ihre Freizeit opfern,
damit wir so tolle Sachen mit unseren Computern machen koennen.

Fuer Tests mit diesem Skript empfehle ich eine frische Installation einer aktuellen Debian-Distribution.
Mein Favorit dabei ist Sidux (http://www.sidux.com)

Der notwendige Sourcecode fuer den VDR, die Plugins sowie für einige Utilites wird während der Installation aus dem Internet geladen
und auf der Festplatte (innerhalb des x-vdr Verzeichnisses) abgelegt.

Alles was sonst noch notwendig ist (je nach Distribution 50-100 MB), wird mittels apt-get installiert.

HaveFun



STRUKTUR:
*****************************************************
Das Start-Skript ist x-vdr.sh. x-vdr.sh ruft alle andern Skripte auf.
Konfiguriert wird das ganze in x-vdr.conf und den einzelnen Skripten.
Das Setup-Menu legt eine eigene Konfigurations-Datei (setup.conf) an.
Die Skripte lesen erst die Konfigurations-Dateien und dann die Funktionen ein.
/x-vdr/x-vdr.sh
|-> /x-vdr/x-vdr.conf
|-> /x-vdr/setup.conf
|-> /x-vdr/functions

Bei einer Erstinstallation werden die Skripte in dieser Reihenfolge aufgerufen:
/x-vdr/x-vdr.sh
|-> /x-vdr/apt.sh
|-> /x-vdr/vdr/install-vdr.sh
|-> /x-vdr/utilities/xxx/utilitie.sh
|-> /x-vdr/plugins/xxx/plugin.sh

In apt.sh gibt es u.a. eine kick-liste, in der stehen Programme die entfernt werden.
Also mal einen Blick rein werfen ;)
Die apt.sh braucht nur bei der ersten Installation mitgestartet werden.
Bei einem Update des VDR wird die apt.sh nicht mehr aufgerufen.
Ganz Abgeschaltet werden kann sie in der x-vdr.conf mit APT=off

Moegliche Parameter fuer x-vdr.sh sind:
--dir|-d /path/to/x-vdr  -> Muss als erster Parameter uebergeben werden!
                            Gefolgt von einer Pfadangabe zum x-vdr Verzeichnis
--config|-c              -> VDR wird nicht beendet (funktioniert nicht zusammen mit --install)
--install|-i             -> entfernt alten vdr und startet eine direkte Installation
--no-xdialog|-n          -> dialog verwenden
--xdialog|-x             -> Xdialog verwenden
--help|-h                -> Zeigt was du siehst und beendet x-vdr
--version|-v             -> Zeigt die Versionsnummer und beendet x-vdr

Einzelne Parameter muessen duch eine Leerstelle getrennt werden.

In /usr/local/src wird ein Symlink "x-vdr" auf das x-vdr Verzeichnis angelegt.
Weiter wird in /usr/local/bin ein Symlink "x-vdr" auf x-vdr.sh angelegt.
Damit ist es moeglich, x-vdr ab dem zweiten Aufruf mit dem Befehl "x-vdr" zu starten.


INSTALLATION:
*****************************************************
# in den Superusermode wechseln wenn Du nicht als root angemeldet bist.
su
# neuste Version laden
wget http://www.zulu-entertainment.de/page/klick.php?d=x-vdr
# auspacken
tar xvfz x-vdr-*.tar.gz
# In das x-vdr Verzeichnis wechseln
cd x-vdr
# Skript ausfuehrbar machen
chmod 755 x-vdr.sh
# Eventuell die Konfiguration aendern. Alles wichtige kann aber auch im Setup-Dialog eingestellt werden.
mcedit x-vdr.conf
# Installation starten
./x-vdr.sh

Das Informations Fenster mit OK schliessen.
Dann im "Startmenu" Punkt 1 (Interaktive Installation) waehlen.
Einstellungen vornehmen und Installation starten.

Waerend apt-get das System aktualisiert muessen einige Fenster bedient werden.
Danach kann das Script unbeaufsichtigt arbeiten...

Und bitte MIT VISUDO DIE SUDOERS BEARBEITEN!!!
Mehr dazu steht weiter unten.


USER:
*****************************************************
Wird x-vdr mit seinen standard Einstellungen ausgefuehrt, legt das Skript
einen neuen Benutzer "vdruser" und eine neue Gruppe "vdrgroup" an.
Weiter traegt es diesen Benutzer und die Gruppe in /etc/default/vdr ein.
VDRUSER="vdruser"
VDRGROUP="vdrgroup"

Das VDR-Start-Skript "runvdr" liest /etc/default/vdr und startet den VDR dann als User "vdruser".
Da aber einige Funktionen nur als root ausgefuehrt werden duerfen, wird noch das extra Skript "vdr2root" benoetigt.
Es liegt nach der Installation in /usr/lib/vdr/scripts. Wer es sich vorher mal ansehen will, findet es in /x-vdr/vdr/scripts.


VISUDO:
*****************************************************
Damit der VDR ohne Root-Rechte funktioniert muss "vdr2root" in die /etc/sudoers eingetragen werden.
"vdrsetup" ist ein Skript zum Verwalten des mit x-vdr installierten VDRs (das osdserver plugin wird benoetigt).
"vdrmount" wird von diversen Plugins zum Einbinden der Laufwerke benutzt.
Dann muss noch /bin/ln fuer dvdselect oder dvdswitch mit dazu.

Kurze Anleitung:
Als root eine Konsole oeffnen und "visudo" eingeben.

Mit der Taste i kommt mensch in den EINFUEGEN Modus.
Mit den Pfeiltasten navigieren und den Eintrag wie folgt ergaenzen:

# User privilege specification
root    ALL=(ALL) ALL
vdruser ALL=NOPASSWD: /usr/lib/vdr/scripts/vdr2root, /usr/lib/vdr/scripts/vdrsetup, /usr/lib/vdr/scripts/vdrmount, /bin/ln

Der Pfad zu vdr2root, vdrsetup und vdrmount muessen mit denn eigenen Angaben in der x-vdr.conf uebereinstimmen!
Mit der Taste ESCAPE wird der EINFUEGEN Modus wieder beendet.
Dann kann visudo mit der Eingabe von :wq also Doppelpunkt und w und q und Return beendet werden.
vi speichert daraufhin die Aenderungen. Soll vi beendet werden ohne die Aenderungen zu uebernehmen, kann dies mit :q RETURN
getan werden.


PATCHES:
*****************************************************
Im Verzeichnis vdr und in den plugins gibt es je ein Verzeichnis "patches".
Dateien mit den Endungen .bz2 , .patch und .diff die in einem solchen Verzeichnis liegen werden automatisch ausgefuehrt.


NEUES PLUGIN HINZUFUEGEN:
*****************************************************
Dafuer kann zB das femon-plugin als Vorlage genommen werden.

cd /usr/local/src/x-vdr/plugins
cp -R femon NEUESPLUGIN
cd NEUESPLUGIN
mcedit plugin.sh

In der plugin.sh folgendes anpassen:

WEB="http://www.saunalahti.fi/~rahrenbe/vdr/femon/files/vdr-femon-0.9.8.tgz"
VERSION="femon-0.9.8"
LINK="femon"

Falls keine extras notwendig sind war es das, und das Plugin kann mit:
./plugin.sh --make
installiert werden. Wird der Verzeichnisname von NEUESPLUGIN in die x-vdr.conf bei den Plugins
eingetragen, wird das neue Plugin beim naechsten mal gleich mit installiert.

Moegliche Parameter fuer plugin.sh sind:
--clean|-c               -> entfernt das Plugin
--install|-i             -> entpackt das Plugin etc.
--make|-m                -> wie --install aber das Plugin wird sofort uebersetzt
--remake|-r              -> wie --clean und --install und --make
--status|-s              -> 0=nicht gefunden, 1=gefunden
--version|-v             -> Zeigt die Plugin-Version des Skripts