Skip to content

Troubleshooting

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

Troubleshooting

Home / Troubleshooting

If a sound will not play, try a short file first and change one thing at a time. This makes it easier to find whether the problem is Homey, the address, the server response, or the audio file.

On this page

Homey cannot use the app or makes no sound

Likely cause: this app's required local speaker feature is not available, or the audio file could not be prepared.

  1. Check the app's compatibility in the Homey App Store.
  2. Confirm you expect sound from Homey's built-in speaker, not an external one.
  3. Run the small-file test manually and check the Flow for an error.

Verify: the short test sound plays on Homey before trying an automatic Flow.

The link works in my browser but not in the Flow

Likely causes: your browser is signed in, Homey cannot reach the server, or the URL points to a web page rather than the audio file.

  1. Use a direct file address reachable from Homey's network.
  2. Check that it works without an interactive browser sign-in.
  3. Ask the file server or link-producing app for a supported audio response, not a player page or generic download.
  4. Generate a new link if the previous one was temporary.

Verify: the same direct address works in the manual test. Opening it only on your phone does not prove Homey can access it.

The file is MP3 or WAV but playback fails

Likely causes: an unsupported Content-Type, an oversized WAV, an MP3 reported over the limit, or an invalid audio file.

  1. Check the server's exact Content-Type.
  2. Try a file under 900,000 bytes.
  3. Check that the filename matches the real format; renaming does not convert it.
  4. For larger MP3 files, check the server's reported Content-Length and Homey's available memory.
  5. Test the actual audio file in a player to check whether it is valid.

Verify: the small supported file plays. Increase the size only after that works.

A long recording stops or another track interrupts it

Likely causes: a new Play URL has replaced the queued parts, a timer has been cancelled by app shutdown, or the file cannot be split as expected.

  1. Avoid another Play URL while the recording is playing.
  2. Do not stop or restart the app during the recording.
  3. Try a shorter MP3 to separate size/splitting issues from connection problems.
  4. Do not assume the Flow's completion means the full recording has ended.

Verify: one recording plays without starting another URL. Then test any sequence with enough time between sounds.

For a reproducible problem, report the format, file size, response type, Homey compatibility, and Flow error in the issue tracker. Do not post private audio URLs or login details.

Clone this wiki locally