Version 0.95vdr-0.95

- Fixed behaviour in case the shutdown didn't take place (there were many
  "next timer event at..." messages in that case).
- Reduced the default value for MinEventTimeout to 30 minutes.
- Fixed detecting manual start in shutdown feature.
- An error message is now displayed in case the Transfer Mode can't be
  started because the necessary DVB card is currently recording (or there
  is no DVB card that can access this channel).
- Fixed toggling channels with the '0' key in case the "Ok" button has been
  pressed to display the current/next information.
- Pressing the "Power" key now always initiates the shutdown sequence (after
  user confirmation in case of a recording timer), event if there is currently
  a menu or a replay session active. Note the additional remarks in INSTALL
  regarding the values of the two parameters given to the shutdown program
  in case of a currently recording timer.
- Switching through channel groups with the "Left" and "Right" keys now
  always starts at the group that contains the current channel.
- Implemented "Multi Speed Mode" (thanks to Stefan Huelswitt).
- Implemented backtracing to hit the right spot after fast forward/rewind
  (thanks to Stefan Huelswitt).
- Implemented replay mode display (thanks to Stefan Huelswitt, with a few
  rewrites by kls).
- Changed the size of all input buffers used to parse config files or receive
  SVDRP commands to the same value of 10KB. This allows long strings to be
  used in the 'summary' field of a timer, for instance.
- The pipe to the Dolby Digital replay command (option '-a') now closes all
  unused file descriptors in the child process to avoid crashing when the
  OSD is used (thanks to Andreas Vitting).
- Switched to the driver's new tuning API (VDR now requires a driver version
  dated 2001-09-14 or higher).
- Changed obsolete macro VIDEO_WINDOW_CHROMAKEY to VID_TYPE_CHROMAKEY (thanks
  to Guido Fiala).
- New version of the "Master-Timer" tool (thanks to Matthias Schniedermeyer).
- Better error handling when writing configuration files.
- Fixed putting the final editing mark into the edited version's marks file.
- Fixed manipulating an editing mark at the very end of a recording.
- Fixed starting a new replay immediately after stopping a previous one (had
  caused a mix between live video and replay).
