Home › Help
Help & troubleshooting

Help & troubleshooting

Quick fixes for the most common questions. If you're still stuck, the in-app Debug Log (Settings → Help → Save & Share) is the fastest way to get support - reach the developer in the Discord or the Facebook support group, replies are quick.

Connection

Getting connected

"Test Connection" fails
Make sure the phone and receiver are on the same Wi-Fi network and subnet - mesh systems, guest networks and IoT VLANs can isolate devices. On the receiver, Setup → Network → Network Control must be On. Re-check the IP against the receiver's own Network → Information screen, since DHCP addresses change. HTTP is required; Telnet and HEOS are nice-to-have. Full steps on the getting started guide.
Connection drops every few seconds
Receiver Telnet ports can get sticky after long uptimes - power-cycle the receiver from the wall to clear the listener. On Wi-Fi 6 mesh, force the phone onto the same band as the receiver (AVRs usually sit on 2.4 GHz; phones prefer 5 GHz).
How do I know my receiver is supported?
It comes down to your network, not just the model. If the receiver's web portal, the HEOS app and the official Denon/Marantz app can all reach it, AVR Maestro should too. See the supported receivers page.
Controls & display

Why something looks off

The volume readout looks wrong
Receivers report volume as absolute (0-98) or relative (-80 to +18 dB). The app handles both; if you recently changed the receiver's volume-display setting, restart the app so it re-reads the scale. You can flip which value shows on top in Settings → Audio.
Sound modes or feature pills are greyed out / "N/A"
Surround modes and features are gated by the input's audio format and the active sound mode - a 2-channel source won't enable Dolby Atmos. That's the receiver's behavior, not the app's. Tap the (?) next to an N/A pill for the exact requirement.
Some Sound or Speaker tabs are missing
Tabs are model- and mode-aware. Audyssey, Dirac Live, IMAX, Auro-3D, Surround Shape, Distances and Crossovers only appear on receivers that expose them. Check Settings → Devices → Device Information to see what the app detected, or re-add a hidden tab from Settings → Customize Tabs / Customize Navigation.
The Radio tab isn't showing
Radio is capability-gated: it only appears on receivers with a built-in FM/AM tuner. If yours has one but the tab is hidden, confirm the tuner appears as an input on the receiver and re-enable it from Settings → Customize Navigation. See the Radio guide.
Now Playing card is blank
The current input doesn't expose metadata - analog, optical/coaxial and most HDMI passthrough sources don't report track data. For HEOS sources, tap Launch HEOS to start playback, then return and the metadata populates.
Some speaker screens open in the receiver's web control
On some pre-2025 receivers (X4500H / X6700H / S960H / X4700H class), the receiver can't serve the Speaker Layout or Subwoofer Output screens to the app, so AVR Maestro hands you a one-tap button into the receiver's own web control for those edits. Everything else works normally; newer firmware serves every screen in the app.

Still stuck? We're quick to help

Grab the in-app Debug Log (Settings → Help) and reach the developer on Discord or Facebook - replies are fast.