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)

Debian                                            June 7, 2013                                  MINIDLNA.CONF(5)