Description

XXV means "Xtreme eXtension for VDR" and is a central service is for the administration of the VDR and its environment, with which different of haven are open and these different services can serve.

An additional haven over a Plugin to construct should be just as simple, to make available as also a certain service. The letter of a Plugins goes very fast, there the input (Vdr, Database etc.) as well as the output (telnet, HTTP...) generically was realized. It should be e.g. possible thus to register with a telnet CONSOLE, HttpBrowser, Wapphone, etc. an autotimer. This should substantially faster the EPG data to scan be able (MySQL data base) and over an interface the VDR the new timer communicate. Naturally also is considered to the single mode of the SVdrP and only one instruction is mailed. Afterwards the haven is again closed immediately, so that other programs can access again svdrp.

Long speech short sense, here a small overview of the present functions:

Debian-specifically

apt-get install mysql-server

Perl Module

Now some perl modules follow , there give it like 2 ways:

per cpan

The recommended way, if you don't have a Debian system:
By means of "Bundle::Xxv" via CPAN, simply change into the $SOURCEDIR/lib folder and the Bundle install.
In addition one must UNFORTUNATELY put underneath cpan the module, it can be that with mkdir's the error messages to come the this draw-eats already already existed, which can ignore you confidently. All modules to be needed to stand in this Bundle and are installed automatically:

View recordings with preview images

To view recordings in XXV with preview images, give it to two possibilities, mplayer or vdr2jpeg, which has fewer dependence.
vdr2jpeg need only ffmpeg. By the example of vdr2jpeg the installation is described here. Details for installation are always located in the file README contained in archives.

In the contained Makefile should be adapted still the listing of ffmpeg.
Subsequently, the program can be compiled by means of the Makefile and the following instruction :

make

If lasting compiling no error messages appear, the following instruction is sufficient for installation under /usr/local/bin:

make install

a deviating installation place can be indicated as an additional parameter like make install INSTALLBINDIR=/usr/bin.

Afterwards the preview production with vdr2jpeg must be activated. For that is in the Browser, with adjust configuration point RECORDS / previewbinary,previewcommand. It also possible to edit file xxvd.conf
directly.

Starting of Xxv

So that xxv with each system start as service can be started, to have we an example starting script under 'etc/xxvd' stored, because one in its system to install can. This should be adapted to the own system conditions, on case of each should one the path adapt, at which xxv one installed. (In place of nano can you naturally also another editor use.)

cd $SOURCEDIR/xxv-<VERSION>
nano etc/xxvd

Under FOLDERS, into which first lines register simply that defined $SOURCEDIR.

So that XXV with each boats of the computer after vdr one starts. It is necessary the current to determine run level. And in the appropriate starting listing To put on run level /etc/rc<RUNLEVEL>.d a symbolic left on the initialization program of the xxvd service /etc/init.d/xxvd. Here by the example run level 2:

Folder for ttf character sets for the overlay functions of the remote screen display

--vtxdir=DIR

./share/vtx

Folder with the graphic font of the symbols for the teletext plugin

--contrib=DIR

./contrib

Folder with additional script files

Manual starting of xxv

xxvd can be started also manually without activation as service, in addition serves the following command combination, which indicates the log file after the start also /var/log/xxvd.log. The announcement of the log file is broken off with keystroke Strg-C.

Handle with xxv

The operation of XXV takes place on a Browser. In addition the URL must on your XXV installation refers to be entered in the address line. This takes place according to the pattern protocol://network address:port
The port number for the Web entrance is the 8080. This can be adapted by configuration parameters in xxvd.cfg. Here by the example of the IP address 192.168.0.100.

Required with a new installation will for the entrance the following logon data, these attitudes should after the installation the personal preferences be naturally adapted. Over these attitudes it is also possible the user inquiry switches off or to certain Network clients to limit.

User: xxv
Password: xxv

Plugins

General

General actually is no Plugin. Since it looks in such a way from view of xxv, it should be listed for the sake of the completeness here.
Here global attitudes are listed such as log file path, data base server etc..

Inactive timer now deleted if these more than one month in the future to lie. It seemed repeatedly, which a timer was programmed by autotimers, to this because of lack of interest was deactivated. If the timer had run off, it emerged automatically exactly one month later again in the list. These "timer corpses" had to be deleted then always laboriously by hand. Happened now automatically if TIMER - configuration - the Deactive is set on 'yes'.

EPG

Here those becomes epg.data read in and their entries in a database stored.

Music

