{{{
#!html
<h1 style="text-align: center; color: blue; font-size:3.0em">MediaServer: AudioCD</h1>
}}}

[[NewsFlash(This backend is highly experimental and is only available so far in the developpement version.)]]

[[TOC(heading= ,inline)]]

[[BR]]
[[BR]]
==  AudioCD Media Server ==

this backend exposes the content of an audio CD, as inserted in a local drive. The server and track names correspond to the actual CD/tracks titles, as retrieved from the CDDB/FreeDB database service.[[BR]]
To be actually usable, Ths backend SHOULD be enabled only after the disc is inserted, and disabled when the disc is ejected.[[BR]]
Integration with a CD insertion/ejection detection software (e.g. HAL) would allow to automatize this process.

=== Additional dependencies ===

 * CDDB.py and DiscID.py (ex: debian package [http://packages.debian.org/stable/python-cddb python-cddb])
 * gstreamer (with base and ugly plugins) and python-gst 

=== UPnP ContentDirectory structure ===

The exposed data is represented in this structure:

 * title for track 1
 * title for track 2
 * ...
 * title for track N

=== Configuration ===

The backend accepts these options:

 '''version:''':: version of the UPnP spec ({{{1}}} or {{{2}}}) (defaults to {{{2}}})
 '''device_name''':: device name for audio CD (defaults to {{{/dev/cdrom}}})


=== Examples ===

Python code:

{{{
#!python
coherence.add_plugin('AudioCDStore', device_name='/dev/cdrom1')
}}}

DBus:

{{{
#!python
coherence_service = dbus.SessionBus().get_object('org.Coherence','/org/Coherence')
coherence_service.add_plugin('AudioCDStore', {'device_name':'/dev/cdrom1'},
                             dbus_interface='org.Coherence',
                             reply_handler=add_plugin_callback,
                             error_handler=error_callback)
}}}

Commandline:

{{{
#!sh
coherence --plugin=backend:AudioCDStore,device_name:/dev/cdrom1
}}}

Integration with [http://cdde.sourceforge.net/ cdde] (CD Detect & Execute utility):[[BR]]
{{{
#!sh
#command
cdde -r

# config file: ~/.cdde.xml
<?xml version="1.0"?>
<cdde delay="5000000">
  <drive path="/dev/cdrom1">
    <audio command="coherence --plugin=backend:AudioCDStore,device_name:%dev%"/>
  </drive>
</cdde>
}}}


=== Open Tickets for this backend ([/newticket?component=MediaServer%20Backend%20AudioCD new...]) ===

[[TicketQuery(component=MediaServer Backend AudioCD&status=new|assigned)]]