hello world

1 files changed, 173 insertions, 0 deletions

diff --git a/docs/README b/docs/README
new file mode 100644
index 0000000..3cd4439
--- /dev/null
+++ b/docs/README
@@ -0,0 +1,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
+
+
+
+
+