3 Configure Client Quirks

These settings define the additions to the automatic client type detection.

3.1 Clients

clients
Type: Section
Required: False
<clients enabled="yes"> ... </clients>

This section defines the client behaviour additions. It has to be explicitly enabled.

3.1.1 Clients Attributes

clients enabled
Type: Boolean
Required: False
Default: no
enabled="yes"

This attribute defines if client overriding is enabled as a whole.

cache-threshold
Type: Time
Required: False
Default: 6
cache-threshold="24"

This attribute sets the amount of hours a client entry is kept in the cache after its last contact.

bookmark-offset
Type: Time
Required: False
Default: 10
bookmark-offset="8"

This attribute sets the amount of seconds a playposition (Samsung bookmark) is reduced on resume to continue a bit before the last scene.

3.1.2 Client Details

client
Type: Section
Required: False
<client>...</client>

This section defines the client behaviour for one client.

3.1.2.1 Client Attributes

client ip
Type: String
Required: False
Default: empty
ip="10.10.10.10"

This allows to select clients by IP address. Allowed values are ip addresses (v4 or v6) which can be followed by /pref where pref is any allowed prefix length for the protocol.

client userAgent
Type: String
Required: False
Default: empty
userAgent="DLNADOC/1.50"

This allows to filter clients by userAgent signature. It contains a part of the UserAgent http-signature of your client. It can be found on the clients page of the web ui. In some cases it can help to run a network sniffer like wireshark or some UPnP utility to discover the signature. Most clients do not report exactly the same User-Agent for UPnP services and file request. If client ip is set client userAgent is ignored.

client friendlyName
Type: String
Required: False
Default: empty

Added in version 2.3.0.

client modelName
Type: String
Required: False
Default: empty

Added in version 2.3.0.

client manufacturer
Type: String
Required: False
Default: empty

Added in version 2.3.0.

friendlyName="..." modelName="..." manufacturer="..."

This allows to filter clients by their UPnP description. It contains a property which can be found in the device section of the description xml. UPnP network tools will provide you with the link to the xml document. It is only used if client ip and client userAgent are not set. friendlyName overwrites modelName which overwrites manufacturer.

client group
Type: String
Required: False
Default: default
group="wombat"

This assigns the client to a group which is key to store details on played items (playbackCount, lastPlaybackTime, lastPlaybackPosition, bookmarkPosition). If you set another group here all actions are recorded for this group.

flags
Type: String
Required: False
Default: 0
flags="SAMSUNG|0x100"

Containing the flags you want to set. Must be given in the following format SAMSUNG|0x100, where the text either contains one of the known flags or an integer number if the flags has no name. For valid flags see Supported Devices.

client caption-info-count
Type: Integer
Required: False
Default: caption-info-count
caption-info-count="0"

Number of sec::CaptionInfoEx entries to write to UPnP result.

client upnp-string-limit
Type: Integer
Required: False
Default: upnp-string-limit
upnp-string-limit="80"

Override the default upnp-string-limit of server.

client multi-value
Type: Boolean
Required: False
Default: multi-value
multi-value="no"

Override the default multi-value of server.

full-filter
Type: Boolean
Required: False
Default: no

Added in version 2.4.0.

full-filter="yes"

Enable the full UPnP filter support for this client. This means that all requested elements from the filter request property will be created in the response. Make sure that the namespaces are added with the the upnp section 1.4   UPnP Protocol

client allowed
Type: Boolean
Required: False
Default: yes

Added in version 2.3.0.

allowed="no"

If set to no all requests from a client are blocked.

3.1.2.2 Child Entries

3.1.2.2.1 Mimetype Mapping
client map
Type: Section
Required: False
<map from="application/x-srt" to="text/srt"/>

Map mimetype for client. Some clients require slightly different mimetype, e.g. for subtitles.

client map from
Type: String
Required: True
from="application/x-srt"

Set source mimetype.

client map to
Type: String
Required: True
to="text/srt"

Set target mimetype.

3.1.2.2.3 DLNA Profiles
client dlna
Type: Section
Required: False
<dlna from="mp4" videoCodec="h264" audioCodec="aac" to="AVC_MP4_MP_HD_720p_AAC"/>

Map DLNA profile for client. Some clients do not support basic dlna profiles. It overwrites general settings from contenttype-dlnaprofile with the same format, see 2.8.6   Map Contenttype to DLNA Profile.

client dlna from
Type: String
Required: True
from="mp4"

Set source content type.

client dlna to
Type: String
Required: True
to="AVC_MP4_MP_HD_720p_AAC"

Set target DLNA profile name.

3.1.3 Client Group

group
Type: Section
Required: False

Added in version 2.4.0.

<group> ... </group>

This section defines the behaviour for a group of clients.

3.1.3.1 Group Attributes

group name
Type: String
Required: True
name="wombat"

Name of the group. Should correspond to one of the group names in client settings or default

group allowed
Type: Boolean
Required: False
Default: yes

Added in version 3.0.0.

allowed="no"

If set to no all requests from a client assigned to this group are blocked. If group default is not allowed, each allowed client must be configured or assigned an allowed group.

3.1.3.2 Group Details

hide
Type: Section
Required: False
<hide location="/path/not/visible"/>
hide location
Type: Path
Required: True

Define a location of files that have to be hidden from the output for the group.