coherence(1) User Commands coherence(1)NAMEcoherence - DLNA/UPnP framework written in Python
SYNOPSIScoherence [--daemon] [--noconfig] [--version] [--configfile file]
[--logfile file] [--plugin value]
DESCRIPTION
Coherence is a DLNA (Digital Living Network Alliance)/UPnP (Universal
Plug and Play) Framework written in Python.
Coherence is divided into three main parts: the core, the virtual
devices, and the device backends. The core of Coherence provides an
implementation of:
· a SSDP (Simple Service Discovery Protocol) server.
· a MSEARCH (command to find other devices connected to the UPnP
network) client to find other devices connected to the network.
· server and client for HTTP/SOAP requests.
· server and client for Event Subscription and Notification.
The virtual devices contain:
· Media Server to provide media content (local storage or online
services) and directory information.
· Media Renderer to play back media content provided by the Media
Server.
· Control Point to interconnect Media Server and Media Renderer.
The virtual device implementation registers with the core, declares
which service interfaces it is using, and attaches callbacks which map
the service actions to its backend. It's generally a translation map
between the core and the device backend.
The device backend is the part to host, render and control the media
files. The following components could act as the device backend: file
systems to store the media files, audio/video hardware and desktop GUI
applications to render the media content and control the playback.
For users, Coherence can be used in conjunction with rhythmbox(1),
totem(1), or elisa(1). When used in this way, these programs become
controllable DLNA/UPnP Media Renderers. Coherence can also be config‐
ured as a DLNA/UPnP Media Server and exports local and remote media
files via its backend to other UPnP clients.
OPTIONS
The following options are supported:
--d, --daemon Daemonize the coherence process.
---noconfig Ignore any configuration file found.
--v, --version Display the current version of coherence.
--c, --configfile=file Specify the location of the configuration file.
The default location is $HOME/.coherence. An
example configuration file can be found at
/var/coherence/coherence.conf
--l, --logfile=file Specify the location of the log file. No log
file will be generated if the option is not
used.
--p, --plugin=plugin Activate plugin. No plugin will be activated by
default.
---help Display program usage.
EXAMPLES
The examples below show how to activate Coherence plugin. Please note
that one plugin contains several keywords: backend/plugin name. Users
can activate plugin by specifying key "backend" to one of the available
backends:
BetterLight, AmpacheStore, FlickrStore, MiroStore, ElisaPlayer,
Gallery2Store, TestStore, DVBDStore, FSStore, BuzztardPlayer, GStream‐
erPlayer, SimpleLight, BuzztardStore, ITVStore, SWR3Store, Tracker‐
Store, LolcatsStore, BBCStore, MediaStore, AppleTrailersStore, LastFM‐
Store, AxisCamStore, ElisaMediaStore, YouTubeStore, PicasaStore, TED‐
Store, IRadioStore
Example 1: Plugin Activation
Activate the FSStore Plugin to export local file system:
example% coherence --plugin=backend:FSStore,name=MediaCenter
Activate the IRadioStore Plugin:
example% coherence --plugin=backend:IRadioStore,name=radio
FILES
~/.coherence Per user configuration file.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWpython24-coherence │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOelisa(1), python(1), rhythmbox(1), totem(1), attributes(5)
For more information about coherence, please refer to http://coher‐
ence.beebits.net/.
If you find any bugs in coherence, please report them to GNOME's
Bugzilla at https://coherence.beebits.net/newticket.
NOTES
Written by Alfred Peng, Sun Microsystems Inc., 2009.
SunOS 5.11 14 Aug 2009 coherence(1)