Haptique Music Setup

Use Haptique Music after the HOS project has at least one Space and one usable audio output or media zone.

Before you start

• Haptique OS is installed, licensed, and running.
• The project has at least one Space.
• The audio device, receiver, streamer, or supported output is powered on and reachable.
• The music service, local library, or storage source is ready for use.
• The user has permission to control music in the target Space.

Setup flow

1. Open Haptique OS.
2. Enable Haptique Music for the project if it is not already enabled.
3. Add at least one source: local library, uploaded songs, internet radio, or an available streaming service.
4. Discover or add one output, speaker, streamer, or media zone.
5. Assign that output to the correct Space.
6. Give the output a clear name, such as Kitchen Music or Theater Music.
7. Play one item from the source to the output.
8. Test play, pause, volume, mute, skip, and queue behavior from Haptique OS.
9. Test the same controls from the HOS mobile app.

Add music sources

Start with one reliable source before adding the whole home.

• Uploaded songs: use this for a few tracks or a quick demo library.
• Local or NAS folder: use this when the home has an existing music collection.
• Internet radio: use this for fixed station streams the consumer plays often.
• Streaming services: connect only services that HOS shows as available for the project.

If a service appears as coming soon or unavailable, do not build scenes or favorites around it yet. Use a local library, radio station, or available service instead.

Connect streaming services

Use the Services area to connect available music accounts. Apple Music and Spotify connection paths may be available depending on the release and project configuration.

Qobuz and Tidal may appear in the service model or roadmap, but do not treat them as full catalog sources unless HOS marks them available for the project.

Scan a local library

For a local or NAS library:

1. Add the folder path or mounted music location.
2. Make sure the folder is enabled.
3. Start a scan.
4. Wait for albums, artists, tracks, and artwork to appear.
5. Play one track before adding more outputs or groups.

If the library is large, scan and test one output first. Add more folders only after the first scan is healthy.

Add internet radio

For a station:

1. Add the station name.
2. Add the stream URL.
3. Save the station.
4. Play it on one nearby output.
5. Save it as a favorite if it works reliably.

Use names people recognize, such as Jazz FM, Morning News, or Patio Radio.

Name outputs clearly

Consumers should see names that match the real room or listening area. Good output names make mobile control, scenes, RS90, and AI easier to use.

Good names:

• Kitchen Music.
• Living Room Speakers.
• Patio Speakers.
• Theater Music.

Avoid names like Output 1, HDMI 2, Receiver Zone B, or a device serial number unless the consumer already uses that name.

Multiple outputs

If a room has more than one place where music can play, add each output separately and assign it to the right Space. For example, a Living Room can have Living Room Speakers and TV Soundbar as separate outputs.

If a whole-home audio system supports grouping, configure each output first, then test grouping after individual playback works.

Discover and test outputs

Use output discovery to find supported speakers, streamers, AirPlay targets, Sonos players, UPnP/DLNA players, local HOS outputs, logical device targets, HOS Music Bridge endpoints, and other project-supported playback endpoints.

For each discovered output:

1. Confirm the name is clear.
2. Assign it to the correct Space.
3. Test one track or station.
4. Test volume and mute.
5. Confirm whether seek, queue, grouping, transfer, sync, and quality details are available.

Some outputs expose playback but not every control. If volume, grouping, queue, or transfer is missing, treat that as an output capability limit instead of a setup failure.

Audio profiles and quality

Some projects may expose audio profiles, signal-path hints, headroom, EQ, or quality settings. Use only the options that HOS shows as available for the selected output.

Do not promise exclusive DAC control, bit-perfect local playback, or full runtime DSP unless the installed HOS release and output path explicitly support it.

First working check

The first setup is ready when one Space can start playback, adjust volume, stop playback, browse or update the queue, and show the same music state from Haptique OS and the mobile app.

After that works, add more outputs, zones, favorites, and scene actions.