openwrt minidlna config

冷不防 2022-09-21 13:28 170阅读 0赞

# MiniDLNA #

MiniDLNA is a lightweight DLNA/UPnP media server. The MiniDNLA daemon serves media files (music, pictures, and video) to clients on a network.

### Installation ###

root@OpenWrt:~# opkg update
    root@OpenWrt:~# opkg install minidlna

### Configuration ###

edit file: /etc/minidlna.confor/etc/config/minidlna.confor/tmp/minidlna.confdepend on your miniDLNA Version

#------------------------------------------------------#
    # port for HTTP (descriptions, SOAP, media transfer) traffic
    #------------------------------------------------------#
    port=8200
    
    #------------------------------------------------------#
    # network interfaces to serve, comma delimited
    #------------------------------------------------------#
    network_interface=br-lan
    
    #------------------------------------------------------#
    # set this to the directory you want scanned.
    # * if have multiple directories, you can have multiple media_dir= lines
    # * if you want to restrict a media_dir to a specific content type, you
    #   can prepend the type, followed by a comma, to the directory:
    #   + "A" for audio  (eg. media_dir=A,/home/jmaggard/Music)
    #   + "V" for video  (eg. media_dir=V,/home/jmaggard/Videos)
    #   + "P" for images (eg. media_dir=P,/home/jmaggard/Pictures)
    #------------------------------------------------------#
    # Directory of media is depend on your storage
    #------------------------------------------------------#
    media_dir=A,/mnt/sda1/music
    media_dir=P,/mnt/sda1/picture
    media_dir=V,/mnt/sda1/video
    #------------------------------------------------------#
    # set this if you want to customize the name that shows up on your clients
    #------------------------------------------------------#
    friendly_name=My DLNA Server
    
    #------------------------------------------------------#
    # set this if you would like to specify the directory where you want MiniDLNA to store its database and album art cache
    #------------------------------------------------------#
    db_dir=/mnt/sda1/minidlna/db
    
    #------------------------------------------------------#
    # set this if you would like to specify the directory where you want MiniDLNA to store its log file
    #------------------------------------------------------#
    log_dir=/mnt/sda1/minidlna/log
    
    #------------------------------------------------------#
    # this should be a list of file names to check for when searching for album art
    # note: names should be delimited with a forward slash ("/")
    #------------------------------------------------------#
    album_art_names=Cover.jpg/cover.jpg/AlbumArtSmall.jpg/albumartsmall.jpg/AlbumArt.jpg/albumart.jpg/Album.jpg/album.jpg/Folder.jpg/folder.jpg/Thumb.jpg/thumb.jpg
    
    #------------------------------------------------------#
    # set this to no to disable inotify monitoring to automatically discover new files
    # note: the default is yes
    #------------------------------------------------------#
    inotify=yes
    
    #------------------------------------------------------#
    # set this to yes to enable support for streaming .jpg and .mp3 files to a TiVo supporting HMO
    #------------------------------------------------------#
    enable_tivo=no
    
    #------------------------------------------------------#
    # set this 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.
    #------------------------------------------------------#
    strict_dlna=no
    
    #------------------------------------------------------#
    # default presentation url is http address on port 80
    #------------------------------------------------------#
    presentation_url=http://192.168.1.1:8200/
    
    #------------------------------------------------------#
    # notify interval in seconds. default is 895 seconds.
    #------------------------------------------------------#
    notify_interval=900
    
    #------------------------------------------------------#
    # serial and model number the daemon will report to clients
    # in its XML description
    #------------------------------------------------------#
    serial=12345678
    model_number=1
    
    #------------------------------------------------------#
    # specify the path to the MiniSSDPd socket
    #------------------------------------------------------#
    #minissdpdsocket=/var/run/minissdpd.sock
    
    #------------------------------------------------------#
    # use different container as root of the tree
    # possible values:
    #   + "." - use standard container (this is the default)
    #   + "B" - "Browse Directory"
    #   + "M" - "Music"
    #   + "V" - "Video"
    #   + "P" - "Pictures"
    # if you specify "B" and client device is audio-only then "Music/Folders" will be used as root
    #------------------------------------------------------#
    #root_container=.

