PULSEAUDIO-DLNA(1)

📦
version 0.6.4.1 · 2 versions
, in nixos 26.05, ubuntu noble

💖 PULSEAUDIO-DLNA(1) 💖

okay bestie, gather round, because this is the User Commands girlie of the manual world and she is serving ✨

🌸 NAME 🌸

pulseaudio-dlna — stream audio to DLNA devices and Chromecasts 🎀

✨ DESCRIPTION ✨

💅 Usage:

pulseaudio-dlna [--host <host>] [--port <port>][--encoder <encoders> |
--codec <codec>] [--bit-rate=<rate>]
       [--encoder-backend <encoder-backend>]
       [--filter-device=<filter-device>] [--renderer-urls <urls>]
       [--request-timeout <timeout>] [--chunk-size <chunk-size>]
       [--msearch-port=<msearch-port>] [--ssdp-mx <ssdp-mx>] [--ssdp-ttl
       <ssdp-ttl>] [--ssdp-amount <ssdp-amount>] [--cover-mode <mode>]
       [--auto-reconnect] [--debug] [--fake-http10-content-length]
       [--fake-http-content-length] [--disable-switchback]
       [--disable-ssdp-listener] [--disable-device-stop]
       [--disable-workarounds] [--disable-mimetype-check]

pulseaudio-dlna [--host <host>] [--create-device-config]
[--update-device-config]
       [--msearch-port=<msearch-port>] [--ssdp-mx <ssdp-mx>] [--ssdp-ttl
       <ssdp-ttl>] [--ssdp-amount <ssdp-amount>]

       pulseaudio-dlna [-h | --help | --version]

like, there are three whole moods you can run this in and they're all listed right there ⭐

🦋 OPTIONS 🦋

  • --create-device-config — the discovery era 💖 It finds every device on your network and writes a config for them. That config can be edited by hand to tweak all kinds of stuff. You can set:
    • Device name
    • Codec order (the first one gets used if the encoder binary is actually available on your system)
    • Various codec settings such as the mime type, specific rules or the bit rate (depends on the codec, iykyk)
A written config gets loaded by default if the --encoder and --bit-rate options aren't being used. periodt.
  • --update-device-config — same energy as --create-device-config, but it preserves your existing config from being overwritten 🫶
  • --host=<host> — set the server ip.
  • -p, --port=<port> — set the server port [default: 8080].
  • -e, --encoder=<encoders> — deprecated alias for --codec (she's retired but she's still in the building)
  • -c, --codec=<codecs> — set the audio codec. Possible codecs are:
    • mp3 — MPEG Audio Layer III (MP3)
    • ogg — Ogg Vorbis (OGG)
    • flac — Free Lossless Audio Codec (FLAC)
    • wav — Waveform Audio File Format (WAV)
    • opus — Opus Interactive Audio Codec (OPUS)
    • aac — Advanced Audio Coding (AAC)
    • l16 — Linear PCM (L16)
  • --encoder-backend=<encoder-backend> — set the backend for all the encoders. Possible backends are:
    • generic (default)
    • ffmpeg
    • avconv
  • -b, --bit-rate=<rate> — set the audio encoder's bitrate.
  • --filter-device=<filter-device> — set a name filter for the devices that should be added. Devices that get discovered but don't match the filter text get skipped, no hard feelings 🙈
  • --renderer-urls=<urls> — set the renderer urls yourself. no discovery will commence. (you're the discovery now 💅)
  • --request-timeout=<timeout> — set the timeout for requests in seconds [default: 15].
  • --chunk-size=<chunk-size> — set the stream's chunk size [default: 4096].
  • --ssdp-ttl=<ssdp-ttl> — set the SSDP socket's TTL [default: 10].
  • --ssdp-mx=<ssdp-mx> — set the MX value of the SSDP discovery message [default: 3].
  • --ssdp-amount=<ssdp-amount> — set the amount of SSDP discovery messages being sent [default: 5].
  • --msearch-port=<msearch-port> — set the source port of the MSEARCH socket [default: random].
  • --cover-mode=<mode> — set the cover mode [default: default]. Possible modes are:
    • disabled — no icon is shown
    • default — the application icon is shown
    • distribution — the icon of your distribution is shown
    • application — the audio application's icon is shown
  • --debug — enables detailed debug messages. the receipts, basically 🔍
  • --auto-reconnect — if set, the application tries to reconnect devices in case the stream collapsed.
  • --fake-http-content-length — if set, the content-length of HTTP requests will be set to 100 GB. yes, really, one hundred gigabytes, no cap 😭
  • --disable-switchback — if set, streams won't get switched back to the default sink if a device disconnects.
  • --disable-ssdp-listener — if set, the application won't bind to the port 1900 and therefore the automatic discovery of new devices won't work.
  • --disable-device-stop — if set, the application won't send any stop commands to renderers at all.
  • --disable-workarounds — if set, the application won't apply any device workarounds.
  • --disable-mimetype-check — if set, the application won't check the device's mime type capabilities.
  • -v, --version — show the version.
  • -h, --help — show the help.

🌈 EXAMPLES 🌈

  • pulseaudio-dlna

will start pulseaudio-dlna on port 8080 and stream your PulseAudio streams encoded with mp3.

  • pulseaudio-dlna --encoder ogg

will start pulseaudio-dlna on port 8080 and stream your PulseAudio streams encoded with Ogg Vorbis.

  • pulseaudio-dlna --port 10291 --encoder flac

will start pulseaudio-dlna on port 10291 and stream your PulseAudio streams encoded with FLAC.

  • pulseaudio-dlna --filter-device 'Nexus 5,TV'

will just use devices named Nexus 5 or TV even when more devices got discovered. only the chosen ones 💅

won't discover upnp devices by itself. Instead it will search for upnp renderers at the specified locations. You can specify multiple locations via urls separated by comma (,). Most users won't ever need this option, but since UDP multicast packages won't work (most times) over VPN connections this is very useful if you ever plan to stream to a UPNP device over VPN. vpn girlies, this one's for you 🫶

🎀 SEE ALSO 🎀

The full documentation for pulseaudio-dlna is maintained as a Texinfo manual. If the info and pulseaudio-dlna programs are properly installed at your site, the command

info pulseaudio-dlna

should give you access to the complete manual. go read the whole thing, bestie, it's giving ✨complete✨

and that's the whole page, babes 💖 this was pulseaudio-dlna version 0.6.1, dated janvier 2021 — written by the User Commands girlies, delivered to you with love and zero skipped options. slay, bye 👑

📦 where this page comes from