Troubleshoot

Fix Out of Sync, discovery, Dante routing, and device replacement issues.
Tags:
Categories:

Goal / when to use

Something does not connect, discover, sync, or route audio. Work through the matching section below.

Out of Sync

Symptoms

  • Floating OUT OF SYNC alert in the UI
  • Device SYNC indicator not clean
  • Levels or EQ on the amp do not match Maxx Remote

Why it happens

Maxx Remote owns linked channels (Remote → device). Edits in Maxx Control, front-panel/other tools, or failed partial writes create differences. Maxx Remote detects them on periodic check-in.

Steps

  1. Click OUT OF SYNC (or device SYNC).
  2. Review which parameters differ.
  3. Choose direction carefully — normal recovery is APP → DEVICE (project wins).
  4. Use SYNC DEVICE / SYNC EVERYTHING as offered.
  5. Optional: enable HOME AUTO SYNC so future mismatches are pushed from the project automatically.

Expected result

Sync UI clears; amp matches the project.

Device not discovered

Symptoms

ADD FROM NETWORK is empty; UI may warn that discovery on UDP 9453 is unavailable.

Steps

  1. Confirm the amp appears in IDFM (discover) on the same PC/network.
  2. Check PC and amp are on a discovery-friendly segment (broadcast does not cross routers).
  3. Docker: use --network host — publishing UDP 9453 with -p is not enough for broadcast discovery. See Installation.
  4. Select the correct NETWORK INTERFACES / RECEIVE DISCOVERY options if shown.
  5. Fall back to ADD MANUALLY with hostname + IP.

Expected result

Device listed, or manually added and CONNECT goes online.

Dante TX sources missing in Maxx Remote

Symptoms

INPUTS / Dante discovery shows no (or stale) transmit channels, while Dante Controller on another PC may still see them.

Steps

  1. Confirm Maxx Remote can join the Dante control network (same L2 segment as the devices).
  2. Docker: use --network host. Dante discovery needs mDNS (224.0.0.251:5353) plus multicast 224.0.0.231:8702 and 224.0.0.233:8708 — bridge -p mappings do not deliver that reliably.
  3. Check host firewall allows those UDP multicast joins / inbound packets.
  4. As a workaround, read Transmit Channel@Hostname from Dante Controller and enter the INPUT SOURCE manually.

Expected result

TX channels appear for assignment, or you can enter them from Dante Controller.

Device connected but offline / errors

  1. DEVICES → STATUS column and CONNECT switch.
  2. Ping / browser-check the amp IP; re-run IDFM if IP changed.
  3. LOG → filter errors, Export Log if you need support.
  4. Try IDENTIFY / REBOOT DEVICE when safe.
  5. Re-link channels if the amp was replaced.

Dante / INPUTS silent

  1. Confirm TX hostname and label in Dante Controller match the INPUT SOURCE.
  2. Check channel ROLE (Left/Right vs Mono).
  3. Confirm the group has Input ability and a source assigned.
  4. For surround mismatches, review crossmix and group output setup.
  5. Verify Dante and control networks are as designed (many sites separate them).
  6. Look for D: subscriptions in Dante Controller after assignment.

Wrong speaker / wrong EQ after linking

  1. Open LINK CHs.
  2. IDENTIFY each HW channel.
  3. Unlink and re-link to the correct project channel.
  4. Re-apply or verify speaker preset if used.

Replace an amplifier

  1. Export the project.
  2. Add the new device; keep project channels.
  3. Link speakers again with IDENTIFY.
  4. SYNC project → device.
  5. Remove the old device when safe (do not delete project channels unless intended).

Common mistakes