Skip to content

docs(plugins): add DLNA Receiver plugin page#626

Open
trudenboy wants to merge 5 commits intomusic-assistant:betafrom
trudenboy:docs/dlna-receiver
Open

docs(plugins): add DLNA Receiver plugin page#626
trudenboy wants to merge 5 commits intomusic-assistant:betafrom
trudenboy:docs/dlna-receiver

Conversation

@trudenboy
Copy link
Copy Markdown
Contributor

Summary

Adds a new documentation page for the DLNA Receiver plugin, which exposes Music Assistant as a UPnP/DLNA MediaRenderer on the local network. External DLNA-aware apps (BubbleUPnP, mconnect, foobar2000, Kodi, Qobuz, etc.) discover the virtual renderer over SSDP, send audio via standard DLNA (SetAVTransportURI / Play), and MA routes the stream through its audio pipeline to any configured player.

Changes

  • New page: src/content/docs/plugins/dlna-receiver.md
  • Sidebar entry added to astro.config.mjs under Plugins (alphabetically between Ariacast Receiver and Home Assistant)

The page follows the style of the VBAN Receiver and Yandex Smart Home plugin pages (CAUTION / WARNING / NOTE callouts, features table, explicit settings list, known issues / notes) and documents:

  • Supported UPnP services and actions (AVTransport:1, RenderingControl:1, ConnectionManager:1)
  • Single-renderer and multi-player modes (target_players=* or comma-separated player IDs)
  • Stable UUID5-derived UDN so control-point bookmarks survive restarts
  • Plugin settings (friendly name prefix, target players, bind IP, HTTP base port)
  • Tested control points (BubbleUPnP, mconnect, foobar2000, Kodi, Qobuz)
  • Docker requirement: network_mode: host for SSDP multicast
  • SSRF hardening: only http(s):// URIs are accepted for incoming streams

Related PRs

Related links

Test plan

  • Docs site builds with the new page and sidebar entry
  • Page renders at /plugins/dlna-receiver/
  • Callouts and tables display correctly

Adds a new documentation page for the DLNA Receiver plugin, which
exposes Music Assistant as a UPnP/DLNA MediaRenderer so external apps
can cast audio to any MA player.

- New page: src/content/docs/plugins/dlna-receiver.md
- Sidebar entry added to astro.config.mjs under Plugins

Related PR: music-assistant/server#3611
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 22, 2026

Deploy Preview for ohf-music-assistant ready!

Name Link
🔨 Latest commit b53dd93
🔍 Latest deploy log https://app.netlify.com/projects/ohf-music-assistant/deploys/69f0c535d56395000858a342
😎 Deploy Preview https://deploy-preview-626--ohf-music-assistant.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@OzGav
Copy link
Copy Markdown
Collaborator

OzGav commented Apr 24, 2026

Please review this and ensure it contains information that the user needs to know to successfully use it. Currently it contains a lot of technical or irrelevant detail.

@trudenboy trudenboy marked this pull request as draft April 24, 2026 11:07
Comment thread src/content/docs/plugins/dlna-receiver.md Outdated
Address review feedback on PR music-assistant#626:
- Remove external docs link and UPnP-internals (SCPD, GENA, UDN/UUID5,
  SOAP fault codes, DIDL-Lite XEE).
- Replace features/services tables with concise user-focused bullets.
- Simplify settings descriptions and Docker note.
@trudenboy
Copy link
Copy Markdown
Contributor Author

Thanks for the review — rewrote the page to be user-focused. Dropped UPnP internals (SCPD, GENA, UDN/UUID5, SOAP fault codes, services/actions table), the technical SSDP multicast WARNING, the multi-player internals subsection, and the external docs link. The page now covers only what a user needs: short feature list, settings, Docker note, and the security note about accepted URL schemes.

@trudenboy trudenboy marked this pull request as ready for review April 28, 2026 06:19
Comment thread src/content/docs/plugins/dlna-receiver.md Outdated
Comment thread src/content/docs/plugins/dlna-receiver.md Outdated
Comment thread src/content/docs/plugins/dlna-receiver.md Outdated
trudenboy and others added 3 commits April 28, 2026 17:28
Co-authored-by: OzGav <gavnosp@hotmail.com>
Added note about Docker network mode requirement for DLNA.
Copy link
Copy Markdown
Collaborator

@OzGav OzGav left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants