← All posts

/ Lukas Scheerer

A media link is not a stream.

What happens between sharing a link and playing it on a DLNA device, and how to narrow down errors along the way.

  • Android
  • DLNA
  • Debugging

Three separate tasks

Getting a media link from your phone to a player takes several steps: finding the player, providing compatible media and controlling playback. Each task can fail independently.

PlayOnDLNA also prepares video or audio and serves it from the Android device on the local network. A link to a website is not necessarily a directly playable media file.

A useful model

Shared media link
        |
        v
Android app: prepare media
        |
        v
Local media URL ----------> DLNA player
        |                       |
        +--- Playback control --+

This diagram is deliberately simplified. It separates the data path from playback control: a player can be visible and responsive without successfully playing the supplied media.

Narrow down errors along the way

The player does not appear: Start by checking that both devices are connected to the local network. A guest network or isolation between Wi-Fi clients can prevent communication. Note the devices and network configuration involved.

The player appears but does not start: Discovery may already have succeeded. A useful bug report includes the media source, the specific player and what happens when you press play. Reachability of the local media URL and format support may also play a part.

Playback starts and then stops: Describe whether it stops reproducibly after a certain time, when you lock the phone or when the network changes. A repeatable pattern gives much more to work with than “sometimes it doesn’t work.”

A bug report you can work with

App version:
Android version and phone:
Player model:
Media source and content type:
Network setup:

Steps:
1.
2.
3.

Expected behavior:
Actual behavior:
Reproducible: always / sometimes / once

Do not publish private media links or unchecked full logs. Remove sensitive information while keeping the technical details needed to understand the problem.

Local does not automatically mean offline

PlayOnDLNA provides prepared media on the local network. If the content comes from an online source, the app still needs to fetch it first. This distinction helps with both understanding and debugging.

The PlayOnDLNA project page describes its features. Current prerequisites and existing bug reports are in the repository.