Repository navigation
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
- App incompatible or no Homey sound
- A link works in my browser only
- An MP3 or WAV is rejected
- Long audio stops or overlaps
Likely cause: this app's required local speaker feature is not available, or the audio file could not be prepared.
- Check the app's compatibility in the Homey App Store.
- Confirm you expect sound from Homey's built-in speaker, not an external one.
- 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.
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.
- Use a direct file address reachable from Homey's network.
- Check that it works without an interactive browser sign-in.
- Ask the file server or link-producing app for a supported audio response, not a player page or generic download.
- 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.
Likely causes: an unsupported Content-Type, an oversized WAV, an MP3 reported over the limit, or an invalid audio file.
- Check the server's exact Content-Type.
- Try a file under 900,000 bytes.
- Check that the filename matches the real format; renaming does not convert it.
- For larger MP3 files, check the server's reported Content-Length and Homey's available memory.
- 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.
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.
- Avoid another Play URL while the recording is playing.
- Do not stop or restart the app during the recording.
- Try a shorter MP3 to separate size/splitting issues from connection problems.
- 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.
Support development - If Music Url Converter is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!