WebInterface: Many user more than 1000 MP3 titles on their had vdr rumlungern, thus thereby Javascript the concept absolutely not thereby clearly came. The new interface is now pure HTML and fortunately also substantially faster in the side structure.

GetCovers: This function is a bonus with xxv by means of module the Robot once on the day the Covers of the albums as image files from the InterNet to download can. For it the Perl module WWW::Mechanize which must be installed additionally, is used. This module emulates the normal operation in a Browser, with which a search word (album name, feature year) on the search side of a music portal is entered and suppl.-smooth-eat then scanned for the wished Albumcover. And this Coverbild is then stored in the preview listing and indicated in the album list.

Records

This Plugin represents all recordings clearly and permits different actions on the individual records.

Many characteristics of the record are now capable for editing. (Marks, Lifetime, Priority,...)

Andreas took care of the leidigen and substantially unperformanten way of the Preview picture production and a very slim C program named 'vdr2jpeg' wrote. This program does nothing different one than Preview of pictures in the reason with certain marks to provide. This we naturally also supported of xxv and can by "svn co http://bandt.dyndns.org/repos/vdr2jpeg" are gotten. Closer data for installation can reread you in the README file of the program complex.

Series, or recordings into a group file are summarized, in rlist as files are indicated.

Config

Configuration the Plugin makes it possible to change and store at run time different parameters of the interface (HTTP, telnet,..).

Status

A particularly nice feature, it now graphs provided which the memory extent of utilization as well as the load of a certain period (configuration - status - history) to represent. The special to it, which become diagrams from the Templates provided, thus each bent ski programmer its own diagrams if necessary to provide can. In the HTML Skin one can see that very beautiful under status.

SVDRP

This Plugin makes all instructions available svdrp of the interface of the VDR.

User

User authentication, which queries users in all interfaces identification and password and makes a level administration available.

Effectively come at xxvd three different account levels to carry :

The normal level of the operating system (Linux)

In this account xxvd executed. The account becomes in the variable RUNAS in /etc/init.d/xxvd defined.
So that xxvd within unprivileged accounts can be executed, this account needs reader-genuine in xxv-folder, and write rights to the cfg file, pid file, log files and write rights in the preview folder of the Skins.

The Mysql Account

This entrance we only needs around the data in mySQL the data base to respond, therefore it needs reading and write rights within the active xxv-data base (mySQL:DATABASE)
(GARANT SELECT, INSERT, UPDATE, CREATE, DROP, usw.)

And then there is the xxv-account within XXV the user administration.

It serves only for it individual xxv-commands to de-energise or close.
Momentarily this is possible only in the three groups guest, user, admin.

guest, may data such as EPG data or Recordings regard

user, such as autotimers, timer may change data

admin, user may administer

The standard entrance after new installation has the following Login and should over the xxv-user administration when de-energising in InterNet be deleted or changed.

Login:xxv
Passwort: xxv

If XXV only in the local area network one uses, the xxv-user administration can be switched off also completely in the preferences.

Certain parameters can be stopped now with the user. We use a generic system, if for example the user liked to see xpix only the Skin Snow can one in the user attitudes under 'Prefs' with 'HTTPD::HtmlRoot=snow' adjust very beautifully. Naturally one can assign also all other parameters of the modules to the user, e.g. we would like additional, which the user xpix only timer may define, whose priority is only with 30. That would look in such a way then:

HTTPD::HtmlRoot=snow, TIMERS::Priority=30

The syntax reads thus 'Modulname::Parameter=Value, Modulname::Parameter=Value...'... if the user xpix also only as Level=User is adjusted, can one thus prevent the this its attitudes changes.

The user can make also a Logout now.

Vtx

Skins install

The Web interface can diplay with a completely different appearance. The necessary skin package will unpack generally in the installation folder. But this skins folder can also move to a other folder by command line parameters, like --htmldir /var/lib/xxv/skins/.

Here by the example of the Skins stone.

cd /var/lib/xxv/skins/
tar zxvf xxv-stone-0.60.tgz

With unpacking, you should get a new folder, with name from Skin. this folder contains data of the skin.

