{{{
#!html
<h1 style="text-align: center; color: blue; font-size:3.0em">Backends</h1>
}}}

[[TOC(heading= ,inline)]]

[[BR]]
[[BR]]
[[html(<div style="border: 3px solid red">)]]
'''Note:''' These sample configs are depreciated albeit still work. It is prefered to use the new xml-style config. Please see [wiki:XMLConfig XMLConfig] for more information. The info on this page will soon be updated or merged.
[[html(</div>)]]

[[BR]]
[[BR]]

== 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 [http://coherence-project.org/wiki/MediaDB-ng wishlist] for a [http://coherence-project.org/wiki/MediaDB-ng 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)
}}}