Coherence - a DLNA/UPnP Framework for the Digital Living

迈不过友情╰ 2022-09-17 10:27 192阅读 0赞

The

The Coherence toolkit offers the following **multi-media related components**:

*  **[DLNA/UPnP Media Server][DLNA_UPnP Media Server]** (Coherence), which exports local files or online media to [ UPnP clients][UPnP clients]. There are many [ backends][DLNA_UPnP Media Server] to fetch media from:
    
     *  local applications media collections like those from [ Rythmbox][Rythmbox] or Banschee,
     *  Audio-CD or DVB,
     *  online services like Flickr, last.fm, [ YouTube][YouTube], Picasa Web Albums and other.

> Due to the comprehensive plug-in architecture, these can easily be expanded.

> Coherence also contains an audio/video [ DLNA/UPnP MediaRenderer][DLNA_UPnP MediaRenderer] application, based on the GStreamer framework. It includes the source-code framework used by the other components. The media server supports [ Transcoding][Transcoding] (experimental).

*  **Coherence-Config** is a cross-platform GUI frontend for 'Coherence'.
 *  An image **[DLNA/UPnP MediaRenderer][DLNA_UPnP MediaRenderer]** ([Cadre][]), which can display pictures from the local filesystem or from a [ MediaServer][DLNA_UPnP Media Server].
 *  An **application level proxy for UPnP devices** ([Mirabeau][]) which allows to share your UPnP content between two or more local networks over the Internet. It uses XMPP as a transport (work in progress).
 *  [The UPnP-Inspector][] is a graphical UPnP Device and Service analyzer, and a debugging tool. Detected devices are displayed in a tree-view, where - amongst other things - actions can be called and state-variables be queried. It can also be used as a UPnP [ ControlPoint][ControlPoint].
 *  Plugins or extensions for other applications to open them to the UPnP world, thanks to the framework (either as [ MediaServers][MediaServers], [ ControlPoints][ControlPoints] or [ MediaRenderers][MediaRenderers]). This includes [ Totem][Totem], [ Nautilus][Nautilus], [ Eye Of Gnome][Eye Of Gnome], [ Rythmbox][Rythmbox], [ Banshee][Banshee], Elisa, amarok...

If you are new to DLNA/UPnP you may want to read the [ Short Introduction to DLNA?][Short Introduction to DLNA].

Additionally there is a command-line tool to work with **UPnP Internet Gateway Devices** ([Puncher][]). Many routers offer an UPnP [ InternetGatewayDevice][InternetGatewayDevice] to query informations about the WAN connection, the link status, external IP address and to enable port-mappings that allow inbound connections to the local LAN. Puncher allows you interacting with these devices.

The toolkit is known to work on various Linux flavors, BSD, (Open)Solaris and Windows. It can be installed either as a standard python source-code download or through various OS-specific packages.

### For Application Developers ###

Developers get a framework written in [ Python][Python] with an emerging DBus API. This framework is designed to automate all UPnP-related tasks as much as possible and enable applications to participate in digital living networks, primarily the [UPnP][] universe.

The core framework of Coherence provides:

*  an [ SSDP][SSDP] server
 *  an MSEARCH client
 *  server and client for HTTP/SOAP requests
 *  server and client for Event Subscription and Notification ([GENA][])
 *  A device implementation dock

UPnP device implementations are pluggable. For instance, we can pick the [ MediaServer][DLNA_UPnP Media Server] device and plug it into the core. Or attach the [ MediaRenderer][DLNA_UPnP MediaRenderer] device. Or attach both, or two [ MediaServers][MediaServers] and a [ ControlPoint][ControlPoint] \- this is the point where one of Coherence's particular features kicks in.

This probably makes more sense if we look at how UPnP devices are implemented within Coherence. On one side of the device we have the connectors to the core, but on the other side there is a dock for a backend to be plugged in. So a device implementation is generally a simple translation map between the the core and its backend.

