Manual Pages for UNIX Operating System command usage for man coherence

User Commands                                        coherence(1)



NAME
     coherence - DLNA/UPnP framework written in Python

SYNOPSIS
     coherence [--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 Coher-
     ence provides an implementation of:

       +o  a SSDP (Simple Service Discovery Protocol) server.

       +o  a MSEARCH (command to find other devices  connected  to
          the  UPnP  network)  client  to find other devices con-
          nected to the network.

       +o  server and client for HTTP/SOAP requests.

       +o  server and client for Event Subscription and  Notifica-
          tion.


     The virtual devices contain:

       +o  Media Server to provide media content (local storage or
          online services) and directory information.

       +o  Media Renderer to play back media content  provided  by
          the Media Server.

       +o  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,



SunOS 5.11          Last change: 14 Aug 2009                    1






User Commands                                        coherence(1)



     these programs become controllable DLNA/UPnP  Media  Render-
     ers.  Coherence  can also be configured 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  confi-
                             guration  file. The default location
                             is $HOME/.coherence. An example con-
                             figuration  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,  Elisa-
     Player,   Gallery2Store,   TestStore,   DVBDStore,  FSStore,



SunOS 5.11          Last change: 14 Aug 2009                    2






User Commands                                        coherence(1)



     BuzztardPlayer, GStreamerPlayer, SimpleLight, BuzztardStore,
     ITVStore,  SWR3Store,  TrackerStore, LolcatsStore, BBCStore,
     MediaStore, AppleTrailersStore,  LastFMStore,  AxisCamStore,
     ElisaMediaStore,  YouTubeStore,  PicasaStore, TEDStore, IRa-
     dioStore

     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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpython24-coherence      |
    |_____________________________|_____________________________|
    | Interface stability         | Volatile                    |
    |_____________________________|_____________________________|


SEE ALSO
     elisa(1), python(1), rhythmbox(1), totem(1), attributes(5)

     For  more  information  about  coherence,  please  refer  to
     http://coherence.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          Last change: 14 Aug 2009                    3