Backends

  1. Backends
    1. Ampache
    2. Apple Trailers
    3. Axis Cam
    4. BBC
    5. DVBD
    6. Elisa Media Player
    7. Flickr
    8. File System
    9. Gallery2
    10. iRadio
    11. Last.FM
    12. Lolcats
    13. Media Database
    14. Picasa Web Albums
    15. Playlist
    16. SWR3
    17. Ted
    18. Tracker



Note: These sample configs are depreciated albeit still work. It is prefered to use the new xml-style config. Please see XMLConfig for more information. The info on this page will soon be updated or merged.



Backends

Here will be a list of all available backends, their capabilities, dependencies and configuration options. All the configuration examples should be added to the configuration file in the plugins section, i.e. they should follow:

[plugins]

Ampache

    [[AmpacheStore]]
        name = Coherence - Ampache                            # default: Ampache
        #key = key                                            # default: <empty>
        #user = user                                          # default: None
        url = http://localhost/ampache/server/xml.server.php  # default: http://localhost/ampache/server/xml.server.php
        proxy = no                                            # default: no (one of: 1,Yes,yes,True,true)
        api_version = 350001                                  # default: 350001
        refresh = 2                                           # default: 1 (hours)
        #urlbase = /                                          # default: / (not sure what this does)

Apple Trailers

Serving Apple film trailers from the Apple website.

    [[AppleTrailersStore]]
        name = Coherence - Apple Trailers  # default: Apple Trailers
        refresh = 4                        # default: 8 (hours)
        #urlbase = /                       # default: / (not sure what this does)

Axis Cam

    [[AxisCamStore]]
        name = Coherence - AxisCamStore  # default: AxisCamStore
        #urlbase = /                     # default: / (not sure what this does)

BBC

    [[BBCStore]]
        name = Coherence - BBC  # default: BBC
        refresh = 2             # default: 1 (hours)
        #urlbase = /            # default: / (not sure what this does)

DVBD

    [[DVBDStore]]
        name = Coherence - TV  # default: TV
        enable_destroy = no    # default: no
        #urlbase = /           # default: / (not sure what this does)

Elisa Media Player

    [[ElisaMediaStore]]
        name = Coherence - Elisa  # default: Elisa
        host = 127.0.0.1          # default: 127.0.0.1
        #urlbase = /              # default: / (not sure what this does)
        #ignore_patterns = []     # default: [] (unused)

Flickr

This is a backend to flickr. It will retrieve the most recent pictures and the most wanted pictures.

    [[FlickrStore]]
        name = Coherence UPNP Flickr Images  # default: Flickr
        proxy = false                        # default: false (one of: Yes,yes,True,true to have coherence fetch the images
        refresh = 30                         # default: 60 (minutes)
        limit = 25                           # number of files fetched; default: 100
        flickr_userid = username             # flickr username; default: None
        flickr_password = password           # flickr password; default: None
        flickr_permissions = permissions     # flickr permissions, may need this 'read'; default: None
        flickr_authkey = authkey             # flickr auth key for access; default: None
        #ignore_patterns = []                # default: [] (not sure how to use this)
        #urlbase = /                         # default: / (not sure what this does)

File System

Simply serves all media files from a directory and its subdirectories.

    [[FSStore]]
        name = Coherence - Filesystem Store  # default: my media
        content = /path/to/media             # default: None
        #ignore_patterns = []                # default: [] (not sure how to use this)
        #urlbase = /                         # default: / (not sure what this does)
        enable_destroy = no                  # default: no
        #import_folder = /path/to/import     # default: None
        #create_root = /path/to/root         # default: None

Gallery2

    [[Gallery2Store]]
        name = Coherence - Gallery2Store  # default: gallery2Store
        #urlbase = /                      # default: / (not sure what this does)

iRadio

    [[IRadioStore]]
        name = Coherence - iRadioStore  # default: iRadioStore
        #urlbase = /                    # default: / (not sure what this does)

Last.FM

    [[LastFMStore]]
        name = Coherence - LastFMStore  # default: LastFMStore
        #urlbase = /                    # default: / (not sure what this does)

Lolcats

Serves images from lolcats.com

    [[LolcatsStore]]
        name = Coherence - Lolcats  # default: Lolcats
        refresh = 2                 # default: 1 (hours)
        #urlbase = /                # default: / (not sure what this does)

Media Database

Serves selected types of audio files (mp3, ogg, mpc, flac, wv and m4a currently) from a directory and its subdirectories. Files are discovered, have their metadata read by an interface to taglib, and if the necessary metadata is present, the files are added to a database. If the tags cannot be read properly by taglib, the files will not be added to the database.

    [[MediaStore]]
        name = Coherence - MediaStore Music  # default: MediaStore
        medialocation = /path/to/music       # default: tests/content/audio
        mediadb = /tmp/media.db              # default: tests/media.db
        #urlbase = /                         # default: / (not sure what this does)
        #coverlocation = /path/to/covers     # default: None (Where to put the retrieved covers)

Note: If you make any changes to the medialocation, the files present there or if any new features are added that may allow sharing of more files, you will need to rm -rf /tmp/media.db to rebuild the library. This is currently the only way to update the database.

There's a wishlist for a MediaDB-ng backend.

Picasa Web Albums

    [[PicasaStore]]
	name = Picasa Web Albums  # default : Picasa Web Albums
	userid = username         # Picasa username; default: None
	password = password       # Picasa username; default: None
	refresh = 60              # default: 60 (minutes)

Playlist

Exposes the list of video and audio streams from a m3u playlist (e.g. web TV listings published by french ISPs such as Free, SFR, German SWR3, ...)

    [[PlaylistStore]]
        name = Coherence - Playlist                                # default: my media (The name under this MediaServer shall show up with on other UPnP clients)
        playlist_url = http://www.swr3.de/wraps/swr3_mp3.m3u.php   # default : http://mafreebox.freebox.fr/freeboxtv/playlist.m3u
        #version = (2|1)                                           # The highest UPnP version this MediaServer shall support
        #uuid =                                                    # The unique (UPnP) identifier for this MediaServer, usually automatically set

SWR3

SWR3 Podcast (Comics, Thema des Tages, Börsenman,...)

    [[SWR3Store]]
        name = Coherence - SWR3 # default: SWR3
        opml = http://www.swr3.de/rdf-feed/podcast/  # default: http://www.swr3.de/rdf-feed/podcast/
        encoding = ISO-8859-1                        # default: ISO-8859-1
        refresh = 2                                  # default: 1 (hours)
        #urlbase = /                                 # default: / (not sure what this does)

Ted

    [[TEDStore]]
        name = Coherence - TEDtalks  # default: TEDtalks
        refresh = 2                  # default: 1 (hours)
        #urlbase = /                 # default: / (not sure what this does)

Tracker

    [[TrackerStore]
        name = Coherence - SWR3  # default: SWR3
        services = Music         # default: Music,Videos,Images
        #urlbase = /             # default: / (not sure what this does)