Overview¶

Cohen is a DLNA/UPnP Media Server written in Python, providing several UPnP MediaServers and MediaRenderers to make simple publishing and streaming different types of media content to your network.

Cohen is actually a highly simplified and refreshed version of Coherence Framework project by Frank Scholz which looks like no longer supported.

Latest release: 0.7.3 (Changelog)
GitHub: https://github.com/unintended/Cohen
Issue tracker: https://github.com/unintended/Cohen/issues
PyPI: https://pypi.python.org/pypi/cohen
Free software: MIT licence

Features¶

Cohen is known to work with various clients

Sony Playstation 3/4
XBox360/One
Denon AV Receivers
WD HD Live MediaPlayers
Samsung TVs
Sony Bravia TVs

And provides a lot of backends to fulfil your media streaming needs

Local file storage
YouTube
Twitch.tv
and much more...

Quickstart¶

To just export some files on your hard-disk fire up Cohen with an UPnP MediaServer with a file-system backend enabled:

$ cohen --plugin=backend:FSStore,content:/path/to/your/media/files

You can also configure cohen via a config file. Feel free to check our example misc/cohen.conf.example. The config file can be placed anywhere, cohen looks by default for $HOME/.cohen, but you can pass the path via the commandline option ‘-c’ to it too:

$ cohen -c /path/to/config/file

Table of Contents¶

Installation¶

Source code¶

If a package is not available for your platform (or it’s out of date) you can install Livestreamer via source.

There are a few different methods to do this, pip the Python package manager, easy_install the older package manager included with `python-setuptools`_ or by checking out the latest code with Git.

Dependencies¶

Starting as Service¶

Command-Line Interface¶

SYNOPSIS¶

cohen <options> [–plugin=<BACKEND> [ , <PARAM_NAME> : <PARAM_VALUE> ] ...]

DESCRIPTION¶

Cohen is a Python DLNA/UPnP Media Server made to broadcast digital media content over your network.

The core of Cohen provides a (hopefully complete) implementation of:

a SSDP server,

a MSEARCH client,

server and client for HTTP/SOAP requests, and

server and client for Event Subscription and Notification (GENA).

OPTIONS¶

`-v, --version`	Show program’s version number and exit
`--help`	Show help message and exit
`-d, --daemon`	Daemonize
`-c, --configfile=PATH`
	Path to config file
`--noconfig`	ignore any config file found
`-o, --option=OPTION`
	activate option
`-l, --logfile=PATH`
	Path to log file.

EXAMPLES¶

cohen –plugin=backend:FSStore,name:MyCoherence:
	Start cohen activating the FSStore backend.
cohen –plugin=backend:MediaStore,medialocation:$HOME/Music/,mediadb:/tmp/media.db:
	Start cohen activating the MediaStore backend with media located in $HOME/Music and the media metadata store in /tmp/media.db.

AVAILABLE STORES¶

BetterLight, AmpacheStore, FlickrStore, MiroStore, ElisaPlayer, ElisaMediaStore, Gallery2Store, DVBDStore, FSStore, BuzztardPlayer, BuzztardStore, GStreamerPlayer, SimpleLight, ITVStore, SWR3Store, TrackerStore, LolcatsStore, BBCStore, MediaStore, AppleTrailerStore, LastFMStore, AxisCamStore, YouTubeStore, TEDStore, IRadioStore, TwitchStore

FILES¶

$HOME/.cohen:	default config file

ENVIRONMENT VARIABLES¶

COHEN_DEBUG=<STORE>:
	Supplies debug information pertaining to the named store.