Skip to content

Examples

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

Examples

Home / Examples

Start with a short sound you can safely test. Use your own file addresses and check the result before adding a schedule or combining several actions.

Play a doorbell sound

Requires: the first playback test already works, and your doorbell app provides a Flow trigger.

  1. Create a Flow starting with the doorbell's event.
  2. Add Music Url Converter -> Play URL.
  3. Enter the same short audio URL that worked in the manual test.
  4. Trigger the doorbell and listen to Homey.

Expected result: your chosen sound plays on Homey's speaker.

Historical Play URL action with an audio file address

Developer's original screenshot, in Dutch. The field after "Speel" contains a direct MP3 address. The address shown belongs to the example network; replace it with your own.

Play a file from FTP Client

Requires: a working FTP Connection, a short supported audio file, and Music Url Converter on a Homey with speaker support.

  1. Upload the audio file to your FTP server.
  2. Add FTP Client's Get file URL and select that file.
  3. After that action succeeds, run Music Url Converter -> Play URL.
  4. Put the URL or Cloud URL text token into Play URL's URL field. Choose the address Homey can reach.
Source Connect to
FTP Client Get file URL: URL or Cloud URL Music Url Converter Play URL: URL field

Expected result: Homey plays the selected file. The download response must still have a supported audio type. Generate the file link just before playback rather than storing a temporary link for much later.

For setup and the file-link behavior, follow FTP Client's card reference and its audio example.

Use an audio URL from another app

If another app produces a direct audio URL, connect that text token to Play URL after the producing action succeeds. Check the sound's response type and size before using a long recording.

The developer's announcement-system tutorial shows how audio sources and speech-producing apps can work together. It also includes external-speaker examples; those use the receiving speaker's own action rather than this Homey-speaker card.

Handle errors and timing

In Advanced Flow, connect the audio-producing card's successful output to Play URL. Send its error output to a notification or log if you want to know when playback could not be prepared. Do not include private URLs in that log.

For split MP3 files, the Flow can continue before all parts finish playing. Do not use this card's completion as an "entire track finished" signal. For a sequence of sounds, test the timing and leave enough time for the recording before starting the next URL.

Next steps

Check formats and limits before using larger files. If the test fails, follow Troubleshooting before adding more actions to the Flow.

Clone this wiki locally