Concept
Categories:
Goal / when to use
Read this once before you build a project. Maxx Remote sits between your speakers / rooms and the amplifier hardware, so you can tune and operate without constantly asking “which amp, which output?”
Mental model
Maxx Remote is an abstraction layer over amplifier outputs. It does not matter whether 1,000 speakers sit on thirty-two 32-channel amplifiers or on many smaller units — you work with project channels and groups.
As an operator or tuner, you usually care about this speaker or this room, not which physical output is used that day. Linking can change later; the channel settings stay in the project.
System overview
Desktop / Server and UI
Maxx Remote always consists of:
- A server that holds the project and talks to amplifiers
- A web UI (the screens you use in the browser or Desktop window)
Access the UI at http://localhost:8000 on the machine running the server (or http://<server-ip>:8000 for Docker / remote hosts).
Objects you will use
| Object | What it means in the room |
|---|---|
| Channel (project channel) | One speaker (or speaker strip) with full DSP: volume, EQ, delay, mute, and more |
| Group | A room or zone that can adjust the same kinds of parameters for many channels at once |
| Device | An amplifier in the project (for example 8 / 16 / 24 / 32 outputs, depending on model) |
| HW channel | A physical amplifier output, for example CH1 on AMP1 |
How they relate
A channel behaves like a channel strip: you can set it directly.
If that channel also belongs to one or more groups, group values are added (summed) with the channel’s own values. The result is what the amplifier should play.
Example for volume:
| Source | Volume |
|---|---|
| Channel | −2 dB |
| Group 1 | −1 dB |
| Group 2 | +5 dB |
| Output | +2 dB |
When a channel is linked to a HW channel, Maxx Remote sends that output result to the device.
Because settings live in the Maxx Remote project, you can replace an amplifier or re-link speakers to different outputs without rebuilding the whole tuning from scratch.
Out of Sync
After a channel is linked, Maxx Remote periodically compares project data with the device. Someone can still change the amp from Maxx Control or other tools — Maxx Remote then reports OUT OF SYNC for the mismatched parameters.
Do not use Maxx Control for day-to-day control of devices that Maxx Remote already owns. Data direction is Maxx Remote → device.
You resolve sync by aligning values in Maxx Remote with the device, or by pushing project data to the device (SYNC). Details: Troubleshoot.
Expected result
You understand that:
- Channels and groups are how you design and operate the system
- Devices and HW channels are how sound reaches the speakers
- Output levels are the sum of channel + group contributions
Common mistakes
- Tuning only on the device UI while Maxx Remote is connected — this causes Out of Sync.
- Expecting the CHANNELS list to show “group-only” values — CHANNELS shows the final output.
- Thinking a channel can live on only one group — a channel can belong to multiple groups.