MINIDLNAD(1)

๐Ÿ“ฆ version 1.3.0, in debian bookworm, ubuntu jammy

๐Ÿ’– MINIDLNAD ๐Ÿ’–

okay bestie, sit DOWN, because we're about to talk about minidlnad(1) โ€” the manual page for the lightweight DLNA/UPnP-AV server, and it's genuinely iconic. this is the little daemon that beams your media around the house like it's running its own personal streaming service. no cap. ๐ŸŽ€


โœจ NAME โœจ

minidlnad โ€” lightweight DLNA/UPnP-AV server ๐Ÿ’…

like, that's it, that's the whole vibe. lightweight. server. serving. periodt.


๐ŸŒธ SYNOPSIS ๐ŸŒธ

minidlnad [-f config_file] [-d] [-v] [-u user] [-i interface] [-p port]
          [-s serial] [-m model_number] [-t notify_interval]
          [-P pid_filename] [-w url] [-S] [-L] [-R]

minidlnad [-h | -V]

so basically: a whole bunch of flags, OR just -h or -V if you're only here to ask a question. very "pick a lane, queen" of it. ๐Ÿ’œ


๐Ÿฆ‹ DESCRIPTION ๐Ÿฆ‹

The minidlnad daemon is a DLNA/UPnP-AV server sharing media files (video, music and pictures) to clients on your network. so it's out here distributing your videos, your music, and your pictures to anybody on the network who asks nicely. it's giving main character energy but for your LAN. ๐Ÿ”ฅ

and who are these "clients", you ask? typically multimedia players such as vlc, totem and xbmc, plus devices like portable media players, smartphones, televisions, video game entertainment systems and blu-ray players. so like, the TV in the living room, the console in the bedroom, your phone, your grandma's blu-ray player โ€” everybody eating at the same table. obsessed. ๐Ÿ“

By default, minidlnad listens on all the network interfaces (except loopback) for clients. so it's out there on basically everything except the lil self-referential loopback guy (he's not like other interfaces). This behavior can be changed on the command-line using the -i option, or in the configuration file through the network_interface option (see minidlna.conf(5) for details). so you got two ways to control the interface situation: command line or config file. pick your fighter. ๐Ÿ’…


๐Ÿ‘‘ OPTIONS ๐Ÿ‘‘

Most of the options below can also be set in a configuration file, as described in minidlna.conf(5). so like, if you're a config-file girlie, you can do most of this there too. we love flexibility. ๐Ÿซถ

  • -d โ€” Activate debug mode (do not daemonize). it stays right there with you instead of running off into the background. debug mode is basically "don't leave me, I need to see everything you're doing". ๐Ÿ˜ญ
  • -f config_file โ€” Specify the location of the configuration file. Uses /etc/minidlna.conf by default. so if your config is living somewhere else, tell it where. โœจ
  • -h โ€” Show help and exit. the "hey bestie, what are my options" flag. then it dips. ๐Ÿ’–
  • -i interface โ€” Network interface to listen on. Can be specified more than once. yes, MULTIPLE times. stack them. more interfaces, more love. ๐ŸŒˆ
  • -L โ€” Do not create playlists. no playlists, no problem. sometimes you just don't want them, and that's valid. ๐Ÿ’€
  • -m model_number โ€” Model number the daemon will report to clients in its XML description. it's literally introducing itself to clients with a fake-ish model number. catfishing, but make it UPnP. ๐Ÿ™ˆ
  • -P pid_filename โ€” PID file to use; the default is /run/minidlna/minidlna.pid. that's where its little PID lives. its home address, if you will. ๐Ÿ 
  • -p port โ€” Port number to listen on. pick a port, any port (well, any valid one). ๐ŸŽ€
  • -R โ€” Forces a full rescan of the media files. First it will remove all cached data and database. Any bookmarks will be lost. okay so this one is the DRAMATIC one. it nukes the cache AND the database, and it does NOT care about your bookmarks. > โš ๏ธ your bookmarks will be lost. gone. say goodbye. this is the nuclear option, bestie, do not press it casually. โ˜ ๏ธ
  • -r โ€” Do a non-destructive rescan of the media files on start-up. the polite version of the above. rescans on start-up, breaks nothing, keeps your stuff. the well-behaved sibling. ๐ŸŒธ
  • -S โ€” Stay foreground. Can be used when minidlnad is being managed by systemd. systemd wants to keep an eye on it, so it stays up front like a good little daemon. โญ
  • -s serial โ€” Serial number the daemon will report to clients in its XML description. same catfishing energy as -m, different field. ๐Ÿ’œ
  • -t notify_interval โ€” Notify interval, in seconds; defaults to 895 seconds. that's how often it goes "hey!! I'm still here!! still serving!!" to the network. 895 seconds of patience, exactly. ๐Ÿฆ‹
  • -u user โ€” Specify which user minidlnad should run as, instead of root; user can either be a numerical UID or a user name. drop the root privileges, queen, it's safer down there. ๐Ÿซถ
  • -V โ€” Show the program version and exit. the "who even are you" flag. ๐Ÿ’–
  • -v โ€” Verbose output. it will tell you EVERYTHING. it will not shut up. we love a chatty daemon. ๐Ÿ˜ญ
  • -w url โ€” Sets the presentation url; the default is http address. so when clients go looking for the web-y landing page situation, that's where they land. ๐ŸŒˆ

๐Ÿงš FILES ๐Ÿงš

  • /etc/minidlna.conf โ€” Default system-wide configuration file. See minidlna.conf(5) for details on the syntax. this is THE config file. the blueprint. the whole personality lives in here. ๐Ÿ’…

๐Ÿ”ฅ SEE ALSO ๐Ÿ”ฅ

like, go read the config page too, bestie, they're a matching set. ๐Ÿ’–


and that's the whole page, no notes!! this one came from the Debian folks, dated June 7, 2013 โ€” yeah, she's been around a minute, and she's still slaying. go forth and stream your media, and remember: -R is forever. ๐ŸŽ€โœจ๐Ÿ’–๐Ÿฆ‹

๐Ÿ“ฆ where this page comes from