Subsequently, one calls the Web interface (http://ip_deines_vdrs:8080) and selects the Skin under Preferences -> HTTPD -> Option HtmlRoot.
But do not forget to activate the changed preferences with Apply.

It can be necessary to execute a complete reloading of the xxv-web page, so that buffered files by the Browser to update.

XXV keep current

We go of it out of which you xxv with you had already installed and to point you as you to a new version to be updated can. As the first we must stop the service:

vdr:~# /etc/init.d/xxvd stop

... with Subversion

Most simply an update with subversion is to be made, the update script and start again afterwards xxv call:

cd $SOURCEDIR
svn update

... as Download

Naturally it will give also further the possibility of getting themselves from the existing download server current packages and of unpacking these then. But, these packages are made available only in irregular distances. Are thus not always current:

cd $SOURCEDIR
tar xvzf xxv-<VERSION>.tar.gz

Database structure adapt

New or extended xxv-functions involve often also a change of the data base structure. After the installation of an update, should you therefore first always the script contrib/update xxv call. XXV may be started at this time not yet.

In the simplest case must transfer no parameters to her to the script. This presupposes however that MySQL on the local computer is installed that the data base is called 'xxv' and the database administrator 'root' does not possess a password.

cd $SOURCEDIR/contrib
./update-xxv

Beyond that can to the script a set of parameters hand over, which also steer a few extended functions apart from the access to the data base you. An overview of all parameters receive you with:

With the parameter -b is accomplished before the update a Backup of the data base. In addition the name of the backupfile (without the ending gz) must be indicated. The parameters -H (hostname) and -P (haven) steer the access to the MySQL server. This ' localhost' and haven are according to standard 3306. If the database should not be called 'xxv', then can you with -D another name select.

The data base user can specify you with -u and its password with -p. In order to be able to accomplish the update, the data base user needs FILE of rights. Usually only the administrator 'root' is this right.

safety reference:

With the delivery of the password in the command line parameters the password becomes visible for one moment for all other user of the local system ('ps -fA' indicates all processes with their parameters!). Alternatively have you therefore the possibility, by means of -A the update script for the password ask of letting. However the password is several times queried, since different data base operations are necessary.

Database updates are accomplished by update xxv only if you are really necessary. Should times somewhat inclined run or if you would like on an old data base structure ' down degrees ', then can you the update with -f force.

With a successful data base update a list of the accomplished actions spends update xxv:

In the event of an error "error:..." messages spent. The most probable cause for an error is the data base access. You should examine first thus username, password, data base name and host.

After the update can you XXV again start:

/etc/init.d/xxvd start

Subsequently, control the log file:

tail -f /var/log/xxvd.log

If any error messages should emerge because of missing Perl modules in the log file, then should install these for her. Who does not go to no more white as,
this Wiki will be help you ...

Problems

Does XXV have a memory leak? Memory consumption approx. doubles in 6 hours.

Unfortunately the EventModul had a memory leakage, which with the version >= 1.05 has been fixed. Please install your Eventmodul again:

perl -MCPAN -e shell;
install Event

I use vdr 1.3.26 - 27 and xxv V0.42. I can see no more recordings in the interface

In these versions Klaus had something at the SVDRP interface screwed, thus XXV nothing more thereby to begin could. Either you update your XXV by subversion or you use a Patch which we on the following URL published:

Afterwards you should be able yourself to log in with xxv:xxv normally.

No Preview image is provided:

The following check list should help you:

* the path is correct to mplayer in the RECORDS Config
* is mplayer switched on under Records->config->mplayercommand?
* correct version under Records->config->mplayercommand?
* the path is correct to the video folder?
* the preview folder is writable for xxvd?

Consider also, the preview pictures in the background are generated. That means only after a small while is the first Previews to see (approx. 2min).

No Previewimages is provided and in xxvd_mplayer.log stands:

Unknown option on the command line: jpeg

Starting from mplayer-1.0pre6 the calling command line must be adapted, xxv make this for you.
(Configuration -> RECORDS -> mplayercommand).
Adjust simply the appropriate Player, which is installed on your system. MPlayer1.0pre5 and older as well as MPlayer1.0pre6 and more again. You get the version number of yours mplayers with mplayer v to see:

A cause is, which bring along xxvd appropriate located texts, but on the computer no system localization of the same name is present. Suppressing this message goes with "export PERL_BADLANG=1", but more meaningfully it is to be likewise installed the system localization in the selected language.

Special problems with installation of the packages of the c't edition

In the log file is error that the file was not found ' ' docu.tmpl .

A start from xxv is via

xxvd -configfile=/var/lib/vdr-xxv/xxvd.cfg

possible, PID is assigned, but the Web interface (bspw.) is not attainable. The start also /etc/init.d/vdr-xxv start does not produce output for expenditure: