NAME¶
minidlna.conf
—
MiniDLNA server configuration file
SYNOPSIS¶
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
- Set to “yes” to enable support for streaming JPEG and mp3
files to a TiVo supporting HMO. Set to “no” otherwise.
friendly_name
- Customize the name that the
minidlnad
server sends to clients. Defaults to
“hostname: username”.
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.
listening_ip
- IPv4 address
minidlnad
should listen on
(e.g. “198.51.100.1/24”). If omitted, the mask defaults to
/24. This option can be specified more than once. If unspecified or empty,
minidlnad
binds to the network
interfaces given in network_interface
;
if it is also unspecified or empty, it binds to all the valid network
interfaces (except loopback).
log_dir
- Path to the directory where the log file should be stored. Defaults to
/var/log.
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.
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 under the
/opt/media/videos directory, you would
use media_dir=V,/opt/media/videos
.
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 the IPs given in
listening_ip
; if it is also unspecified
or empty, it 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
“00000000”.
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.
user
- Specify the user name of UID to run as. Beware that if you are using the
init script to start
minidlnad
, then
this option has no effect and you should set
USER
in
/etc/default/minidlna instead.
FILES¶
- /etc/minidlna.conf
- System-wide default configuration file.
SEE ALSO¶
minidlnad(1)