[[PageOutline(2-5,Contents,pullout)]]

= trac-dvbcronrecording-plugin =

== Description ==

This Trac-Plugin maintains a database of recordings.
Upon "Activate!" it creates a recording script. 
The actual recording is performed by a tuning the
LinuxDVB device started by a Crontab call.



== Bugs/Feature Requests == 

Existing bugs and feature requests for DvbCronRecordingPlugin are 
[https://bitbucket.org/guidod/trac-dvbcronrecording-plugin/issues?status=new&status=open here].

If you have any issues, create a 
[https://bitbucket.org/guidod/trac-dvbcronrecording-plugin/issues new ticket].

== Download ==

Currently the most current [https://bitbucket.org/guidod/trac-dvbcronrecording-plugin/downloads source snapshot] can be downloaded or you use the buildserver files at 
[https://build.opensuse.org/package/files?package=trac-dvbcronrecording-plugin&project=home%3Aguidod%3Atools%3Ascm home:guidod:tools:scm/trac-dvbcronrecording-plugin]

== Source ==

You can check out DvbCronRecordingPlugin from [https://bitbucket.org/guidod/trac-dvbcronrecording-plugin  here] using Subversion, or [https://bitbucket.org/guidod/trac-dvbcronrecording-plugin/src browse the source] with your browser.


== Installation ==

You can get a complete set of RPMs at the buildserver site including the trac modules. The tarball itself
can be compiled into an rpm based on "rpm -ta $filename". If you do prefer to use distutils / setup.py then
you can unpack the source tarball and run "setup.py install". For proper usage you do also need "gnutv" and "szap" from the dvb tools, please consult
[http://www.linuxtv.org/wiki/index.php/LinuxTV_dvb-apps LinuxTV.org LinuxTV_dvb-apps]

See https://bitbucket.org/guidod/trac-dvbcronrecording-plugin/wiki/Home for further documentation.

== Usage ==
Remember that you need to press "Activate" to generate the crontab entries. The default assumes that it
should not write the /etc/cron.d/* files directly (you need to copy the dvbcronrecording-update-change.cron
to /etc/cron.d/dvbcronrecording-update-change.cron once to allow it work) but you can also use a config
item in the admin panel to select that it should be written directly.

Note that the system grew out of some local command-line scripts that would convert a list of recording times, 
channel info and program title into a matching recording script along with a Crontab entry. Transforming it into 
a Trac-Plugin allows for easier installation on a remote recorder box as well as sharing the recorder by multiple 
persons with just a web access to the recorder box. 

== Trac Technology ==
 * The plugin uses [http://www.sqlalchemy.org SqlAlchemy] for the declaration of database-tables - see [trac:wiki:SqlAlchemy Trac SqlAlchemy]
 * The plugin uses the TracSqlAlchemyBridgeIntegration (as local "tsab") for trac-specific DB-upgrades and DB-access.
 * The DB-version upgrades/downgrades are performed by using the
   [http://sqlalchemy-migrate.googlecode.com/hg/migrate/versioning/schemadiff.py sqlalchemy-migrate schemadiff.py]
   for schema change detection and a homegrown schemachange.py script to do the actual sql upgrade/downgrade operations
   via the tsab.
 * The plugin i18n is based on gnugettext but with a direct loading of the *.po files.

== News ==
 * 0.4.16 has functional autoplanning for two satellite feeds (usually Astra and Hotbird in Germany) and the update for
   latest SqlAlchemy required a new tsab2 implementation. The i18n was switched to a single global *.po file.

== Recent Changes ==

[[ChangeLog(dvbcronrecordingplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:guidod] [[BR]]
'''Maintainer:''' [wiki:guidod] [[BR]]
'''Contributors:'''