- Three new keys ("Volume+", Volume-" and "Mute") to control the DVB card's
  audio output volume.
- New version of the 'epg2timers' tool (thanks to Carsten Koch).

1 files changed, 59 insertions, 95 deletions

diff --git a/Tools/master-timer/LIESMICH b/Tools/master-timer/LIESMICH
index 9694875..8e53da9 100644
--- a/Tools/master-timer/LIESMICH
+++ b/Tools/master-timer/LIESMICH
@@ -1,106 +1,70 @@
-		Master-Timer
-		============
+Master-Timer
+============
+(w) by Matthias Schniedermeyer (ms@citd.de)
 
 
 1. Einleitung
 -------------
 
 Master-Timer ist ein System zum automatischen Aufnehmen von Serien und Filmen.
+Beim Aufruf werden die Konfigurationsdateien gelesen, die Datei "epg.data" im
+aktuellen Verzeichnis nach passenden Sendungen durchsucht und die ermittelten
+Timer per SVDRP in VDR programmiert. Danach beendet sich Master-Timer.
 
-2. Voraussetzungen
-------------------
+Entsprechend empfiehlt es sich, Master-Timer per cronjob aufzurufen.
 
-VDR liefert die "epg.data".
-
-3. Konfigurationsdateien
+2. Konfigurationsdateien
 ------------------------
 
-Alle Konfigurationsdateien liegen unter "<HOME>.master-timer"
-
-config: Eine Ansammlung von Key-Value Paaren. Alle sind "optional" und 
-        erhalten dann die angegebenen Default-Werte
-
-(# = Kommentarzeilen)
-marginstart	(Default 600)
-  Anzahl der "Sicherheits" Sekunden die ein Timer frueher beginnen soll
-
-marginstop	(Default 600)
-  Anzahl der "Sicherheits" Sekunden die ein Timer laenger dauern soll
-
-defaultprio	(Default 50)
-  Die Prioritaet die fuer Timer verwendet wird wo keine Prioritaet 
-  angegeben ist
-
-DVBCards	(Default 1)
-  Anzahl der vorhandenen DVB-Karten (Derzeit nicht verwendet)
-
-Dest-Host 	(Default "localhost")
-  Host-name oder IP des Rechners auf dem VDR laeuft
-
-Dest-Port 	(Default "2001")
-  Port der VDR verwendet
-
-jointimers	(Default 0)
-  Sollen aufeinanderfolgende Timer auf den gleichen Kanal zusammengefasst 
-  werden (0 = "Nein", alles andere "Ja")
-
-debug		(Default 0)
-  Debug-Level, die einzelnen Debug-Werte muessen aus folgenden Werten 
-  zusammengezaehlt werden
-    1     : Dump "torecord"
-    2     : Dump all timers
-    4     : Show when a timer will be deleted
-    8     : Dump the "Done" REs
-    16    : Verbose Config-Reading
-
-deepblack: Eine Liste von Titeln die man NIEMALS NIMMER sehen will
-           Jede Zeile = 1 Titel
-
-subtitle-movies: Eine Liste der "Subtitel" die ein Zeichen fuer einen Film sind
-                 (Soweit die von den Sendern richtig ausgefuellt sind.)
-                 Jede Zeile = 1 Subtitel
-
-torecord: Die Sachen die man Aufnehmen will
-          Jede Zeile = 1 Timer
-# Format: (Every field is "optional".
-# [Title RE|Subtitle RE|Description RE|Channel-Name|Timeframe|Prio|Timer-Title]
-#
-# To record something at least one of the "Title", "Subtitle" or "Description" 
-# Fields has to be provided. This 3 fields are "include" and the rest are 
-# "exclude" fields!
-#
-# More than one channel definition can be provided. The delimiter is ";"
-# Additionaly you can make a "blacklist" of Channels when you prepent a "!" to the first Channel Definition
-# The "!" is only tested for the FIRST Channel definition.
-# You can only have a white or a blacklist (Mixing doesn't make sense!)
-#
-# ex. Record the series "Deep Space Nine" on Sci-Fantasy in the timeframe 09:00 - 14:00
-# Deep Space Nine|||Sci-Fantasy|0900-1400|99|DS9
-#
-# Record all "Actionfilm"s with "Schwarzenegger"
-# |Actionfilm|Schwarzenegger
-#
-
-
-done: 	The titles/subtitles which are already recorded/should not be recorded
-        (Programmed Timers which got inserted into "done" will be deleted 
-         automaticaly)
-
-4. Notices
-----------
-
-- Recordings "overlapping" on the same channel, will be joined into one Timer
-- Title/Subtitle/Descriptions are "fixed" for Channel that don't fill them 
-  out "correctly" (Currently the "Bugs" from Pro-7/VOX/VIVA)
-  Pro7: Remove the Title from the Subtitle  '<Title> / <Subtitle>'
-  VOX/VIVA: Subtitle is enclosed into "" and after ". " is the description
-  VIVA: When the Subtitle beginns with space the subtitle is moved to
-        description
-  All (except the second VIVA one) fixes are tried onto ALL Subtitles.
-
-5. Known-Bugs
--------------
+Alle Konfigurationsdateien liegen unter "~/.master-timer". Es werden
+regulaere Ausdruecke ohne Unterscheidung der Gross-/Kleinschreibung
+benutzt.
+
+config: Die Hauptkonfigurationsdatei.
+
+deepblack: Eine Negativliste von Titeln, die man NIEMALS NIMMER sehen will.
+           Die epg-datensaetze werden beim Parsen einfach entfernt.
+
+subtitle-movies: Eine Liste der "Subtitel", die ein Zeichen fuer einen Film
+  sind (soweit die von den Sendern richtig ausgefuellt sind). Die
+  Einstellungen in dieser Datei werden fuer das Makro "MOVIE" in torecord
+  benutzt.
+  Kommentarzeilen sind nicht erlaubt.
+
+torecord: Liste der aufzunehmenden Filme.
+
+done: Liste der Titel/Subtitel, die bereits aufgenommen wurden. Timer, die
+  hier auftauchen, werden in VDR automatisch geloescht.
+
+channels-to-scan: Diese Kanaele werden vom Skript "scan-channels" durch-
+  geschaltet (zwecks Einlesen der EPG-Daten). Die Datei wird von Master-
+  Timer selbst nicht benutzt.
+
+3. Anmerkungen
+--------------
+
+- einige Sender fuellen die EPG-Felder nicht korrekt aus. Diese Fehler
+  werden von Master-Timer automatisch korrigiert.
+
+  Pro7: Title aus dem Subtitle entfernen '<Title> / <Subtitle>'
+  Pro7: Timer zwischen 00:00 und 05:00 werden einen Tag in die Zukunft
+        verschoben (Als unguten Nebeneffekt hat dies zur Folge das zum
+        aktuellen Tag NICHT die epg-Daten das folgenden Tags (=Das was in
+        der Fernsehzeitschrift noch auf der gleichen Seite ist) mehr gesendet
+        werden. Wenn man also "Last Minute" etwas aufnehmen will, dann muss
+        man (leider) einen Timer "per Hand" in VDR einprogrammieren!)
+  VOX/VIVA: Subtitle ist in "" eingeschlossen nd nach ". " steht die description
+  VIVA: Wenn der Subtitle mit einem Space beginnt, dann wird der komplette
+        Subtitle in die Description verschoben
+  RTL2: Wenn der EPG-Datensatz eine Dauer von kleiner/gleich 1 Sekunde hat, 
+        wird er einfach verworfen.
+
+Bis auf den jeweils 2ten VIVA&Pro-7 Bug werden die Fixes an jedem
+epg-Datensatz ausprobiert.
+
+4. Bekannte Bugs
+----------------
 
-- It isn't checked if there are enough DVB-Cards
-- Overlapping Timers, on the same channel, are always joined
-- JOINed timers which are "done" don't get deleted automaticaly
+- Es wird nicht geprueft ob noch genug DVB-Karten vorhanden sind
+- "Joined timers" werden nur automatisch geloescht wenn alle dazugehoerigen
+  Sendungen "done" sind.