Skip to content

Devices UPnP Player

Arie J. Godschalk edited this page Nov 15, 2026 · 1 revision

UPnP Player

Home > Devices > UPnP Player

Contents: Add a player · Browse your library · Controls · What playing means

Add a player

Choose UPnP Player when adding a device from Universal Media Player, then select your media server. Homey stores its IPv4 address and port in the device's IP Address setting.

You select a media server here, not the speaker that will play its files. The destination is chosen separately in your playback Flow.

The discovery filter currently accepts UPnP root devices advertised as MediaServer:1, with an HTTP location using the discovered IPv4 address and an explicit port. Other devices and differently advertised servers may not appear.

Browse your library

Open a file or folder selection field in a Flow card.

  • Choose folders to move through the library.
  • Use Up/back to move back.
  • Choose the actual file when using a file card.
  • For a folder card, choose Play this folder after entering the folder you want.

The names and structure come from your media server. They may be categories such as Artist or Album rather than the drive's physical folders.

The app stores a path through those library names and resolves it again when a card runs. This can find a changed file URL without editing every Flow. Renaming or moving library entries can still break the selection; select the file again if that happens.

Controls

The device exposes play/stop, next, previous, shuffle, repeat, track, artist, album, and duration capabilities. Availability and appearance depend on Homey's interface.

  • Play/stop controls this app's selection and timers. Start a file or folder with a Flow before using Play.
  • Next chooses another playlist item and sends its URL event.
  • Shuffle switches the current playlist mode between ordered and random selection.
  • Repeat changes the app's mode; do not treat it as a command sent to the physical speaker.
  • Track, artist, album, and artwork come from the server when supplied.

The current manifest declares speaker_prev, while the listener is registered as speaker_previous. Previous-track control therefore has a source mismatch and should not be relied on.

What playing means

The device's playing state reflects this app's playlist activity, not confirmation from your speaker. It does not monitor whether the destination downloaded the file, started playback, paused, or finished.

Stopping the UPnP Player clears its timers. It does not send a stop command to the physical speaker. To stop the actual sound, use the destination app's own stop card.

The source also has a device-trigger routing limitation. For a first successful file test, use the action's direct outputs.

Next steps

Clone this wiki locally