Skip to content

Examples

Arie J. Godschalk edited this page Nov 15, 2026 · 2 revisions

Examples

Home > Examples

Contents: One file · Homey's speaker · Older trigger Flows · Sound before speech

Before you start

Add a UPnP Player, publish a short known-good sound on its media server, and prepare a destination app that accepts a file URL.

Use your own library names and destination. doorbell.mp3 below is a suggested test filename, not a file supplied with this app.

Play one file with Advanced Flow

You need Advanced Flow enabled on Homey.

  1. Create an Advanced Flow with a Start button for manual testing.
  2. Add Universal Media Player's Play a UPnP file action in Then, not the similarly named condition.
  3. Choose your UPnP Player, browse to doorbell.mp3, and select the actual file.
  4. Leave Finish unchecked.
  5. Add your destination app's play-from-URL action after it.
  6. Connect the first action's success path to the destination action.
  7. Drag the first action's Url tag into the destination's URL field.
  8. Connect error paths to a visible notification, then press Start.
Start
  -> UPnP Player: Play a UPnP file
       File: your selected doorbell.mp3
       Finish: unchecked
  -> Destination: play from URL
       URL argument <- UPnP action's Url tag

Expected result: the selected file address is returned immediately and your destination plays the sound.

If the first card fails, reselect the file and check the server. If it succeeds but the destination fails, check the URL's reachability and audio format. This separates a library problem from a speaker problem.

This direct connection does not depend on the app's currently problematic device-trigger filters.

Play on Homey's own speaker

Use the example above, replacing the destination with Music Url Converter's Play URL action. Connect Universal Media Player's Url tag to that action's URL field.

Before doing so:

Large split MP3 playback in Music Url Converter can continue after its action finishes. Do not equate that card's completion with the end of the whole track.

The integration is also described in the developer's announcement tutorial and community advice about larger sounds.

Older trigger-based Flows

The older two-Flow approach uses:

  1. A requesting Flow that selects a file or folder.
  2. A forwarding Flow with Url trigger in When and the destination's URL action in Then.

The forwarding Flow connects Url to the destination's file-URL input.

Historical Homey Flow connecting the UPnP Player's Url changed trigger to a Sonos audio-clip action with the Url tag

Developer screenshot from the 2021 community guide. The Dutch headings mean When, And, and Then. Notice the green Url tag passed to Sonos. The screenshot illustrates the older trigger-based route; it does not show the recommended direct-output Advanced Flow or resolve the current trigger-filter issue. Your device names and destination card may differ.

The current source limitation applies to these older Flows. If your installation does not run the forwarding Flow, there is no missing hidden setting to enable it. Use direct outputs for a first test and report the trigger issue.

A sound before a spoken announcement

The original announcement tutorial and sequential example place a short media sound before a Google Services speech card.

They use waiting conditions plus separate URL-forwarding Flows. Their waits are estimates and the current Universal Media Player trigger limitation must be addressed before that route can play sound.

Google Services' current sound-before-speech guide explains those trade-offs and the direct-output alternative.

For a simple first test, play the sound using the direct-output example, then test speech independently using Google Services' speech-device setup and announcement example. Do not assume either card confirms that a listener heard the message.

Avoid overlapping file requests on one UPnP Player: a new request clears the previous timer. Exact, interruption-safe announcement sequencing needs separate validation on your real destination.

Next steps

Clone this wiki locally