As an example, a [ MediaServer][DLNA_UPnP Media Server] connects to the core via the [ ContentDirectory][ContentDirectory] and [ ConnectionManager][ConnectionManager] services and bridges them to a filesystem backend. Or bridges them - let's say - to a less skimpy one, the [ MediaStore?][MediaStore] of a [ MediaCenter][MediaCenter] exposing its content in a way already presorted by album, artist, genre,...etc.

More information is available in the [ Architectural Overview][Architectural Overview].

## Current State ##

At the moment Coherence is primarily focused on the [ UPnP A/V][UPnP A_V] devices but any other UPnP device can be addressed, too. Such as a [ Lighting Controls][Lighting Controls] bridge to [ EIB][EIB] home-automation.

The core itself is fairly complete and can be used on its own for debugging purposes.

The media server includes an early implementation of [ transcoding][Transcoding] support.

## Supported Devices ##

Here is a [ list of devices][UPnP clients] which have been reported to work with Coherence. Please keep us informed about your devices.

## Download ##

*  **Binary packages** are available for various environments: they are listed on the [ packages page][packages page]
 *  Alternatively, there is an entry in the **[Python Package Index][]** enabling you to install and upgrade with [ easy\_install][easy_install]: easy\_install Coherence
 *  The **source tarball** for the current stable version is available [ here][here]
 *  Source checkouts via **[Git][]** are possible too:
    
     *  current stable release: git clone -b master https://github.com/coherence-project/Coherence.git Coherence-stable
     *  current development head: git clone -b master https://github.com/coherence-project/Coherence.git Coherence

> > Any contribution (esp. pull-requests) is welcome.

## Documentation & Hacking ##

For information about installation and using Coherence with(in) your application and writing backends and plugins, please visit the [ DocumentationDepartment][DocumentationDepartment] and the slowly growing list of [ SupportedDevices][UPnP clients].

For developing Coherence and the related projects we strongly suggest checking out the [ Development repository][Development repository]. It holds tools, tips and tricks, esp. scripts for setting up the development-environment.

There are also [ some posts about Coherence][some posts about Coherence] in my blog, these will sooner or later get incorporated into this site.

## Contact and Discussion ##

*  Please add your **bug-reports**, **suggestions**,  **patches** or comments as [ tickets][tickets] to this trac instance
 *  You may also add your **feature requests** [ here][here 1]
 *  You need to [register][] first, to reduce spam.
 *  Developers and users usually hang around on **IRC**: irc://irc.freenode.net/\#coherence or irc://irc.freenode.net/\#moovida
 *  There are two **mailing-list** for Coherence:
    
     *  [coherence-announce][]: only announces about updates and new releases, read-only ([Archive][])
     *  [coherence-dev][]: discussions, questions,... about development and usage issues ([Archive][Archive 1]). For searching the history of the coherence-dev mailing list you can use [ Nabble][Nabble].

Frank Scholz, the lead developer of Coherence, can be reached at [ dev@coherence-project.org][dev_coherence-project.org].

## History ##

Coherence has its roots in the work of

*  [Tim Potter][] who started everything and set the code lose
 *  [John-Mark Gurney][] who continued it with the [ MediaServer][DLNA_UPnP Media Server] [ PyMeds][PyMeds]
 *  and [ Fluendo][Fluendo] who added a first [ ContentDirectory][ContentDirectory] client for [ Elisa][Elisa]

## License ##

Coherence is licensed under the [ MIT license][MIT license].

## Dependencies ##

*  Coherence in written in [ Python][Python], and currently tested against version 2.4, 2.5 and 2.6
 *  depends on [ setuptools][easy_install] for the installation process and plugin management
 *  profits from the excellent event-driven networking framework [ Twisted][Twisted]
 *  needs [ ElementTree][ElementTree] for its XML processing (included in Python 2.5)
 *  uses [ Louie][Louie] for signal dispatching (included in Coherence >= 0.5.8)

### Optional Components ###