### Configuration (uci) ###

This describes the configuration options in `/etc/config/minidlna`.

<table> 
 <tbody> 
  <tr> 
   <td><img src="https://wiki.openwrt.org/lib/images/smileys/fixme.gif" alt="FIXME"> This is just an initial dump of all the options I found, I am not certain about any other options or their actual meaning!</td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td><img src="https://wiki.openwrt.org/lib/images/smileys/fixme.gif" alt="FIXME"> I just guessed the Type entries. — <em>hcc23 2013/02/21 02:02</em></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <thead> 
  <tr> 
   <th>Name</th> 
   <th>Type</th> 
   <th>Required</th> 
   <th>Default</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>enabled</code></td> 
   <td>boolean</td> 
   <td>???</td> 
   <td>0</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td><code>port</code></td> 
   <td>string</td> 
   <td>???</td> 
   <td>8200</td> 
   <td>port for HTTP (descriptions, SOAP, media transfer) traffic</td> 
  </tr> 
  <tr> 
   <td><code>interface</code></td> 
   <td>string</td> 
   <td>???</td> 
   <td>br-lan</td> 
   <td>network interfaces to serve; comma (<code>,</code>) delimited</td> 
  </tr> 
  <tr> 
   <td><code>friendly_name</code></td> 
   <td>string</td> 
   <td>no</td> 
   <td>(<em>none</em>)</td> 
   <td>set this if you want to customize the name that shows up on your clients</td> 
  </tr> 
  <tr> 
   <td><code>db_dir</code></td> 
   <td>string</td> 
   <td>no</td> 
   <td>/var/run/minidlna</td> 
   <td>set this if you would like to specify the directory where you want MiniDLNA to store its database and album art cache</td> 
  </tr> 
  <tr> 
   <td><code>log_dir</code></td> 
   <td>string</td> 
   <td>no</td> 
   <td>/var/log</td> 
   <td>set this if you would like to specify the directory where you want MiniDLNA to store its log file</td> 
  </tr> 
  <tr> 
   <td><code>inotify</code></td> 
   <td>boolean</td> 
   <td>no</td> 
   <td>1</td> 
   <td>set this to no to disable inotify monitoring to automatically discover new files</td> 
  </tr> 
  <tr> 
   <td><code>enable_tivo</code></td> 
   <td>boolean</td> 
   <td>no</td> 
   <td>0</td> 
   <td>set this to yes to enable support for streaming .jpg and .mp3 files to a TiVo supporting HMO</td> 
  </tr> 
  <tr> 
   <td><code>strict_dlna</code></td> 
   <td>boolean</td> 
   <td>???</td> 
   <td>0</td> 
   <td>strictly adhere to DLNA standards; This will allow server-side down-scaling of very large JPEG images, which may hurt JPEG serving performance on (at least) Sony DLNA products.</td> 
  </tr> 
  <tr> 
   <td><code>notify_interval</code></td> 
   <td>integer</td> 
   <td>no</td> 
   <td>895</td> 
   <td>notify interval in seconds</td> 
  </tr> 
  <tr> 
   <td><code>serial</code></td> 
   <td>integer</td> 
   <td>???</td> 
   <td>12345678</td> 
   <td>model number the daemon will report to clients in its XML description</td> 
  </tr> 
  <tr> 
   <td><code>model_number</code></td> 
   <td>integer</td> 
   <td>???</td> 
   <td>1</td> 
   <td>model number the daemon will report to clients in its XML description</td> 
  </tr> 
  <tr> 
   <td><code>root_container</code></td> 
   <td><code>.</code>,<code>B</code>,<code>M</code>,<code>V</code>,<code>P</code></td> 
   <td>no</td> 
   <td><code>.</code></td> 
   <td>container for the tree root; <code>.</code>: default, <code>B</code>:browse directory, <code>M</code>:music, <code>V</code>:video, <code>P</code>:pictures</td> 
  </tr> 
  <tr> 
   <td><code>media_dir</code></td> 
   <td>string</td> 
   <td>???</td> 
   <td>/mnt</td> 
   <td>set this to the directory you want scanned;if have multiple directories, you can have multiple <code>media_dir</code> lines; if you want to restrict a media_dir to a specific content type, you can prepend the type, followed by a comma, to the directory: <code>A</code> for audio (eg. <code>A,/home/jmaggard/Music</code>)<code>V</code> for video, <code>P</code> for pictures; if you specify <code>B</code> and client device is audio-only then "Music/Folders" will be used as root</td> 
  </tr> 
  <tr> 
   <td><code>album_art_names</code></td> 
   <td>string</td> 
   <td>no</td> 
   <td>Cover.jpg/cover.jpg/AlbumArtSmall.jpg/albumartsmall.jpg/AlbumArt.jpg/albumart.jpg/Album.jpg/album.jpg/Folder.jpg/folder.jpg</td> 
   <td>a list of file names to check when searching for album art; <code> /</code> delimited</td> 
  </tr> 
  <tr> 
   <td><code>presentation_url</code></td> 
   <td>string</td> 
   <td>???</td> 
   <td>&nbsp;</td> 
   <td>default presentation url is http address on port 80</td> 
  </tr> 
  <tr> 
   <td><code>minisdpdsocket</code></td> 
   <td>string</td> 
   <td>???</td> 
   <td>&nbsp;</td> 
   <td>specify the path to the MiniSSDPd socket</td> 
  </tr> 
 </tbody> 
