Sections

Packages and installation 

minidlna__base_packages

List of APT packages to install for minidlna support.

minidlna__base_packages: [ 'minidlna' ]

minidlna__packages

List of additional APT packages to install during minidlna configuration.

minidlna__packages: []

Network configuration 

minidlna__allow

List of IP addresses or CIDR subnets which are allowed to connect to the MiniDLNA instances over the network, on all hosts in the Ansible inventory. If not specified, all hosts can connect to MiniDLNA service.

minidlna__allow: []

minidlna__group_allow

List of IP addresses or CIDR subnets which are allowed to connect to the MiniDLNA instances over the network, on hosts in a specific Ansible inventory group. If not specified, all hosts can connect to MiniDLNA service.

minidlna__group_allow: []

minidlna__host_allow

List of IP addresses or CIDR subnets which are allowed to connect to the MiniDLNA instances over the network, on specific hosts in the Ansible inventory. If not specified, all hosts can connect to MiniDLNA service.

minidlna__host_allow: []

minidlna__ssdp_allow

List of IP addresses or CIDR subnets which are allowed to send packets to the 1900/udp port used by Simple Service Discovery Protocol, configured on all hosts in the Ansible inventory. This is required only when UPnP port forwarding is desired.

minidlna__ssdp_allow: []

minidlna__ssdp_group_allow

List of IP addresses or CIDR subnets which are allowed to send packets to the 1900/udp port used by Simple Service Discovery Protocol, configured on hosts in a specific Ansible inventory group. This is required only when UPnP port forwarding is desired.

minidlna__ssdp_group_allow: []

minidlna__ssdp_host_allow

List of IP addresses or CIDR subnets which are allowed to send packets to the 1900/udp port used by Simple Service Discovery Protocol, configured on specific hosts in the Ansible inventory. This is required only when UPnP port forwarding is desired.

minidlna__ssdp_host_allow: []

MiniDLNA configuration 

These variables define the contents of the /etc/minidlna.conf configuration file. See minidlna__configuration for more details.

minidlna__original_configuration

List of the default MiniDLNA configuration options defined in the Debian package.

