Media Clients (DAAP & RSP)

Expose your music to external media players and devices using standard protocols.

Supported Protocols

DAAP (Digital Audio Access Protocol)

Originally developed by Apple for iTunes music sharing. DAAP lets compatible clients browse and stream your library over the network. Compatible clients include:

• iTunes / Apple Music (local network sharing)
• Rhythmbox (Linux)
• Amarok
• Banshee
• Any DAAP-compatible media player

RSP (Roku SoundBridge Protocol)

Used by Roku SoundBridge and compatible networked audio devices. Enables streaming from your server to hardware players on your local network.

Enabling Media Clients

1. Log in as an admin user
2. Click Settings in the sidebar navigation (gear icon)
3. Scroll down to the Media Clients section (at the bottom of the page)
4. Check Enable DAAP and/or Enable RSP depending on which protocols you need
5. Click Save

Once enabled, your server will advertise itself on the local network. Compatible clients should discover it automatically via mDNS/Bonjour.

What Gets Exposed

Media clients see the content from your currently active library. This includes:

• All songs, albums, and artists in the active library
• Metadata (title, artist, album, year, genre, track number)
• Album artwork

Playlists and favorites are not exposed through DAAP/RSP — they're only available in the web player.

Network Requirements

• Media client protocols work on the local network only — they are not designed for remote access
• The server and clients must be on the same subnet (or have mDNS/Bonjour routing configured)
• If running in Docker, you may need to use --network host or expose additional ports for service discovery to work

# Host networking for full mDNS support
docker run --network host \
  -v ./storage_data:/rails/storage \
  -v /path/to/music:/media_data \
  -e MEDIA_PATH=/media_data \
  ghcr.io/ajeskey/blackcandystore:latest

Security Considerations

• DAAP and RSP do not support authentication — anyone on your local network can browse and stream when enabled
• Only enable these protocols on trusted networks
• If you're running the server on a public VPS, leave these disabled unless you have network isolation in place

Disabling

Uncheck the protocol checkboxes in Settings and click Save. The server will stop advertising and responding to media client requests immediately.