This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Frank Bergmann, http://www.tuxad.com/

Project's homepage:          http://downloads.tuxad.de/vdr-rockantenne/

Latest version available at: http://downloads.tuxad.de/vdr-rockantenne/

See the file COPYING for license information.

Description:
This plugin does a short http internet request.
It asks the webserver of Radio Rockantenne for the title
of the currently played song.
If you listen to Rockantenne and wanna know the title and
the interpret of the song you hear just select this plugin
from the vdr main menu.
If you have an internet connection and no error or timeout
occurs the song data will be displayed within 2 seconds.
After a new song starts on Rockantenne the correct song data
will be available after a short delay. It's the same delay
you will have with a web browser showing
   http://www.rockantenne.de
Since version 0.1.0 the rockantenne pugin uses a different
method to get the song data. It uses an alternate server
which delivers song data of the last 4 songs by just
connecting to a tcp port. You can test it in the command
line with the netcat tool: nc 81.89.239.234 4488
Two small programs which you need to run your own rockantenne
song data server are provided in this package (utail and
logrockantennetitel). You also need DJBs daemontools and
ucspi-tcp packages.
Man-pages logrockantennetitel.1, showrockantennetitel.1
and utail.1 are also included.

Hint from vdr-screenshot README by Joachim Wilke:
"To get a screenshot with a single keypress, add a line like this to your
keymacros.conf:
User5    @screenshot
"
==>
User5    @rockantenne

German description:
Dieses Plugin macht eine kurze WWW-Abfrage nach dem momentan
auf Radio Rockantenne gespielten Stueck.
Wenn man Radio Rockantenne hoert und gerne wissen moechte,
welcher Titel gerade gespielt wird, braucht man nur das Plugin
aus dem Hauptmenue auszuwaehlen.
Wenn eine Internet-Verbindung besteht und kein Fehler oder
Timeout auftritt, werden die Daten innerhalb von 2 Sekunden
angezeigt.
Nach Beginn eines neuen Musikstueckes auf Radio Rockantenne
wird der korrekte Titel erst nach einer kurzen Verzoegerung
angezeigt werden. Diese Verzoegerung hat man aber auch, wenn
man sich mit einem normalen Webbrowser
   http://www.rockantenne.de
anzeigen laesst.
Seit Version 0.1.0 wird eine andere Methode zum Holen der
Songdaten verwendet. Es wird ein alternativer Server genutzt,
der die Songdaten der letzten 4 Songs bei einer einfachen
Anfrage an einen TCP-Port ausliefert. Das kann man in der
Kommandozeile mit dem Programm netcat testen:
  nc 81.89.239.234 4488
Zwei kleine Programme die zum Betrieb eines eigenen Servers
genutzt werden koennen, sind in diesem Paket enthalten (utail
und logrockantennetitel). Weiterhin werden dazu noch Daniel
Bernsteins daemontools und ucspi-tcp Pakete benoetigt.
Man-pages logrockantennetitel.1, showrockantennetitel.1
und utail.1 sind auch im Paket enthalten.

Tip aus vdr-screenshot README von Joachim Wilke:
Um das Plugin mit einem Tastendruck aufzurufen, kann man einen Eintrag in
der keymacros.conf wie folgt machen:
User5    @screenshot
==>
User5    @rockantenne
