Supported File Types

Generally file type support depends on the linked libraries. Please check documentation for taglib, ffmpeg, libexif, libexiv2, libmatroska for the whole list and the restrictions. Gerbera depends on these libraries to extract the metadata.

In case you have special files you want to treat in a particular way you can map the extension in config section <extension-mimetype>:

<map from="avi" to="video/avi"/>

and then tweak its content type in <mimetype-contenttype> section:

<treat mimetype="video/avi" as="avi"/>

It may also be necessary to set a DLNA profile in <contenttype-dlnaprofile>

<map from="avi" to="AVI"/>

See Import section for the detailled description of these options.

Audio/Video/Image Files

The following properties are automatically extracted to metadata:

Property

Key

title

M_TITLE

artist

M_ARTIST

album_artist

M_ALBUMARTIST

album

M_ALBUM

date date

M_DATE M_UPNP_DATE

creation_time

M_CREATION_DATE

genre

M_GENRE

description

M_DESCRIPTION

track

M_TRACKNUMBER

discnumber

M_PARTNUMBER

composer

M_COMPOSER

CONDUCTOR

M_CONDUCTOR

ORCHESTRA

M_ORCHESTRA

The following metadata properties can be set in import script extensions: M_CREATOR, M_AUTHOR, M_ACTOR, M_PUBLISHER, M_REGION

Resource data is extracted as well and largely depends on the media type: R_DURATION, R_SIZE, R_BITRATE, R_BITS_PER_SAMPLE, R_VIDEOCODEC, R_AUDIOCODEC, R_RESOLUTION, R_SAMPLEFREQUENCY, R_NRAUDIOCHANNELS.

Online Content

The following properties are automatically extracted to metadata:

Property

Key

Comment

director

M_DIRECTOR

rating

M_RATING

studio

M_PRODUCER

Playlist Files

Playlist can be used to get tracks in special sequence or to link external content like web radio stations or videos.

m3u

There are two flavours:

  • Simple layout just lists the files (as absolute or relative path).

  • Extended layout (first line in file is #EXTM3U) adds meta-info in lines starting with #EXTINF. The standard requires #EXTINF:<duration>,<title>.

  • There is a Gerbera specific extension that allows #EXTINF:<duration>,<title>,<mimetype>

pls

PLS contains lines like Title1=, File1= etc.

There is a Gerbera specific extension that allows MimeType1=

asx

ASX files are XML files. Only version 3 is supported. Gerbera accepts param entries mimetype and protocol and copies them to the respective properties in the playlist item.

<asx version="3.0">
  <title>Test-List</title>
  <entry>
    <title>Track</title>
    <author>Artist</author>
    <ref href="http://85.14.216.232:9000"/>
    <param name="mimetype" value="video/mp4"/>
    <param name="protocol" value="http-get" />
  </entry>
</asx>