NAME

     minidlna.conf — MiniDLNA server configuration file

SYNOPSIS

     /etc/minidlna.conf

DESCRIPTION

     minidlnad(1) reads configuration options from the system-wide configuration file
     /etc/minidlna.conf, or the file specified with -f on the command line. The file contains
     keyword-argument pairs, one per line.  Lines starting with ‘#’ and empty lines are
     interpreted as comments.

     The possible keywords and their meanings are as follows:

     album_art_names
             List of filenames to check for when searching for album art cache, separated by
             forward slashes (‘/’).  This option can be specified more than once.

     db_dir  Path to the directory minidlnad should use to store its database and album art
             cache. Uses /var/lib/minidlna by default.

     enable_tivo
             Support for streaming .jpg and .mp3 files to a TiVo supporting HMO. Set to “yes” to
             enable support for streaming JPEG and mp3 files to a TiVo supporting HMO.  Set to
             “no” (default) otherwise.

     friendly_name
             Customize the name that the minidlnad server sends to clients. Defaults to
             “hostname: username”.

     force_sort_criteria
             Always set SortCriteria to this value, regardless of the SortCriteria passed by the
             clien t. ( E.g. force_sort_criteria=+upnp:class,+upnp:originalTrackNumber,+dc:title
             )

     inotify
             Set to “yes” to enable inotify monitoring of the files under media_dir to
             automatically discover new files. Set to “no” to disable inotify.

     network_interface
             Comma separated list of network interfaces to bind to. Default is empty which means
             bind to all.

     log_dir
             Path to the directory where the log file should be stored. Defaults to
             /var/log/minidlna.

     log_level
             Defines the type of messages that should be logged, and down to which level of
             importance they should be considered.

             The possible types are “artwork”, “database”, “general”, “http”, “inotify”,
             “metadata”, “scanner”, “ssdp” and “tivo”.

             The levels are “off”, “fatal”, “error”, “warn”, “info” and “debug”, listed here in
             order of decreasing importance.  “off” turns off logging messages entirely, “fatal”
             logs the most critical messages only, and so on down to “debug” that logs every
             single messages.

             The types are comma-separated, followed by an equal sign (‘=’), followed by a level
             that applies to the preceding types. This can be repeated, separating each of these
             constructs with a comma.

             Defaults to “general,artwork,database,inotify,scanner,metadata,http,ssdp,tivo=warn”
             which logs every type of message at the “warn” level.

     max_connections
             Specify maximum number of simultaneous connections. Note: many clients open several
             simultaneous connections while streaming.

     media_dir
             Path to the directory containing the media files the minidlnad server should share.
             Use this option several times if you have more than one directory to share. To
             restrict a path to one specific media type, you can use the following syntax: the
             letter ‘A’, ‘V’ or ‘P’, followed by a comma (‘,’) followed by the path. The meaning
             of the first letter is as follows:
                   •   ‘A’ for audio files;
                   •   ‘V’ for video files;
                   •   ‘P’ for image files.

             For example, if you want to include only video files located in
             /srv/multimedia/videos directory, and only music in /srv/multimedia/music, then you
             would use
                    media_dir=V,/srv/multimedia/videos
                    media_dir=A,/srv/multimedia/music

             Another example would be
                    media_dir=V,/srv/multimedia/videos
                    media_dir=V,/srv/multimedia/movies
                    media_dir=A,/srv/multimedia/music

             Or, if you did not care what type it finds, then you could use
                    media_dir=/srv/multimedia/videos
                    media_dir=/srv/multimedia/movies
                    media_dir=/srv/multimedia/music

             You can mix it up, find anything in music, but only Videos, in videos and movies
                    media_dir=V,/srv/multimedia/videos
                    media_dir=V,/srv/multimedia/movies
                    media_dir=/srv/multimedia/music

     merge_media_dirs
             Merge all media_dir base contents into the root container. The default value is no.

     minissdpdsocket
             Path to the MiniSSDPd socket, if you want to use minidlnad together with MiniSSDPd.
             Defaults to /run/minissdpd.sock.

     model_name
             Set the model name reported to clients.  Defaults to “Windows Media Connect
             compatible (MiniDLNA)”.

     model_number
             Set the model number reported to clients. Defaults to the version number of
             minidlnad.

     network_interface
             Network interface(s) to bind to (e.g. eth0), comma delimited. This option can be
             specified more than once. If unspecified or empty, minidlnad binds to all the valid
             network interfaces (except loopback).

     notify_interval
             Set the notify interval, in seconds. The default is 895 seconds.

     port    Port number for HTTP traffic (descriptions, SOAP, media transfe).  This option is
             mandatory, unless the port number is specified on the command-line using -p (see
             minidlnad(1)).

     presentation_url
             Define the URL presented to clients (e.g. “http://example.com:80”).  The default is
             ‘/’.

     root_container
             Use a different container as the root of the tree exposed to clients. The possible
             values
                   •   ‘.’ to use the standard container (this is the default);
                   •   ‘B’ to use the “Browse Directory” container;
                   •   ‘M’ to use the “Music” container;
                   •   ‘V’ to use the “Video” container;
                   •   ‘P’ to use the “Pictures” container.
             If you specify ‘B’ and the client device is audio only, then “Music/Folders” will be
             used as the root container.

     serial  Set the serial number reported to clients. Defaults to MAC address od network
             interface.

     strict_dlna
             Set to “yes” to strictly adhere to DLNA standards. This will allow server-side
             downscaling of very large JPEG images, which may hurt JPEG serving performance on
             (at least) Sony DLNA products. Set to “no” otherwise.

     tivo_discovery
             Which method to use for registering in TiVo. By default “bonjour” is used. You can
             switch to legacy “beacon” method.

     user    Specify the user name or UID to run as. Beware that if you are using an init system
             to start minidlnad, then this option has no effect and you should override default
             user in minidlna.service for systemd or set USER in /etc/default/minidlna for sysV
             init.

     uuid    Specify device's UPnP UUID minidlna should use. By default MAC address is used to
             build uniq UUID.

     wide_links
             Set to “yes” to allow symlinks that point outside user-defined media_dir. By
             default, wide symlinks are not followed.

FILES

     /etc/minidlna.conf
             System-wide default configuration file.

SEE ALSO

     minidlnad(1)