minidlna__original_configuration:

  - name: 'user'
    comment: |
      Specify the user name or uid to run as (root by default).
      On Debian system command line option (from /etc/default/minidlna) overrides this.
    value: 'minidlna'
    state: 'comment'

  - name: 'media_dir'
    comment: |
      Path to the directory you want scanned for media files.

      This option can be specified more than once if you want multiple directories
      scanned.

      If you want to restrict a media_dir to a specific content type, you can
      prepend the directory name with a letter representing the type (A, P or V),
      followed by a comma, as so:
        * "A" for audio    (eg. media_dir=A,/var/lib/minidlna/music)
        * "P" for pictures (eg. media_dir=P,/var/lib/minidlna/pictures)
        * "V" for video    (eg. media_dir=V,/var/lib/minidlna/videos)
        * "PV" for pictures and video (eg. media_dir=PV,/var/lib/minidlna/digital_camera)
    value: [ '/var/lib/minidlna' ]

  - name: 'merge_media_dirs'
    comment: |
      Set this to merge all media_dir base contents into the root container
      (The default is no.)
    value: False
    state: 'comment'

  - name: 'db_dir'
    comment: 'Path to the directory that should hold the database and album art cache.'
    value: '/var/cache/minidlna'
    state: 'comment'

  - name: 'log_dir'
    comment: 'Path to the directory that should hold the log file.'
    value: '/var/log/minidlna'
    state: 'comment'

  - name: 'log_level'
    comment: |
      Type and minimum level of importance of messages to be logged.

      The types are "artwork", "database", "general", "http", "inotify",
      "metadata", "scanner", "ssdp" and "tivo".

      The levels are "off", "fatal", "error", "warn", "info" or "debug".
      "off" turns of logging entirely, "fatal" is the highest level of importance
      and "debug" the lowest.

      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.

      The default is to log all types of messages at the "warn" level.
    value: 'general,artwork,database,inotify,scanner,metadata,http,ssdp,tivo=warn'
    state: 'comment'

  - name: 'root_container'
    comment: |
      Use a different container as the root of the directory tree presented to
      clients. The possible values are:
        * "." - standard container
        * "B" - "Browse Directory"
        * "M" - "Music"
        * "P" - "Pictures"
        * "V" - "Video"
        * Or, you can specify the ObjectID of your desired root container
          (eg. 1$F for Music/Playlists)
      If you specify "B" and the client device is audio-only then "Music/Folders"
      will be used as root.
    value: '.'
    state: 'comment'

  - name: 'network_interface'
    comment: |
      Network interface(s) to bind to (e.g. eth0), comma delimited.
      This option can be specified more than once.
    value: []
    state: 'comment'

  - name: 'port'
    comment: |
      Port number for HTTP traffic (descriptions, SOAP, media transfer).
      This option is mandatory (or it must be specified on the command-line using
      "-p").
    value: 8200

  - name: 'presentation_url'
    comment: |
      URL presented to clients (e.g. http://example.com:80).
    value: '/'
    state: 'comment'

  - name: 'friendly_name'
    comment: |
      Name that the DLNA server presents to clients.
      Defaults to "hostname: username".
    value: ''
    state: 'comment'

  - name: 'serial'
    comment: |
      Serial number the server reports to clients.
      Defaults to the MAC address of network interface.
    value: ''
    state: 'comment'

  - name: 'uuid'
    comment: |
      Specify device's UPnP UUID minidlna should use. By default MAC address is
      used to build uniq UUID.
    value: ''
    state: 'comment'

  - name: 'model_name'
    comment: 'Model name the server reports to clients.'
    value: 'Windows Media Connect compatible (MiniDLNA)'
    state: 'comment'

  - name: 'model_number'
    comment: |
      Model number the server reports to clients.
      Defaults to the version number of minidlna.
    value: ''
    state: 'comment'

  - name: "inotify"
    comment: 'Automatic discovery of new files in the media_dir directory.'
    value: True
    state: 'comment'

  - name: 'album_art_names'
    comment: |
      List of file names to look for when searching for album art.
      Names should be delimited with a forward slash ("/").
      This option can be specified more than once.
    value:
      - 'Cover.jpg/cover.jpg/AlbumArtSmall.jpg/albumartsmall.jpg'
      - 'AlbumArt.jpg/albumart.jpg/Album.jpg/album.jpg'
      - 'Folder.jpg/folder.jpg/Thumb.jpg/thumb.jpg'

  - name: 'strict_dlna'
    comment: |
      Strictly adhere to DLNA standards.
      This allows server-side downscaling of very large JPEG images, which may
      decrease JPEG serving performance on (at least) Sony DLNA products.
    value: False
    state: 'comment'

  - name: 'enable_tivo'
    comment: 'Support for streaming .jpg and .mp3 files to a TiVo supporting HMO.'
    value: False
    state: 'comment'

  - name: 'tivo_discovery'
    comment: |
      Which method to use for registering in TiVo: 'bonjour' (default) or
      legacy 'beacon'
    value: 'bonjour'
    state: 'comment'

  - name: 'notify_interval'
    comment: 'SSDP notify interval, in seconds.'
    value: 895
    state: 'comment'

  - name: 'minissdpdsocket'
    comment: 'Path to the MiniSSDPd socket, for MiniSSDPd support.'
    value: '/run/minissdpd.sock'
    state: 'comment'

  - name: 'force_sort_criteria'
    comment: |
      Always set SortCriteria to this value, regardless of the SortCriteria
      passed by the client
      e.g. force_sort_criteria=+upnp:class,+upnp:originalTrackNumber,+dc:title
    value: ''
    state: 'comment'

  - name: 'max_connections'
    comment: |
      maximum number of simultaneous connections
      note: many clients open several simultaneous connections while streaming
    value: 50
    state: 'comment'

  - name: 'wide_links'
    comment: 'set this to yes to allow symlinks that point outside user-defined media_dirs.'
    value: False
    state: 'comment'

minidlna__default_configuration

List of the default MiniDLNA configuration options defined by the role.

minidlna__default_configuration:

  # The default notification interval results in the MiniDLNA broadcasting its
  # presence every 14 minutes(!). This is too long for a reasonable setup where
  # you might expect to see a DLNA server appear almost immediately.
  - name: 'notify_interval'
    value: 30
    state: 'present'

minidlna__configuration

List of MiniDLNA configuration options defined on all hosts in the Ansible inventory.

minidlna__configuration: []

minidlna__group_configuration

List of MiniDLNA configuration options defined on hosts in a specific Ansible inventory group.

minidlna__group_configuration: []

minidlna__host_configuration

List of MiniDLNA configuration options defined on specific hosts in the Ansible inventory.

minidlna__host_configuration: []

minidlna__combined_configuration

Variable which combines MiniDLNA configuration lists and is used in role tasks and templates.

minidlna__combined_configuration: '{{ minidlna__original_configuration
                                      + minidlna__default_configuration
                                      + minidlna__configuration
                                      + minidlna__group_configuration
                                      + minidlna__host_configuration }}'

Configuration for other Ansible roles 

minidlna__ferm__dependent_rules

Configuration for the debops.ferm Ansible role.

minidlna__ferm__dependent_rules:

  - name: 'minidlna_allow_http'
    type: 'accept'
    dport: [ 'minidlna' ]
    protocol: [ 'tcp' ]
    saddr: '{{ minidlna__allow + minidlna__group_allow + minidlna__host_allow }}'
    weight: '50'
    by_role: 'debops.minidlna'

  - name: 'minidlna_allow_ssdp'
    type: 'accept'
    dport: [ 'ssdp' ]
    protocol: [ 'udp' ]
    saddr: '{{ minidlna__ssdp_allow + minidlna__ssdp_group_allow + minidlna__ssdp_host_allow }}'
    accept_any: False
    weight: '50'
    by_role: 'debops.minidlna'

minidlna_server__etc_services__dependent_list

Configuration for the debops.etc_services Ansible role.

minidlna_server__etc_services__dependent_list:

  - name: 'ssdp'
    port: '1900'
    protocol: [ 'udp' ]
    comment: 'Simple Service Discovery Protocol'

  - name: 'minidlna'
    port: '8200'
    protocol: [ 'tcp' ]
    comment: 'MiniDLNA media server Web Interface'

Packages and installation

Network configuration

MiniDLNA configuration

Configuration for other Ansible roles

Packages and installation 

Network configuration 

MiniDLNA configuration 

Configuration for other Ansible roles 