GUI reference
Maxx Remote GUI reference — purpose and key actions for each screen (HOME, DEVICES, INPUTS, CHANNELS, GROUPS, CROSSMIX, SIG-PATH, VIEW, LOG).
Goal / when to use
Use this section as a Maxx Remote screen map: what each page is for, key actions, and links to task guides.
| Screen | Purpose |
|---|
| HOME | Project overview, status, API docs link |
| DEVICES | Amplifiers, connect, sync, link outputs |
| INPUTS | Dante / input sources |
| CHANNELS | Speakers / project channels |
| GROUPS | Rooms and zones |
| CROSSMIX | Surround / layout mix strategies |
| SIG-PATH | End-to-end signal routing view |
| VIEW | Operator pages |
| LOG | Application log / export |
Task-oriented docs start at Quick-Start and Build a system.
1 - HOME
Maxx Remote HOME screen — project overview, status cards, activity, and REST API docs link.
Purpose
Landing overview for the open project: health at a glance and entry points to docs / API.
Key actions
- Read PROJECT card — name, status, AUTO SYNC.
- Rename the project (NAME / SET) when needed.
- Check DEVICES counts and status.
- Check CHANNELS counts and linked-channel status.
- Review LAST ACTIVITIES (who changed what).
- Note APP-Version.
- Open REST-API Doc (same as
http://host:8000/api-docs/).
When to use
- Start of a session: is everything online?
- Enable AUTO SYNC after commissioning.
- Hand integrators the OpenAPI link.
2 - DEVICES
Add amplifiers, connect, identify, sync, and link hardware channels.
Purpose
Manage every amplifier in the project and map physical outputs to project channels.
Key actions
- ADD DEVICE — from network scan or manually (model, hostname, IP).
- Choose network interface / SCAN NETWORK when discovery is used.
- Toggle CONNECT per device.
- IDENTIFY the amplifier.
- Open LINK CHs to assign project channels ↔ HW channels.
- Run SYNC when project and device differ.
- Open device SETTINGS, COPY SETTINGS, or REBOOT DEVICE.
- REARRANGE list order; REMOVE devices (watch delete-linked-channels option).
3 - INPUTS
Create and manage input sources for groups (typically Dante TX labels).
Purpose
Define named INPUT SOURCES that groups can use for program audio.
Key actions
- + INPUT SOURCE — label, receive hostname, receive label(s).
- Edit source properties; set volume offset / mute when needed.
- Use DANTE DISCOVERY helpers if available.
- REARRANGE order; delete SELECTED / ALL.
- Import/export via CSV for large systems.
- Create/edit stream patches when the UI offers CREATE/EDIT STREAM.
4 - CHANNELS
Project channels — speakers, DSP, roles, and group membership.
Purpose
Work on individual speakers (project channels): levels, DSP, roles, linking status, and meters.
Key actions
- MAP | CREATE — add channels; open channel↔group mapping.
- Enable MULTI-WAY MODE when creating cabinets with multiple ways.
- Set ROLE for input routing (Left / Right / Mono / surround…).
- Edit DSP via row controls or dialog tabs: Volume, Mute, Phase, Delay, EQ, Limiter, Speaker, Input, Power, Status, …
- Read LEVEL / STATUS; remember values are final output (channel + groups).
- REARRANGE, CSV export/import, Copy Settings between channels.
- Jump to device linking from linked-channel indicators.
- Create / apply SPEAKER PRESET on the Speaker tab.
5 - GROUPS
Rooms and zones — grouped control of volume, mute, EQ, inputs, and more.
Purpose
Control many speakers as a room or zone. Group parameters sum with each member channel.
Key actions
- Create groups via MAP | CREATE → + GROUP.
- Map / unmap member channels.
- Configure GROUP ABILITIES (which controls the group exposes).
- Set VOLUME, MUTE, EQ, delay/phase as enabled.
- Assign INPUT sources and output/channel setup (stereo / surround).
- Select group-level CROSSMIX overrides when needed.
- Manage SNAPSHOTS for scene recalls.
- Apply group SPEAKER PRESET carefully (members inherit unless overridden).
6 - CROSSMIX
Strategies that map input layouts to speaker layouts (upmix / downmix).
Purpose
Define and assign matrices that route INPUT SOURCE legs to group output roles when layouts differ (or even when they match).
Key actions
- Browse strategies; filter by input / output setup.
- + CROSSMIX to create a custom matrix.
- Edit crosspoints and gain offsets in the matrix editor.
- Mark a strategy as global default for an in/out pair (always keep one).
- Assign overrides on groups or group+input combinations (higher priority).
- REARRANGE / delete unused non-default strategies.
7 - SIG-PATH
Visual signal path from sources through groups and channels to devices.
Purpose
See how audio is supposed to flow: source → group → channel → device. Useful for verifying routing after INPUT changes.
Key actions
- Open SIG-PATH.
- Filter by SOURCE, GROUP, LINKED, UNLINKED.
- Inspect columns/tabs for group, channel, input, and device relationships.
- Use TEST / identify controls to confirm the physical path.
- Jump back to CHANNELS / GROUPS / DEVICES to fix anything wrong.
Standalone per-group URLs exist for integrators — see Group signal path API.
8 - VIEW
Build operator pages with meters and simple controls; share fullscreen links.
Purpose
Create simplified operator canvases (rooms, mute, volume, meters, images) without exposing the full commissioning UI.
Key actions
- + VIEW to create a page.
- Add objects: channel, group, level meter, mute, power, volume, device, group input, image, view link.
- Arrange with align / distribute / layer tools; optional snap-to-grid.
- MANAGE IMAGES for background / diagram assets.
- SAVE VIEW.
- Copy the operator Link for fullscreen use (
/view/...). - DELETE VIEW when obsolete; BACK TO LIST to manage many pages.
9 - LOG
Application log — search, filter, load history, and export for support.
Purpose
Inspect what Maxx Remote and connected clients recently did when diagnosing failures.
Key actions
- Open LOG.
- Search / filter; Apply / Reset.
- Load older entries when the issue is further back.
- Export Log for support tickets.
- Correlate with the navbar warning icon and OUT OF SYNC alerts.