Haptique Music Troubleshooting
Music output is missing
Section titled “Music output is missing”Confirm the device or integration is powered on, reachable, and assigned to a Space. If the output was just added, refresh the Haptique OS dashboard and reopen the mobile app.
If discovery is available, run discovery again and check whether the output appears under a different name, room, or provider.
Playback does not start
Section titled “Playback does not start”Check that the selected source or library item is available, the output is online, and the target zone is not muted or already controlled by another source.
If playback fails only on one output, try the same track or station on a different output. If it works elsewhere, the issue is probably the selected output or that output’s supported capabilities.
Library is not updating
Section titled “Library is not updating”Confirm the folder is still mounted, reachable, and enabled. Run a new scan, then wait for albums, artists, tracks, and artwork to refresh.
If only some music appears, test with a small folder first. Large libraries and network folders can take longer to scan.
Radio station does not play
Section titled “Radio station does not play”Confirm the station stream URL is still valid and uses a supported stream format. Try the same station on one simple output before adding it to scenes, groups, or favorites.
Streaming service is not available
Section titled “Streaming service is not available”Use only services that HOS shows as available and connected for the project. If a service is marked coming soon, unavailable, or disconnected, use local library, uploaded songs, or internet radio until the service is ready.
Music starts on the wrong output
Section titled “Music starts on the wrong output”Check the Space and output name before starting playback. If the room has multiple outputs, choose the exact output, such as Living Room Speakers instead of TV Soundbar.
Volume does not change
Section titled “Volume does not change”Confirm the output supports volume control through its integration. Some sources expose playback but rely on a receiver, amplifier, or another device for volume.
Only one room changes volume in a group
Section titled “Only one room changes volume in a group”The control may be changing one output instead of the group. Look for the group volume control if the connected system supports it. If group volume is not available, adjust each output separately.
One player stops but another keeps playing
Section titled “One player stops but another keeps playing”This is normal when music is playing as independent players in separate Spaces. Stop the specific player you want to silence, or stop the whole group if grouped playback is active.
Grouped rooms are not exactly in sync
Section titled “Grouped rooms are not exactly in sync”Mixed outputs and mixed providers may work as best-effort groups. For tighter sync, use outputs from the same audio system when that system supports native sync grouping.
If HOS shows sync-quality labels or warnings, follow those labels. A warning usually means the group can be controlled together but should not be treated as perfectly synchronized.
Queue does not move to another output
Section titled “Queue does not move to another output”Queue transfer depends on the source and destination output. If transfer is not available, start the same album, playlist, station, or favorite on the new output.
Shuffle, repeat, or seek is missing
Section titled “Shuffle, repeat, or seek is missing”Not every source and output exposes every transport control. If a command is missing on one output, try the same source on another output to confirm whether it is a source limit or an output limit.
Audio profile or quality setting is missing
Section titled “Audio profile or quality setting is missing”Audio profiles, quality hints, and processing options depend on the selected output and installed HOS release. If the option is not shown, use the normal playback controls for that output.
Favorite is missing
Section titled “Favorite is missing”Check that the favorite was saved to the correct Space or user profile. Also confirm the signed-in user has permission to view and control that music source.
Scene starts but music is wrong
Section titled “Scene starts but music is wrong”Open the scene and confirm the target Space, output, source, favorite, and volume are correct. Test the music action by itself before testing the full scene.
AI does not control music
Section titled “AI does not control music”Use clear names for Spaces, outputs, and favorites. Confirm AI control is enabled for the Space and that the current user has permission to run music actions.