*  [ConfigObj][] (optional since Coherence >=0.5, due to the [ new XML configuration file format][new XML configuration file format])
 *  [Divmods Nevow][] (optional, for all the WebUI html, together with [ Athena][Athena] for the AJAX bells and whistles)
 *  [ctypes][] (optional, included in Python 2.5 for the [ MediaServer][DLNA_UPnP Media Server] file system backend)
 *  [GStreamer][] (optional, for the [ MediaRenderer][DLNA_UPnP MediaRenderer] backend)
 *  [netifaces][] (optional, to handle on Windows OS the detection of the own IP)
 *  [Mechanize][] (optional, for the account authentication in the [Flickr MediaServer][] backend)
 *  [Google Data APIs Python Client Library][] (optional, for the [ YouTube MediaServer][YouTube] backend)

## Variety ##

There are other projects that are similar to Coherence or provide related functions, such as a dedicated UPnP [ MediaServer][DLNA_UPnP Media Server] implementation. They are listed on the [ Resources][Resources] page.

## Publicity ##

*  [Coherence on Github][]

toolkit offers the following **multi-media related components**:

> Due to the comprehensive plug-in architecture, these can easily be expanded.

If you are new to DLNA/UPnP you may want to read the [ Short Introduction to DLNA?][Short Introduction to DLNA].

The toolkit is known to work on various Linux flavors, BSD, (Open)Solaris and Windows. It can be installed either as a standard python source-code download or through various OS-specific packages.

### For Application Developers ###

The core framework of Coherence provides:

*  an [ SSDP][SSDP] server
 *  an MSEARCH client
 *  server and client for HTTP/SOAP requests
 *  server and client for Event Subscription and Notification ([GENA][])
 *  A device implementation dock

More information is available in the [ Architectural Overview][Architectural Overview].

## Current State ##

The core itself is fairly complete and can be used on its own for debugging purposes.

The media server includes an early implementation of [ transcoding][Transcoding] support.

## Supported Devices ##

Here is a [ list of devices][UPnP clients] which have been reported to work with Coherence. Please keep us informed about your devices.

## Download ##

> > Any contribution (esp. pull-requests) is welcome.

## Documentation & Hacking ##

There are also [ some posts about Coherence][some posts about Coherence] in my blog, these will sooner or later get incorporated into this site.

## Contact and Discussion ##

Frank Scholz, the lead developer of Coherence, can be reached at [ dev@coherence-project.org][dev_coherence-project.org].

## History ##

Coherence has its roots in the work of

## License ##

Coherence is licensed under the [ MIT license][MIT license].

## Dependencies ##

### Optional Components ###

## Variety ##

## Publicity ##

*  [Coherence on Github][]