</table>

### Execute Daemon ###

root@OpenWrt:~# /etc/init.d/minidlna enable
    root@OpenWrt:~# /etc/init.d/minidlna start

**Done!**

miniDLNA server is ready to use ![:-D][-D]

### Notes ###

*  MiniDLNA's inotify support may not work as expected when trying to watch on an overlayfs filesystem. In the case of extroot, e.g. you can watch on \`/overlay/root/minidlna\` instead of \`/root/minidlna\`.

### Reference: ###

*  [Comparison of UPnP AV media servers][]
 *  [https://wiki.archlinux.org/index.php/Minidlna][https_wiki.archlinux.org_index.php_Minidlna]
 *  [http://wiki.ubuntuusers.de/MiniDLNA][http_wiki.ubuntuusers.de_MiniDLNA]
 *  The package has uci-support since [ R31211][R31211].

## Example ##

A video demonstration of how MiniDLNA 1.1.3-1 in the repositories can be installed on OpenWrt 14.07 Barrier Breaker: [ https://www.youtube.com/watch?v=-vU2zOw6ga0][https_www.youtube.com_watch_v_-vU2zOw6ga0]

## Chaos Calmer Tips ##

If you have a decent size music library, you will more than likely find building the minidlna database on your OpenWrt device extremely slow or impossible due to RAM constraints. The solution is to build the minidlna database on a Linux PC.

*  Create a directory on your OpenWrt hard or flash drive to hold the minidlna log and database files.
    
     *  `mkdir /PathToHardDrive/minidlna`
 *  On the OpenWrt device, modify the following `/etc/config/minidlna` lines to put the minidlna database and log file on the hard or flash drive connected to your OpenWrt device.
    
     *      option db_dir '/PathToHardDrive/minidlna'
            option log_dir '/PathToHardDrive/minidlna'
            option inotify '0'
            list media_dir 'A,/PathToHardDrive/PathToMp3s'
 *  Create a minidlna configuration file on the hard or flash drive connected to your OpenWrt device
    
     *  Put the following in file `cp_minidlna_conf.sh`.
        
         *      #!/bin/sh
                 
                . /lib/functions.sh
                 
                minidlna_cfg_append() {
                           
                	echo "$1" 
                }
                 
                minidlna_cfg_addbool() {
                           
                	local cfg="$1"
                	local key="$2"
                	local def="$3"
                	local val
                 
                	config_get_bool val "$cfg" "$key" "$def"
                	[ "$val" -gt 0 ] && val="yes" || val="no"
                	minidlna_cfg_append "$key=$val"
                }
                 
                minidlna_cfg_addstr() {
                           
                	local cfg="$1"
                	local key="$2"
                	local def="$3"
                	local val
                 
                	config_get val "$cfg" "$key" "$def"
                	[ -n "$val" ] && minidlna_cfg_append "$key=$val"
                }
                 
                minidlna_cfg_add_media_dir() {
                           
                	local val=$1
                 
                	minidlna_cfg_append "media_dir=$val"
                }
                 
                minidlna_create_config() {
                           
                	local cfg=$1
                	local port
                	local interface
                 
                	config_get port $cfg port
                	config_get interface $cfg interface
                 
                	[ -z "$interface" -o -t "$port" ] && return 1
                 
                	echo "# this file is generated automatically, don't edit" 
                 
                	minidlna_cfg_append "port=$port"
                	minidlna_cfg_append "network_interface=$interface"
                 
                	minidlna_cfg_addstr $cfg friendly_name
                	minidlna_cfg_addstr $cfg db_dir
                	minidlna_cfg_addstr $cfg log_dir
                	minidlna_cfg_addbool $cfg inotify '1'
                	minidlna_cfg_addbool $cfg enable_tivo '0'
                	minidlna_cfg_addbool $cfg strict_dlna '0'
                	minidlna_cfg_addstr $cfg album_art_names
                	minidlna_cfg_addstr $cfg presentation_url
                	minidlna_cfg_addstr $cfg notify_interval '900'
                	minidlna_cfg_addstr $cfg serial '12345678'
                	minidlna_cfg_addstr $cfg model_number '1'
                	minidlna_cfg_addstr $cfg minissdpsocket
                	minidlna_cfg_addstr $cfg root_container '.'
                	config_list_foreach "$cfg" "media_dir" minidlna_cfg_add_media_dir
                 
                	return 0
                }
                 
                 
                config_load 'minidlna'
                 
                minidlna_create_config config
     *  `chmod +x cp_minidlna_conf.sh`
     *  `./cp_minidlna_conf.sh > /PathToHardDrive/minidlna/minidlna.conf`
 *  Remove the hard or flash drive from the OpenWrt device and connect it to your Linux PC.
 *  Build the minidlna database on a Linux PC with [ minidlna 1.1.4][minidlna 1.1.4].
    
     *  `minidlnad -d -R -v -f /PathToHardDrive/minidlna/minidlna.conf`
 *  Remove the hard or flash drive from your Linux PC and reconnect to your OpenWrt device.

<table> 
 <tbody> 
  <tr> 
   <td><a href="https://wiki.openwrt.org/_detail/meta/icons/tango/48px-dialog-warning.svg.png?id=doc%3Auci%3Aminidlna" title="meta:icons:tango:48px-dialog-warning.svg.png" rel="nofollow"><img src="https://wiki.openwrt.org/_media/meta/icons/tango/48px-dialog-warning.svg.png" alt=""></a> Ensure that the Linux PC portable hard or flash drive mount point is <strong>exactly</strong> the same as the OpenWrt hard or flash drive mount point. Otherwise, the OpenWrt minidlna will delete and rescan the database you generated on the PC since the paths don't match</td> 
  </tr> 
 </tbody> 
</table>

This method has been tested with an Openwrt device with 32MB of RAM and a music library of over 11,000 songs. You may also want to add [ swap][swap] if you are running low on memory.

[-D]: https://wiki.openwrt.org/lib/images/smileys/icon_biggrin.gif
[Comparison of UPnP AV media servers]: https://en.wikipedia.org/wiki/Comparison%20of%20UPnP%20AV%20media%20servers
[https_wiki.archlinux.org_index.php_Minidlna]: https://wiki.archlinux.org/index.php/Minidlna
[http_wiki.ubuntuusers.de_MiniDLNA]: http://wiki.ubuntuusers.de/MiniDLNA
[R31211]: https://dev.openwrt.org/changeset/31211/packages
[https_www.youtube.com_watch_v_-vU2zOw6ga0]: https://www.youtube.com/watch?v=-vU2zOw6ga0
[minidlna 1.1.4]: http://sourceforge.net/projects/minidlna/files/minidlna/1.1.4/
[swap]: https://wiki.openwrt.org/doc/uci/fstab#adding_swap_partitions