[DLNA_UPnP Media Server]: http://coherence.beebits.net/wiki/MediaServer
[UPnP clients]: http://coherence.beebits.net/wiki/SupportedDevices
[Rythmbox]: http://coherence.beebits.net/wiki/RhythmBox
[YouTube]: http://coherence.beebits.net/wiki/YouTube
[DLNA_UPnP MediaRenderer]: http://coherence.beebits.net/wiki/MediaRenderer
[Transcoding]: http://coherence.beebits.net/wiki/TransCoding
[Cadre]: http://coherence.beebits.net/wiki/Cadre
[Mirabeau]: http://coherence.beebits.net/wiki/Mirabeau
[The UPnP-Inspector]: http://coherence.beebits.net/wiki/UPnP-Inspector
[ControlPoint]: http://coherence.beebits.net/wiki/ControlPoint
[MediaServers]: http://coherence.beebits.net/wiki/MediaServers
[ControlPoints]: http://coherence.beebits.net/wiki/ControlPoints
[MediaRenderers]: http://coherence.beebits.net/wiki/MediaRenderers
[Totem]: http://coherence.beebits.net/wiki/Totem
[Nautilus]: http://coherence.beebits.net/wiki/Nautilus
[Eye Of Gnome]: http://coherence.beebits.net/wiki/EyeofGnome
[Banshee]: http://coherence.beebits.net/wiki/Banshee
[Short Introduction to DLNA]: http://coherence.beebits.net/wiki/ShortIntroductionToDLNA
[Puncher]: http://coherence.beebits.net/wiki/Puncher
[InternetGatewayDevice]: http://coherence.beebits.net/wiki/InternetGatewayDevice
[Python]: http://python.org
[UPnP]: http://upnp.org/
[SSDP]: http://coherence.beebits.net/chrome/site/draft-cai-ssdp-v1-03.txt
[GENA]: http://coherence.beebits.net/chrome/site/draft-cohen-gena-client-00.txt
[ContentDirectory]: http://coherence.beebits.net/wiki/ContentDirectory
[ConnectionManager]: http://coherence.beebits.net/wiki/ConnectionManager
[MediaStore]: http://coherence.beebits.net/wiki/MediaStore
[MediaCenter]: http://en.wikipedia.org/wiki/Media_center
[Architectural Overview]: http://coherence.beebits.net/wiki/ArchitecturalOverview
[UPnP A_V]: http://upnp.org/specs/av/default.asp
[Lighting Controls]: http://upnp.org/standardizeddcps/lighting.asp
[EIB]: http://www.konnex.org/
[packages page]: http://coherence.beebits.net/wiki/Packages
[Python Package Index]: http://www.python.org/pypi
[easy_install]: http://peak.telecommunity.com/DevCenter/setuptools
[here]: http://coherence.beebits.net/download/Coherence-0.6.6.2.tar.gz
[Git]: http://www.git-cm.org
[DocumentationDepartment]: http://coherence.beebits.net/wiki/DocumentationDepartment
[Development repository]: https://github.com/coherence-project/Development
[some posts about Coherence]: http://netzflocken.de/categories/coherence
[tickets]: http://coherence.beebits.net/newticket
[here 1]: http://coherence.beebits.net/wiki/FeatureRequests
[register]: http://coherence.beebits.net/register
[coherence-announce]: http://lists.beebits.net/cgi-bin/mailman/listinfo/coherence-announce
[Archive]: http://lists.beebits.net/pipermail/coherence-announce/
[coherence-dev]: http://lists.beebits.net/cgi-bin/mailman/listinfo/coherence-dev
[Archive 1]: http://lists.beebits.net/pipermail/coherence-dev/
[Nabble]: http://coherence-dev.2517470.n2.nabble.com/
[dev_coherence-project.org]: mailto:dev@coherence-project.org
[Tim Potter]: http://frungy.org/%7Etpot/
[John-Mark Gurney]: http://resnet.uoregon.edu/%7Egurney_j/
[PyMeds]: http://resnet.uoregon.edu/%7Egurney_j/jmpc/pymeds.html
[Fluendo]: http://www.fluendo.com/Fluendo
[Elisa]: https://core.fluendo.com/elisa/trac/wiki
[MIT license]: http://www.opensource.org/licenses/mit-license.php
[Twisted]: http://twistedmatrix.com
[ElementTree]: http://effbot.org/zone/element-index.htm
[Louie]: http://pylouie.org/index.html
[ConfigObj]: http://www.voidspace.org.uk/python/configobj.html
[new XML configuration file format]: http://coherence.beebits.net/wiki/XMLConfig
[Divmods Nevow]: http://divmod.org/trac/wiki/DivmodNevow
[Athena]: http://divmod.org/trac/wiki/DivmodNevow/Athena
[ctypes]: http://python.net/crew/theller/ctypes
[GStreamer]: http://gstreamer.org
[netifaces]: http://alastairs-place.net/netifaces
[Mechanize]: http://wwwsearch.sourceforge.net/mechanize/
[Flickr MediaServer]: http://coherence.beebits.net/wiki/FlickR
[Google Data APIs Python Client Library]: http://code.google.com/p/gdata-python-client/
[Resources]: http://coherence.beebits.net/wiki/Resources
[Coherence on Github]: https://github.com/coherence-project/