Audio Hero Documentation

Complete user guide for Audio Hero, a local HEOS controller for Windows that also controls Sonos, Chromecast, AirPlay, and many other network audio devices.

Document v2.11.1

Audio Hero discovers and controls your HEOS-compatible Denon and Marantz devices on the local network. HEOS is, and always will be, our first focus, with the deepest and most polished support. Sonos, Roku, and Onkyo / Integra are fully supported too, held to the same standard as HEOS. Audio Hero also reaches a growing range of other network audio devices: Chromecast, AirPlay, Yamaha MusicCast, Snapcast, and more (see Additional device support). Device-control commands are sent directly from your PC to your speakers and receivers and do not leave your network.

Click any section heading below to expand it.

1. Getting started

Install and first launch
  1. Install Audio Hero from the Microsoft Store. Free and Pro are the same app: Pro features unlock via an in-app purchase on the Store.
  2. Make sure your HEOS speakers or receivers are powered on and on the same Wi-Fi or wired network as your PC.
  3. Launch Audio Hero. It opens on the Players tab and shows a spinner while it gets to work, so there is nothing to click to begin.
  4. On the very first launch, Audio Hero automatically runs a thorough scan: it broadcasts an SSDP discovery probe on every active network adapter and lists every HEOS device that responds, plus any other device families you've enabled (see Additional device support).
  5. If a HEOS device is found, Audio Hero connects to the first one for you and the status dot turns green. If nothing connects automatically, the discovered devices are listed instead, so click any one to connect (or enter its IP address by hand, below).
After the first launch: Auto-connect last device is on by default, so every later launch silently reconnects to the device you used last, without scanning, and shows "Reconnecting to your last deviceโ€ฆ" while it does. If that device cannot be reached, Audio Hero falls back to a full scan and lets you pick. Turn on Auto-discover on startup if you would rather rescan the whole network every time, or Remember discovered devices to keep the full device list between sessions. You can re-scan whenever you like with the Discover Devices button while disconnected, or the refresh icon at the bottom of the Players list.
System requirements

Audio Hero also controls many other network audio device families. Sonos, Roku, and Onkyo / Integra are fully supported. Chromecast, AirPlay, Yamaha MusicCast, and more are experimental. All are optional and off by default; see Additional device support.

Connecting by IP address

If discovery cannot find a device (for example across VLANs, or when the router blocks multicast), enter the device IP directly:

  1. Open the Players tab.
  2. Type the IP address into the Or enter IP address: field.
  3. Click Connect IP.

If Include support for legacy HEOS devices is enabled in Settings, a second field appears below for adding pre-HEOS Denon/Marantz devices by IP.

2. Main window tour

Header bar
Left sidebar: Players, Groups, Settings

The sidebar has three tabs:

Hiding inputs you never use. Some devices expose lots of physical inputs (for example a soundbar with four HDMI ports you do not all use). Right-click a player, hover Play input from this device or Send input to another speaker, and click the small hide icon next to any input to remove it from the list. Hidden inputs collapse into a Show hidden inputs (N) submenu at the bottom where you can restore them at any time. The hide list is per-device and saved with your settings.

Device indicator icons in the Players list: the gear and the power button

Each device row in the Players list can show two small icons on the right, next to the device name. They act on that device only, so you do not have to select it first. (A separate green name and ▶ glyph mean the device is actively playing, and a small green or grey dot shows connection state.)

Marks beside the device name

MarkMeaning
Green name and green ▶This device is playing audio right now.
L inside the green ▶This device is the leader of a group: it is the one feeding the music to the others.
C inside the green ▶The audio is being served by an Audio Hero Companion on another PC.
Colored G circleThis device belongs to a group. Every member of the same group shares the color. See Groups and multi-room.
⬆ FW chipA firmware update is waiting for this device. See Device firmware updates.
Small green or grey dotConnected, or not currently reachable.

A second line under the device name can show its model, its IP address, both, or nothing. Choose which in Settings → Devices & sources → Show under each device.

⚙ Gear: device controls

The gear opens an inline Device Controls panel for that specific device, shown below the Players list. What the panel holds depends on the device:

The tooltip changes to match the device, for example Receiver settings, MusicCast settings, or Roku remote. The panels share one slot, so opening one closes any other.

⏻ Power button

The power icon toggles power or standby for that device, and its colour shows the current state at a glance:

ColourMeaning
GreenPowered on (for status-only devices such as Sonos, currently playing).
YellowIdle / standby: reachable but not playing (network standby, muted, or screen off).
GreyState unknown, unreachable, or the device has no network power control.
PulsingAudio Hero is querying the device's current power state.

What a click does depends on what the device supports:

On multi-zone AV receivers, turn on Power button controls multiple zones in the receiver settings and the power button opens a small per-zone popup instead of just toggling the main zone. See Receiver controls.
Organizing the Players list: order, device types, and rooms New

The Players list starts in the order your devices were discovered, which rarely matches the way you think about your home. You can put the devices in any order you like, and you can group them under headers so a long list is easier to scan. The two grouping switches live under Settings → Devices & sources → Players list grouping. All of this is purely a way to tidy the list; it does not link devices for synchronized playback (for that, see Groups and multi-room).

Put the devices in the order you want

Drag any device in the Players list to move it. Press and hold the device, drag it up or down, and drop it where you want it. The list previews the new position as you move, and the order is saved as soon as you let go.

This is how you keep related devices together, such as the left and right halves of a stereo pair, or every device on one floor. If Loft Left and Loft Right were discovered at opposite ends of the list, drag one so it sits directly above the other.

  • Where a device can go. A device stays inside its own device-type group while you drag it, so a HEOS device cannot be dropped in among your Sonos devices. When only one device type is connected there are no headers, the list is flat, and a device can be dropped anywhere in it. With Group players by room on, a device also stays inside its own room; move it between rooms with Assign to room... instead.
  • Reordering the headers. The order of the groups themselves is separate. See the two sections below.
  • The Groups tab is separate too. The device list in the Groups tab keeps its own order.
  • Where it is kept. Your order is saved automatically and restored the next time you open Audio Hero. With cloud sync enabled it follows you to your other PCs.
Group players by device type (on by default)

Shows one header per ecosystem (HEOS, Sonos, Google Cast, Onkyo, and so on). Headers appear only when more than one device type is connected; with a single type the list stays flat.

  • Collapse or expand. Click a header to fold its devices away. The arrow flips to show the state.
  • Reorder. Drag a header by its ☰ handle to change the order of the groups. You can also right-click a header for Move to top and Move to bottom.
  • Rename a header. Right-click a header and choose Rename to give the group a custom local label. This relabels the header only; the devices are untouched. Leave it blank to restore the default name.
  • Hide a whole group. Right-click a header and choose Hide entire group to tuck every device in it away at once. Reveal hidden devices again with the binoculars icon at the bottom of the list.

Turn this switch off to keep a single flat list even when several ecosystems are connected.

Group players by room (off by default)

Organize devices under rooms you name yourself, such as Office or Bedroom. Turn on Group players by room to switch the list to room headers, then assign your devices. Until your devices span more than one room (an assigned room plus the Unassigned group counts), the list stays flat.

  • Assign a device. Right-click a device and choose Assign to room..., then pick an existing room or type a new name. This item appears only while room grouping is on.
  • Remove a device. Right-click a device that is in a room and choose Remove from room. It returns to the Unassigned group.
  • Manage rooms. Click Manage rooms... under the switch to create, rename, or delete rooms. Renaming a room updates every device in it; deleting a room leaves its devices Unassigned.
  • Unassigned devices. Devices without a room collect under a single Unassigned header at the bottom of the list.
  • Order and folding. Rooms appear in the order you set in Manage rooms, with Unassigned always last. Click any room header to collapse or expand it.
Using both together (rooms with device types nested)

With both switches on, rooms become the outer grouping and device types nest inside each room. For example, an Office room can contain a HEOS group and a Sonos group. This is handy when one room holds speakers from more than one ecosystem.

Your device order, grouping choices, room names, and per-device room assignments are saved with your settings and, with cloud sync enabled, follow you to your other PCs.
Right side: Now Playing, transport, sources

3. Playback controls

Transport buttons
ButtonAction
โฎ PreviousSkip to the previous track. Also moves backward in a local-file queue.
โ–ถ / โธ Play / PauseToggles playback on the selected player.
โน StopStops the current stream. For internet radio this fully closes the stream; for queued audio it stops playback without clearing the queue.
โญ NextSkip to the next track.
๐Ÿ” RepeatCycles through Off, Repeat All, and Repeat One. The button opacity reflects the current mode.
๐Ÿ”€ ShuffleToggles shuffle on or off. Greyed-out when the source does not support shuffling.
๐Ÿ‘ Thumbs UpSends a thumbs-up to the music service when supported, and is also remembered locally as your personal rating for the track.
๐Ÿ‘Ž Thumbs DownSends a thumbs-down. When Always skip thumbs-down items is enabled, the track is also skipped immediately.

Local thumbs-up/thumbs-down votes are stored per track in settings.json using an "artist|title|album" key, capped at 5000 entries with oldest entries removed first.

Timeline scrubber and live streams

The timeline area shows one of two layouts depending on the source:

Repeat, shuffle, and the active source

Repeat and shuffle commands are forwarded to the connected HEOS player. Some streaming services (notably radio-style services such as Pandora and SiriusXM) do not support these commands; Audio Hero greys out the relevant buttons when the active source rejects them.

The Queue tab New

The panel below Now Playing now has three tabs: Music Sources, Queue, and Search. The Queue tab shows what is lined up to play next. What it shows depends on the source:

For a local-file queue (a Pro feature, like local playback itself) the Queue tab is fully editable:

Your local-file queue is remembered between launches, and with an Audio Hero Companion it can keep playing after you close Audio Hero. See Local file playback.

4. Volume and presets

Which volume controls are Free and which are Pro
ControlEdition
Master volume slider, mute, volume up / down buttons, โ†‘ / โ†“ keysFree
Zone selector (All / Z1 / Z2 / Z3) on multi-zone Denon / Marantz AVRs, and the selected zone's volume through the main sliderFree
Volume and mute on every supported device family (Sonos, MusicCast zones, Onkyo, Chromecast, DLNA, and so on) through the main sliderFree
Snapcast client volume, mute, and per-client latencyFree
Typing an exact volume in the % boxPro
Limit max volume (one cap for all devices, or a separate cap per device)Pro
Six volume presets (full, compact, and ultra-compact views)Pro
Zone mute, zone power, zone input, all-zone power, and zone renaming (inside the receiver panel)Pro
Per-member volume, Match volume, and Lock volume in a groupPro
Master volume and mute Free
Limit max volume Pro

To prevent accidental ear-splitting jumps, you can cap the slider at any value between 1 and 99 percent.

  1. Enable Limit max volume.
  2. Click the Max NN% pill that appears.
  3. Drag the popup slider to set the ceiling. The main slider can never exceed it.

The cap applies to whichever receiver zone the slider is controlling. By default Audio Hero remembers a separate cap for each device; turn off Use a separate max-volume limit for each device in Settings to use one cap everywhere.

Volume presets Pro

Six preset slots let you jump to a stored volume with a single click. They sit just below the volume slider, arranged in a compact grid.

Presets are stored in settings.json and persist across launches.

Multi-zone receivers Free

When connected to a Denon or Marantz AVR that has Zone 2 or Zone 3 powered on, an extra control bar appears below the slider:

If you do not see the zone bar: it only appears while Zone 2 or Zone 3 is actually powered on. Audio Hero checks the receiver's zone power state every few seconds, so the bar shows up on its own once the zone is on, and disappears when the zone goes back to standby. Turn the zone on with the receiver's remote, its front panel, or the HEOS app, and the bar appears within a few seconds. Turning a zone on or off from inside Audio Hero is done in the receiver panel, which is a Pro feature.

Free vs Pro. The zone selector and zone volume through the main slider do not need Pro. Zone mute, zone power, zone input selection, all-zone power, and zone renaming live in the receiver panel, which is a Pro feature. The max-volume cap (Pro) applies to whichever zone is selected.

5. Music sources and browsing

What appears in the sources list

The Music Sources column shows supported sources HEOS exposes on the connected device, plus several sources Audio Hero adds of its own:

Hide unsigned music services (enabled by default) hides paid services you haven't signed into. Free sources and built-in inputs are always shown. To sign in to a service, use the official HEOS app on your phone, then refresh in Audio Hero.
Browsing into a source

Audio Hero uses a Finder-style column view. Click a source to open the first browse column, then keep clicking to drill into folders, playlists, albums, or stations.

Reordering sources

The sources list defaults to the order returned by HEOS, with the synthetic Starred favorites and Internet Radio pinned near the top.

The Music source order setting on the Settings tab controls how that order is remembered:

Changing this setting re-sorts the list right away. Your existing order carries over as the starting point until you rearrange a particular device type or device.
HEOS account sign-in

To use services like Spotify or Tidal you must be signed into a HEOS account on your device. Manage that sign-in from Settings → Device accounts → Manage device accounts.

Streaming YouTube Music and Apple Music

Audio Hero adds two sources, YouTube Music and Apple Music, that play those web services on your speaker even though neither is a native service on it. Audio Hero opens the service in a built-in browser window, captures the audio on your PC, and streams it to the selected device over your LAN. This works on HEOS devices and on most other supported speakers (Sonos, Google Cast, Onkyo, AirPlay, DLNA, and more).

  1. Click the YouTube Music or Apple Music source.
  2. Click the row to start. The embedded player window opens; sign in the first time, and your session is remembered after that.
  3. Press Play inside the player window. Audio Hero waits until there is audio, then switches your device over, so whatever was already playing keeps going until the stream is ready.
  4. Click the source row again to stop streaming.
Both are free to use. Playback runs through each service's own web player, so what you can reach depends on your own account with that service. This normally runs on the PC running Audio Hero; you can offload the browser and audio to another PC, see the Audio Hero Companion section below.
Device + This PC: play on your speaker and PC together

The Device + This PC source plays a web music service on your computer and your speaker at the same time, kept roughly in sync. (Earlier versions called this HEOS + PC; it was renamed because it now works across device families, not just HEOS.) Open it to choose from the supported services: YouTube Music, Apple Music, Amazon Music, Pandora, Tidal, Qobuz, Deezer, SiriusXM, Spotify, iHeartRadio, TuneIn, SoundCloud, Bandcamp, Mixcloud, Radio Paradise, and Audiomack. New SoundCloud, Bandcamp, Mixcloud, Radio Paradise, and Audiomack are recent additions.

Device + This PC is free. Each service plays through its own web player, using your own account with that service.
PC Line Out: broadcast everything your PC plays New

The PC Line Out source sends your PC's entire sound output to the selected device, exactly as if you had run a cable from the PC's line-out jack to the speaker. Whatever is playing on the PC - a browser tab, a desktop music app, a game, a video call - comes out of the device.

PC Line Out is free. Like all network streaming there is a short delay between the PC and the device, so it suits music and long-form audio better than lip-synced video.

6. Audio Hero Companion New

The web-music and PC-audio sources (YouTube Music, Apple Music, and Device + This PC) work by running a hidden web browser and capturing its audio, then streaming that audio to your speaker over your network. By default this happens on the same PC that runs Audio Hero. The Audio Hero Companion lets you move all of that onto another always-on PC instead, so your main PC stays light and the music can keep playing even after you close Audio Hero. It can also own compatible scheduled automations and let you manage them directly on the Companion PC.

What the Companion is, and why use one

The Companion is the same streaming engine that ships inside Audio Hero, packaged to run on its own on a second PC. With a Companion, that other PC runs the browser and audio capture and serves the stream to your speaker, while Audio Hero on your main PC just controls it. Reasons to use one:

The link between your PC and the Companion is encrypted (TLS). By default no code is needed: any Audio Hero on your network can find and use a Companion. For extra security you can require a 4-digit PIN on both ends. Nothing leaves your local network. While a source plays through a Companion, the Now Playing header shows · via Companion on <name>.

What can run through a Companion

The Companion handles the sources Audio Hero streams from your PC rather than the ones the speaker plays for itself:

Native device sources (a speaker's own Spotify, Tidal, Pandora, favorites, and physical inputs) are played by the speaker itself and do not go through the Companion.

"(Companion)" sources: play a web service to the device only New

While a Companion on another PC is connected, its web music services also appear as their own top-level entries in the Music Sources list, named "<service> (Companion)" - for example Pandora (Companion) or Tidal (Companion). These play the service straight to the selected device, with the Companion PC itself kept silent.

Different music on different speakers, and multiple people at once

One Companion can serve several streams at the same time. From one Audio Hero you can play a different source to each speaker: pick a speaker and start YouTube Music, then pick another speaker and start Internet Radio or Spotify; each keeps playing independently. YouTube Music can even run more than once, so two speakers can play two different YouTube Music songs from the same PC: select the second speaker and start YouTube Music again, and a second player window opens for it. Selecting a speaker in the sidebar shows and controls the music playing on that speaker. The exceptions are Apple Music and Device + This PC, which record the Companion PC's sound output; a PC has only one sound output, so only one of those can run per Companion at a time.

Several household members can also use the same Companion at once, each from their own PC with the same PIN. Everyone controls their own music, and each person's music-service sign-ins are kept in their own browser profile on the Companion, so two people can even stream the same service with different accounts. If someone else's music is already playing on a speaker, starting music there from another PC is politely refused with a message naming who is using it; pick another speaker or ask them to stop first.

Local files that keep playing after Audio Hero closes New

When you play local files or a folder Pro to a HEOS speaker through a Companion, the Companion copies each file it needs and streams from its own copy. Because the Companion is a standing server, that queue keeps playing, and keeps advancing to the next track, even after you close Audio Hero on your main PC. When you reopen Audio Hero it re-adopts the running queue and shows it again.

Smart devices on a Companion New

A Companion does more than stream music. Once one is connected, it takes over your smart plugs completely and becomes the only thing that switches them. The point is simple: the Companion is a PC that is meant to be on anyway, so your plug rules keep working when your own PC is asleep, shut down, or simply not running Audio Hero.

Nothing to set up. Audio Hero sends the Companion your plug rules automatically as soon as it connects, and re-sends them whenever you change one. If you have no Companion, or an older one, everything keeps working from Audio Hero exactly as it did before.

What the Companion takes over

Which speakers a Companion can follow

The Companion has to be able to see what a device is doing before a plug can follow it. Between them, these cover the great majority of setups:

Not covered: Google Cast, Amazon Echo, the kiosk targets, Snapcast and Squeezelite. Plugs linked to these still follow playback normally while Audio Hero is open on your PC; they simply do not carry on once you close it.

Onkyo and Integra receivers

These receivers only accept one control connection at a time, which is why they used to be left out. They are now handled by passing that single connection back and forth: while Audio Hero is running it holds the connection as before and tells the Companion what the receiver is doing. When you close Audio Hero, the Companion picks the connection up a few seconds later and watches the receiver itself. Open Audio Hero again and it takes the connection back. Nothing to configure, and the two never fight over it.

If the Companion PC sleeps

A scheduled action can only fire if the PC is awake at the time. Three settings decide what happens, and all three can be changed from either the Companion's own window or from Audio Hero on any PC, on the Settings tab under Audio Hero Companion. Change one in either place and it updates in the other straight away.

Neither wake timers nor keep-awake can help a Companion PC that is fully powered off rather than asleep. Nothing can wake it, so scheduled actions wait until you next switch it on, and then run if the missed-actions setting is on and they are less than a day late.

Checking what the Companion holds

On the Companion PC, open its window and click Rules stored here under Smart devices. It lists every rule it has been given, which PC sent it, and what it last did. Follow rules remain read-only, but scheduled automations can now be managed here. See Manage automations from the Companion.

The Companion switches plugs over your local network, so the plug has to be reachable from the Companion PC. If your plugs sit on a separate network or VLAN that the Companion PC cannot reach, leave the Companion out of it and let Audio Hero switch them from a PC that can.
Manage automations from the Companion New

An up-to-date Companion can own compatible scheduled automations for HEOS, Sonos, Onkyo / Integra, DLNA, Yamaha MusicCast, WiiM, Bluesound, and smart plugs. Audio Hero sends each eligible automation to the Companion automatically. It then runs on the Companion PC at the scheduled time, even when Audio Hero is closed and your main PC is off.

To manage these automations on the Companion PC:

  1. Double-click the Companion tray icon, or right-click it and choose Settings.
  2. Under Smart devices, click Rules stored here.
  3. Use the buttons beside a scheduled automation: Run now, Disable or Enable, Edit, and Delete.

Changes made here take effect on the Companion immediately and are saved until the owning Audio Hero reconnects. Audio Hero then applies the same change to its automation list. To change the automation's name, target device, action, source, volume, or seasonal date range, edit it in Audio Hero.

Only automations the Companion can execute by itself are handed over. If an action or source needs Audio Hero's own playback machinery, Audio Hero keeps its Windows scheduled task instead. A circled Companion icon beside an automation shows that the Companion owns it.
Install the standalone Companion

For a PC that should stream music but not run the full Audio Hero app (a home server, a headless mini PC), install the small standalone Audio Hero Companion. It is a free, open-source download with its own repository: Audio Hero Companion on GitHub.

Requirements

Install it

  1. On the companion PC, download the latest installer from the Audio Hero Companion releases page (the file name includes the version, for example AudioHeroCompanionSetup-2.3.0.exe).
  2. Run the installer. It asks whether the companion should start with Windows and whether it should keep itself up to date automatically; both are recommended and on by default. It installs per-user (no admin rights needed for the app itself). During this first install, Windows shows one admin approval prompt: that is Setup adding the Windows Firewall rule. Updates never show it again.
  3. That is it, there is nothing to set up. The companion starts and sits in the system tray (grey when idle, green while playing), and any Audio Hero on your network can find and use it.
  4. Optional: double-click the tray icon, or right-click and choose Settings, to name the device, require a 4-digit PIN for extra security, toggle run-at-startup, choose whether to keep copied local music, or stop playback.

Keeping the companion up to date

The companion keeps itself current: it checks the releases page every few hours and, when a new version is out, downloads it and installs it silently the next time nothing is playing and no PC is connected. No prompts appear and nobody needs to be at the PC; the companion restarts itself on the new version. Both behaviours are on by default and can be turned off in the companion's settings window (Automatically check for updates and Install updates automatically when the companion is idle). With automatic installs off, the tray icon shows a notification instead and the settings window links to the download.

Running on a dedicated PC nobody logs in to

The companion runs inside a signed-in Windows session (it starts at logon, not at boot). For a home server or headless mini PC, turn on automatic sign-in so the companion comes up by itself after every reboot:

  1. On the companion PC, press Win+R, run netplwiz, select the account, and untick Users must enter a user name and password to use this computer. If that checkbox is hidden on Windows 11, use Microsoft's Sysinternals Autologon tool instead.
  2. Reboot to confirm Windows signs in and the companion appears in the tray on its own.
  3. You can leave the PC at the lock screen (Win+L); the companion keeps streaming and keeps updating itself while locked.
The standalone companion has no music controls of its own; you drive everything from Audio Hero on your main PC.
Connecting your main PC to the Companion

Once a Companion is running, point Audio Hero at it:

  1. On your main PC, open Audio Hero, then the Settings tab, then Audio Hero Companion.
  2. Turn on Run the Companion on another PC.
  3. Click Find Companion running on this network, then click yours under Companions found on your network. If it is not listed (some mesh Wi-Fi and VLAN setups block the discovery beacon), type its address by hand into Companion address as companion-ip:47708.
  4. If you set a PIN on the Companion, enter the same 4-digit PIN here.
  5. Click Test connection. You want to see Connected to the Companion.
  6. Optionally turn on If the other PC is unreachable, run on this PC instead so web music still works when the Companion is off.
  7. Optionally choose which sources use the Companion; the rest keep running on your main PC.

Now play YouTube Music, Apple Music, or Device + This PC as usual. The browser and audio work happen on the Companion, and the Now Playing header shows · via Companion on <name>.

Companion source badges New

Once a Companion is set up, every source that is configured to run through it shows a small badge next to its name in the Music Sources list. Hover the badge to confirm: This source is configured to play through the Audio Hero Companion on another PC. It is a quick way to see, at a glance, which sources will use the Companion and which play on the device directly. Choose which sources use the Companion in Settings → Audio Hero Companion.

Signing in to music services on the Companion

Because the web player runs on the Companion PC, sign-ins need to happen there. Audio Hero makes this seamless with a sign-in mirror: when a service needs you to log in, the Companion streams its sign-in page to your main PC, you sign in with your own mouse and keyboard, and the login is saved on the Companion. You never have to sit at the Companion PC.

Keeping the Companion running, and troubleshooting
Everything stays on your local network and the connection is always encrypted. By default any Audio Hero on your network can use the Companion; turn on a 4-digit PIN (on both ends) to limit that. A PIN is never sent over the network or uploaded. The Companion can also keep a linked smart plug following your HEOS playback while Audio Hero is closed.

7. Home Assistant New

Audio Hero can tell Home Assistant what your speakers are doing. Once it is switched on, every speaker Audio Hero knows about appears in Home Assistant on its own, showing whether it is playing, whether it is powered on, what is playing right now, and whether Audio Hero is the one driving it. You can then use those in Home Assistant dashboards, automations, and voice assistants, from any device Home Assistant runs on.

This is a one-way view: Home Assistant sees your speakers, it does not control them. Playback is still driven from Audio Hero, or from the speaker's own app. Everything travels over your local network, and the feature is off until you turn it on.

What you need first

Audio Hero talks to Home Assistant through an MQTT broker, which is the standard way for other programs to feed information into Home Assistant. If you already use MQTT, use your existing broker and skip to the next part. If not, Home Assistant can run one for you:

  1. In Home Assistant, open Settings → Apps (called Add-ons in versions before 2026.2), then the store, and install Mosquitto broker. Start it, and turn on Start on boot.
  2. Open Settings → People and add a user for Audio Hero, for example username audiohero, with a password you choose. Mosquitto signs Audio Hero in with a normal Home Assistant user account.
    • Leave Administrator off. Audio Hero never needs it.
    • Leave Local access only on, since Audio Hero connects from your own network.
    • Give it a proper password. It is stored on the PC or Companion that publishes, and any device on your network can try the broker.
  3. Go to Settings → Devices & services. Home Assistant should offer a discovered MQTT integration; click Configure and accept it.
Home Assistant renamed Add-ons to Apps in version 2026.2. If your Home Assistant has no Apps or Add-ons entry at all, it is running in a mode that cannot install them (Container or Core). You can still use this feature, but you will need to run an MQTT broker yourself and add the MQTT integration by hand.
Switching it on in Audio Hero
  1. Open the Settings tab in the sidebar and choose Home Assistant.
  2. Tick Publish speaker state to Home Assistant.
  3. Click Detect next to the broker address. Audio Hero looks for your Home Assistant machine on the network and fills the address in. If nothing is found, type the address by hand; automatic detection cannot cross between separate network ranges.
  4. Leave the port at 1883 unless you changed it in your broker.
  5. Enter the username and password of the Home Assistant user you made. Leave both empty only if your broker allows anonymous connections.

The line at the bottom of the section tells you what is happening: which broker is being published to, and which machine is doing the publishing. Your speakers should appear in Home Assistant within a few seconds, under Settings → Devices & services → MQTT.

Nothing needs to be set up on the Home Assistant side beyond the broker. Audio Hero announces each speaker to Home Assistant automatically, including its room, so devices land in the right area when you have already given them rooms in Audio Hero.
What you see in Home Assistant

Each speaker becomes one device in Home Assistant, named as it is named in Audio Hero, with three entities:

EntityWhat it tells you
PlayingOn while the speaker is playing anything, whatever the source.
Now PlayingThe current song title. Artist, album, source, album art, position, duration, power, room, and group role are attached as attributes.
Driven by Audio HeroOn only while Audio Hero itself is feeding that speaker (YouTube Music, Apple Music, local files, internet radio, and so on). Off when the speaker plays one of its own sources, such as its built-in Spotify or a HEOS favorite.

That last one is the piece that settles the confusion of running Audio Hero alongside your own Home Assistant automations: it tells them, at a glance, whether Audio Hero is currently in charge of a speaker.

Publishing from the Companion, or from your PC

If you use an Audio Hero Companion, it is the natural place to publish from: it is meant to be on all the time, so Home Assistant keeps seeing your speakers even when your own PC is asleep or Audio Hero is closed.

You do not have to think about which one is publishing. The Home Assistant settings section always edits the right thing:

When you use a Companion, one extra choice appears: If the Companion is off, keep publishing from this PC. Turn it on and Audio Hero takes over within seconds of the Companion going offline, then quietly hands back when it returns. Home Assistant sees no difference, because both publish under the same names. Turn this on for one PC only; it is a per-PC setting and is never synced between your PCs.

The broker address and sign-in you enter for the Companion are remembered on your PC as well, so that takeover works without you entering them twice.
Using it in Home Assistant

Everything Audio Hero publishes is ordinary Home Assistant data, so it works anywhere entities work: dashboard cards, automation triggers and conditions, history, and voice assistants.

A few things this is commonly used for:

Home Assistant's own HEOS integration keeps working exactly as before, and the two do not conflict. Audio Hero adds a separate set of devices carrying information the speakers alone cannot report, above all whether Audio Hero is driving them and what is playing when it is.
If nothing appears in Home Assistant
Searching across HEOS services

Open the Search tab in the panel below Now Playing (next to Music Sources and Queue).

  1. Type at least two characters into the search box.
  2. Pick a category: Artist, Album, Track, or Station.
  3. Press Enter or click Search.

Audio Hero fans the query out to every signed-in HEOS service in parallel, and also searches YouTube Music and Apple Music. Results are grouped per service and each group can be expanded or collapsed. Click any result to play it on the active player.

Coverage: Search covers built-in HEOS services that publish a search API, plus YouTube Music and Apple Music (queried through their web players). Some services - Pandora, Spotify, SiriusXM, Amazon Music, and Favorites - do not expose a search API and are skipped per the HEOS specification.

9. Starred favorites

Your personal cross-service favorites list

The Starred favorites list is your own quick-access library, stored locally and independent of any single music service. It appears in the Music Sources browser for every supported audio device.

Favorites are saved to settings.json with their originating device, ecosystem, and room, plus enough playback context to replay the same browse or play command later. Sonos favorites retain their ContentDirectory object ID, playback URI, and DIDL metadata. Favorites created by older Audio Hero versions have no originating-device metadata and remain visible in every scope.

When By room or Global combines ecosystems, Audio Hero shows portable sources such as saved internet radio everywhere but keeps device-native catalog entries with compatible devices. For example, a Sonos playlist appears on Sonos, while a HEOS-service playlist appears on HEOS.

10. Internet radio

Adding and playing custom streams

Audio Hero adds a synthetic Internet Radio source to your sources list. From it you can manage a personal collection of direct stream URLs that any HEOS device can play.

  1. Open the Internet Radio source.
  2. Click + Add stream at the top of the column.
  3. Fill in:
    • Station name (required, up to 120 characters)
    • Stream URL (required, http:// or https://)
    • Artwork URL (optional)
  4. Click Save. The station appears in the list and can be played, edited, or reordered.

Audio Hero ships with a small set of seeded stations (Andon FM AI broadcasts). If you delete one of the defaults it stays deleted.

Browsing the public catalog

Click Browse catalog... in the stream editor to open the catalog browser:

Live track metadata for radio streams

When a stream supports the ICY (Shoutcast / Icecast) metadata standard, Audio Hero polls the stream's inline metadata about every 20 seconds and updates the now-playing display with the current track and artist. If the stream does not advertise ICY metadata, the static station name is shown instead.

11. Local file playback Pro

Playing files from your PC

Audio Hero can stream audio files from your computer to your speakers without uploading them anywhere. A tiny embedded HTTP server on your PC serves each file to the device over your LAN. Open the Local Music (Your PC) source in the Music Sources column to get started.

With an Audio Hero Companion on another PC, a local-file queue played to a HEOS speaker keeps playing and advancing even after you close Audio Hero. See Local files that keep playing after Audio Hero closes.
Tags and album art

Audio Hero reads embedded tags from each file:

If tags are missing, Audio Hero tries to parse the filename (for example "Artist - Title.mp3") and falls back to the parent folder name. If all else fails, the filename itself is shown as the title.

Security of the local HTTP server

12. Groups and multi-room Pro

What is a group?

A group is a saved set of two or more devices that should play the same music. Audio Hero chooses the best playback method for the devices in that group:

You can have several groups and play a different source on each one at the same time. A device can belong to only one group. Every group receives a color, and all of its members show a matching colored G badge in the Players tab.

The Groups tab, and everything in it, is a Pro feature: creating, changing, and removing groups, playing a source to a group, per-member volume, Match volume, and Lock volume. In Free the tab is shown behind a lock badge, and choosing a music source always plays it on the single selected device.

Live groups and saved restore shortcuts New

The two kinds of group are remembered in different ways, and the difference matters:

Select the small disk on any group card to save its leader and device list as a restore shortcut. Saved groups appear below Create group. Select Restore to form the saved group again. This works for same-system and mixed-device groups.

A group you made outside Audio Hero appears with the same per-member volume sliders, Lock volume and Match volume as one you made here. Its × breaks up the real group on your speakers, while its disk saves a reusable shortcut.
The group leader New

Every group has one device doing the actual work: on a same-system group it is the speaker the others are following, and on a mixed group it is the device Audio Hero is streaming from. Audio Hero calls this the leader and marks it in three places:

You do not have to do anything with this; it is there so you can tell at a glance which speaker the group is following. Choosing a music source while a group member is selected sends it to the whole group either way.

Creating a group
  1. Open the Groups tab in the sidebar.
  2. Check every device that should play together. The device list shows each device's ecosystem name or logo and a matching outline color.
  3. Read the preview below the list. It tells you whether the selected devices can use their own tight synchronization or will form a mixed-device group.
  4. Click Create group. At least two devices must be checked.

Audio Hero picks the group's leader for you. If one of the checked devices is already playing, the first playing device you checked leads. Otherwise, the first device checked is used. The leader is shown in bold at the top of the group card.

A same-system HEOS or Sonos group is synchronized as soon as you create it. If its leader was already playing, the other members join that playback. A mixed-device group starts playing together the next time you start a supported source from any member.

Put the devices in the order you want New

The device list in the Groups tab has its own order, separate from the Players list. Drag any device by its ☰ handle, move it up or down, and drop it where you want it. The list previews the new position as you move, and the order is saved as soon as you let go. You can also right-click a device for Move to Top and Move to Bottom.

Playing through a group

After creating a group, return to the Players tab and select any member. The colored G badge makes members of the same group easy to identify.

Starting a supported Audio Hero stream from any mixed-group member sends it to the complete group. Normal transport controls apply to the group playback, and stopping it stops the stream on all members.

Mixed-group limitation: music pulled directly by one device, Spotify Connect, and physical inputs such as HDMI, AUX, phono, or TV audio cannot be copied to other ecosystems. Use an Audio Hero PC or web source when different device types need to play together.
Group cards, volume controls, and colored badges

Your groups appear under Your groups at the top of the Groups tab, including any made outside Audio Hero. Each card lists its members, with the leader in bold at the top.

Updating, moving devices, and deleting groups
Device group capabilities

Tight sync is available when every member uses the same supported native grouping system. Mixed group means the device can receive Audio Hero's multi-device stream playback.

Device typeTight syncMixed group
HEOSYesYes
SonosYesYes
Chromecast / Google CastUse an existing Google Home speaker group as one deviceYes
Onkyo / IntegraNoYes
Yamaha MusicCastNoYes
DLNA / UPnPNoYes
AirPlay / AirPlay 2NoYes
RokuNoYes (needs Media Assistant)
SnapcastNoYes
Squeezelite / LMSNoYes
Samsung WAMNoYes
SendspinNoYes
WiiM / LinkPlayNoYes
Bluesound / BluOSNoYes
moOde AudioNoYes
Fully Kiosk / Dashie KioskNoYes
Universal disc playersNoNo
Legacy Denon / Marantz volume-only devicesNoNo

13. Receiver controls (AVR) Pro

Opening the receiver panel

When the selected player is a HEOS-equipped Denon or Marantz AVR (for example AVR-X series, AVR-S series, AVC series, or the Marantz Cinema range), a gear icon โš™ appears next to that player in the sidebar. Click it to open the inline Device Controls panel.

Audio Hero queries the AVR over a short-lived telnet connection (port 23) to detect which features it supports, then shows only the controls that work for that specific model.

What needs Pro here. Opening this panel, and every control inside it, is a Pro feature, as is the receiver's power button in the Players list. You do not need Pro to play, pause, and change sources on the receiver, to pick a zone and set its volume from the main volume slider (see Multi-zone receivers), or to rename and reboot it.
Main Zone controls
Tone, levels, and channels
Audyssey and surround parameters
System and tuner
Multi-zone controls
Renaming and rebooting

14. HEOS amp controls

What this panel does

For HEOS integrated amps (Denon PMA-900HNE, HEOS Link, HEOS Drive, and similar), Audio Hero offers a simplified control panel. The panel itself is Free; only the power toggle needs Pro.

Unlike full AVRs, HEOS amps do not expose Audyssey, surround modes, or multi-zone control over the network, and those sections are intentionally absent.

Cross-room input sourcing Pro

You can send the audio from one HEOS amp's input to another speaker. Right-click any HEOS amp in the Players list and choose Send input to another speaker, then pick the destination. This is useful for routing a turntable to a kitchen speaker, for example. Sending an input to another speaker is a Pro feature; playing an input on the device it belongs to is Free.

15. Legacy device support

What "legacy" means here

"Legacy" refers to pre-HEOS Denon and Marantz network devices: CEOL Piccolo, M-CR series, older AVRs that pre-date HEOS firmware, and similar HTTP-controlled receivers. They cannot stream from HEOS music services, but they do accept volume, mute, power, and input commands.

Audio Hero treats these as volume-only companion devices. The main playback stays on your HEOS speaker; the legacy device follows along in volume and power.

Enabling legacy support
  1. Open the Settings tab.
  2. Enable Include support for legacy HEOS devices.
  3. Open the Players tab and click Discover Devices. Legacy SSDP discovery probes for MediaRenderer devices, filters to Denon and Marantz, and verifies each one responds to the legacy HTTP API.
  4. Or add a device by IP using the Or add a legacy Denon/Marantz device by IP field that appears.
The legacy device settings panel

Click the โš™ gear on a legacy device in the sidebar to open its settings panel:

Writes go over HTTP (port 8080 with port 80 as a fallback) so the device does not need telnet enabled. Status polling uses non-waking endpoints so the receiver is not woken from standby just to read its status.

16. Additional device support New

Fully supported devices

Three non-HEOS device families are fully supported and held to the same standard as HEOS itself: Sonos, Roku, and Onkyo / Integra. They are stable, actively maintained, and safe to rely on day to day. Like every non-HEOS family they are optional and off by default; turn them on from Settings › Audio device support selection, then run Discover Devices.

Smart plugs and smart devices (Kasa, Shelly) New

Audio Hero can discover and switch smart plugs on your local network and link one or more to a player, so each device can follow what the player is doing. The classic use is a subwoofer, amplifier, or lamp on a smart plug that you want powered only while a speaker is actually playing. TP-Link Kasa and Shelly plugs are supported. Everything is local: no cloud account and no internet are involved.

Follow the player automatically. A linked plug can follow the player in two ways, set per plug from either the Smart plugs window or the player's gear panel. You can switch on either one or both:

When Audio Hero is closed. If a Windows Audio Hero Companion is configured and running, Audio Hero hands it the whole set of plug rules and the Companion takes over: it becomes the only thing that switches your plugs, and it keeps doing so with every copy of Audio Hero shut. That covers Follow playback, Follow power, and scheduled plug automations, across every ecosystem the Companion can watch. See Smart devices on a Companion for exactly which devices that is and what happens when the Companion PC sleeps.

Because the Companion becomes the single switch, pressing a plug's on / off button in Audio Hero asks the Companion to do it rather than doing it directly. That is not about network reach; it is what stops a running idle-off countdown from quietly undoing a plug you just switched on by hand. If no Companion is configured, or it is an older version, Audio Hero simply keeps switching plugs itself exactly as before.

Using both together. The two options are built to combine into a single rule rather than fight each other: the plug is on while the player is powered on or playing, and it switches off when the player powers off, or after the idle delay once playback stops. Step by step:

Because of that idle-off step, a player left powered on but silent past the delay will keep the plug off until playback resumes (or you switch it on by hand). If you would rather the plug mirror the player's power exactly and ignore silences, use Follow power on its own. If the player has no power button at all (most HEOS speakers, Sonos, Chromecast), use Follow playback on its own, since there is no power signal for Follow power to track.

Automations. A smart plug can also be the target of a scheduled automation: pick the plug under Smart plugs in the automation's device list and choose Power on or Power off to switch it at a set time on the days you choose. With a Companion running, these are handed to it and fire from that PC, so they no longer depend on this PC being awake. See Smart devices on a Companion.

Sonos

Discovers and controls Sonos players on your local network. Audio Hero can play its own audio (local files, internet radio, and the PC / web-music sources) to a Sonos speaker and control play / pause / stop, next / previous, volume, and mute.

Roku

Discovers Roku devices (Roku TVs, streaming sticks and boxes, and Roku-powered soundbars) and gives each a full on-screen remote: power, volume, transport, and on-screen navigation, over Roku's local network protocol.

Onkyo and Integra

Discovers and controls Onkyo and Integra AV receivers over the local eISCP network protocol, giving each AVR a full control panel. Audio Hero can also stream its own audio (local files, internet radio, and the PC / web-music sources) to the receiver.

What "experimental" means here

Beyond HEOS, Audio Hero can also control several other kinds of network audio devices. These are marked experimental: they are off by default, still being refined, and may be incomplete or change between releases. Turn on only the ones you use.

The experimental device families are Chromecast / Google Cast, DLNA / UPnP renderers, AirPlay and AirPlay 2, Yamaha MusicCast, Snapcast, Sendspin, Squeezelite (Logitech / Lyrion Media Server), Universal disc players (Oppo-style), Samsung Wireless Audio (WAM), WiiM (LinkPlay), Bluesound (BluOS), moOde Audio, and Fully Kiosk and Dashie Kiosk tablets. Each appears in the Players list next to your HEOS devices, with its own โš™ gear settings and a power button.

Turning experimental device support on
  1. Open the Settings tab and click Audio device support selection.
  2. Tick the device families you want. Each has a short description of what it does and any limitations.
  3. Close the dialog, open the Players tab, and click Discover Devices. Newly enabled devices appear in the list.

Power buttons behave per platform. Some devices expose a real network power command (Onkyo / Integra receivers, MusicCast zones, Roku TVs, Squeezelite players, Universal disc players, and the screen on / off on Fully Kiosk and Dashie Kiosk tablets). Some have no standby, so the button instead stops playback (DLNA, AirPlay) or toggles a soft on / off (Snapcast clients). The rest have no power-off at all and show the button greyed out for visual consistency (Sonos, Chromecast, Sendspin, Samsung WAM, WiiM, and Bluesound). The โš™ gear opens a per-device panel for volume, mute, and renaming, plus a fuller set of controls on receivers.

Chromecast and Google Cast

Discovers Chromecast and Google Cast devices and plays Audio Hero's own audio (local files, internet radio, and the PC / web-music sources) to them. Existing Google Cast speaker groups show up as devices you can play to, so you can target a whole group at once.

DLNA and UPnP renderers

Discovers generic DLNA / UPnP MediaRenderer devices (network speakers, AV receivers, smart TVs, and software renderers) and plays Audio Hero's own audio (local files, internet radio, and the PC / web-music sources) to them over standard UPnP.

AirPlay and AirPlay 2

Discovers AirPlay and AirPlay 2 receivers (AirPort Express, AirPlay AVRs and speakers, HomePods) and streams Audio Hero's audio (local files, internet radio, and the PC / web-music sources) to them as a real-time AirPlay stream.

Yamaha MusicCast

Discovers Yamaha MusicCast devices (network speakers, sound bars, and MusicCast AV receivers) and controls each advertised zone over the local Yamaha network API. Audio Hero can also stream its own audio (local files, internet radio, and the PC / web-music sources) to them over UPnP.

Snapcast

Discovers Snapcast servers over mDNS and lists each server's clients as devices you can control over the Snapcast JSON-RPC interface.

Sendspin

Discovers Sendspin devices (Open Home Foundation synchronized multi-room audio) over mDNS and lists each as a device you can play to. Audio Hero acts as the Sendspin server and pushes its own audio (local files, internet radio, and the PC / web-music sources) to them over WebSocket as PCM.

Squeezelite (Logitech / Lyrion Media Server)

Connects to your Logitech / Lyrion Media Server (LMS) and lists every player it manages (headless squeezelite instances, Squeezebox hardware, piCorePlayer, and so on), each with its own gear settings and power button. Audio Hero can also stream its own audio (local files, internet radio, and the PC / web-music sources) to them.

Universal disc players (Oppo-style)

Discovers Oppo-style universal disc players (UDP-203 / UDP-205 and BDP-83 / 93 / 95 / 103 / 105) on your network and gives each its own gear settings and power button. Controls power, volume, and mute over the Oppo LAN / IP control protocol.

Samsung Wireless Audio (WAM)

Discovers Samsung Wireless Audio Multiroom (WAM) speakers (M5 / M7 and R1-R7, plus WAM sound bars) and controls each over the local Samsung network API, with its own gear settings and a view of what the speaker is playing. Audio Hero can also stream its own audio (local files, internet radio, and the PC / web-music sources) to them over UPnP.

WiiM (LinkPlay)

Discovers WiiM and other LinkPlay streamers (WiiM Mini / Pro / Pro Plus / Ultra and the WiiM Amp) and controls each over the local LinkPlay network API, with its own gear settings and a view of what the device is playing. Audio Hero can also stream its own audio (local files, internet radio, and the PC / web-music sources) to them over UPnP.

Bluesound (BluOS)

Discovers Bluesound and other BluOS players (NAD and Bluesound NODE, POWERNODE, PULSE, and other BluOS devices) and controls each over the local BluOS network API, with its own gear settings and a view of what the device is playing. Audio Hero can also stream its own audio (local files, internet radio, and the PC / web-music sources) to them natively over the BluOS API.

moOde Audio New

Discovers moOde Audio players (Raspberry Pi devices running the moOde audio player) and controls playback natively through MPD, moOde's own music player engine, with each player getting its own gear settings and a view of what it is playing. The player name you set in moOde's WebUI is used automatically. Audio Hero can also stream its own audio (local files, internet radio, and the PC / web-music sources) to them.

Fully Kiosk tablets

Controls Fully Kiosk devices (Android tablets and phones running the Fully Kiosk Browser app) over their Remote Admin REST API, each with its own gear settings. Audio Hero can also push its own audio (local files, internet radio, and the PC / web-music sources) to them with the device's playSound command.

Dashie Kiosk tablets

Discovers Dashie and Dashie Lite dashboard tablets (Android devices running the Dashie kiosk app) over mDNS and controls each over their Fully Kiosk-compatible Remote Admin REST API, each with its own gear settings. Audio Hero can also push its own audio (local files, internet radio, and the PC / web-music sources) to them with the device's playSound command.

17. Track info panel Pro

What it shows

The Track Info panel appears to the right of the now-playing artwork (when the window is wide enough) and displays:

How data is gathered

Audio Hero queries four data sources in parallel and merges the best fields from each:

  1. TheAudioDB for track descriptions, artist bios, and album art (optional, controlled by a setting).
  2. Deezer for genre, release year, fan counts, and high-resolution album art.
  3. Wikipedia for biographical and cultural context (truncated to a clean sentence boundary).
  4. MusicBrainz for community-tagged genres, recording dates, artist country, and founding year.

Long prose fields pick the richest result; factual fields pick the first non-empty value; cover art prefers track-level art over album art. If a service times out or fails, the others' results are still used. A 15-second watchdog ensures the UI never hangs, with a single retry attempt on stalled requests. A "Try again" link is shown if everything fails.

Disabling or controlling track info

18. Album artwork tile

How the artwork tile works

The artwork tile rotates between two faces:

Three settings on the Settings tab control the look and feel: motion, page-flip animation, and timing. A fourth setting picks which faces are shown at all.

Animation settings
SettingOptionsDefault
Animation - motionSlight rotation (gentle plus/minus 2 degree wobble) or No rotationSlight rotation
Animation - page flipPage turn (3D flip) or No animationPage turn
Animation - timing between flip5, 10, 30, 60, or 300 seconds per face5 seconds
ArtworkAlbum and service art, Album art, Service art, Nothing (stock image), or Nothing (blank) New, which removes the artwork tile entirely so the track details use the full widthAlbum and service art

19. Views, layout, and appearance

Color theme and brightness New

Audio Hero can wear one of several color themes. Pick one under Settings → Appearance & layout → Color theme. The change applies to the whole app instantly, with no restart.

ThemeLook
Medium (default)The original dark look.
DarkerA deeper dark theme with more contrast.
BlackA near-black theme, easy on the eyes and OLED-friendly.
LightA light theme for bright rooms.
Follow Windows settingMatches the Windows apps light / dark mode automatically, switching between Medium and Light when Windows does.

Two sliders below the theme fine-tune it:

Your theme and brightness choices are saved on this PC and, with cloud sync on, follow you to your other PCs.

Full view

The default layout. Sidebar on the left, now-playing and transport on the right, sources panel below.

Compact view Pro

Click the ๐Ÿ”ฝ button in the header. Compact view collapses to a single panel showing artwork, track info, transport, and volume in a smaller footprint suitable for parking in a corner of your desktop.

Ultra-compact view Pro

Click โฌ for an even smaller single-row layout that fits in a docked sidebar or above your taskbar. All transport buttons, volume, multi-zone selector, presets, pin-on-top, and minimize controls are still accessible.

Minimize to tray Pro

Click to send Audio Hero to the system tray. Hover the tray icon to see the now-playing title; click it to open a popup with:

Always on top

The ๐Ÿ“Œ pin in the header toggles the window's topmost attribute so it stays above other applications. The icon rotates 45 degrees when pinned. Available in every view including the compact ones.

Resizing panels

The full view is laid out with draggable dividers so you can give each area exactly the space you want. Hover a divider and drag it; when you grab one, the other dividers gently light up so you can see what else is adjustable.

The sidebar width and Now Playing height are remembered on this PC between launches (when Remember last view & window size on exit is on). The album-art and Track Info sizes are per-session and reset to their defaults the next time you start the app.

Reset the Now Playing panel

Right-click anywhere on the Now Playing panel and choose Reset now playing panel view to put the album-art size and Track Info column width back to their defaults. The panel height is left as you set it.

Saved layout views

Once you have the full view sized the way you like, you can save it as a named layout view and switch between several with a couple of clicks. Right-click any empty area of the full window to open the view menu, which has three choices: Save view, Load view, and Reset view to default.

A saved view remembers the window size, whether it was maximized, the sidebar width, and the Now Playing height. (Album-art size, Track Info width, and the Music Sources column widths are not part of a saved view.) Saved views are stored with your settings and, with cloud sync on, follow you to your other PCs.

Remembering your last view

Enable Remember last view & window size on exit in Settings so Audio Hero reopens in whichever view (full, compact, or ultra-compact) was active when you last closed it. In full view it also restores the last window size, position, and panel layout (sidebar width and Now Playing height). When disabled, the app always opens at the default size in full view.

20. Sleep timer Pro

Setting a sleep timer

The sleep timer is a Pro feature. Audio Hero includes a per-device sleep timer:

  1. Open the sleep timer popup (clock icon near the transport controls).
  2. Pick a duration: 15, 30, 60, or 90 minutes, or any custom value you add. Custom values are persisted to settings.json.
  3. Pick an action: Stop play (pauses playback) or Power off (sends a power-off command).
  4. Pick a scope: this device only, or all devices.

Pause and resume controls let you halt the countdown without losing the remaining time.

21. Automations

Scheduled automations

Automations let Audio Hero act on a schedule, even when the app is closed. Audio Hero normally backs an enabled automation with a Windows scheduled task. When an up-to-date Companion is configured, compatible automations are handed to the Companion instead, so they can run even while this PC is off.

Find them under Settings → Scheduled automations. Click Add automation to create one, then set:

Each automation in the list has an enable toggle, an Edit button, a Delete button, and right-click Move to Top / Move to Bottom for ordering. A circled Companion icon means the automation is stored and scheduled on the Companion PC.

New An automation that targets a Sonos speaker now follows that speaker even when your router hands it a new IP address, so a DHCP change can no longer silently break a morning alarm. Automations for other device types still target the address the device had when the automation was created; if such a device moves, edit the automation to point at it again.

Telling you when an automation did not work New

A scheduled action can fail quietly: the speaker was unplugged, the receiver did not answer, or the station Audio Hero was told to play no longer exists. Because it happens while you are not looking, you would normally only notice the silence.

Alert me when automations fail to run (on by default, under Settings → Automations) makes Audio Hero tell you instead. The alert names the automation and says what went wrong, so you can fix it rather than guess.

Turn it off if you would rather not be interrupted. Audio Hero keeps recording failures in its diagnostic log either way.

What automations can do on each device

Automations use the same scoped Starred Favorites library as the main source browser. HEOS can start HEOS-native favorites and portable streams. Sonos can start playable Sonos-native favorites and portable streams. Onkyo can start its starred built-in NET stations and portable streams. Other renderer ecosystems can start saved internet-radio favorites (direct stream URLs). Browsable folders that do not identify a playable target are omitted. Stopping playback works everywhere. Power on / off is only possible on devices that expose network power - HEOS AVRs and integrated amps, Onkyo receivers, and smart plugs - and is a Pro feature.

An up-to-date Audio Hero Companion can own compatible automations for HEOS, Sonos, Onkyo / Integra, DLNA, MusicCast, WiiM, Bluesound, and smart plugs. They fire from the Companion even with Audio Hero closed and this PC shut down. Automations for other device types, or sources that need Audio Hero's own playback machinery, keep their local Windows scheduled task. See Manage automations from the Companion.
Device typeStart a sourceStop playbackPower on / off
HEOS speakers and AVRsCompatible HEOS favorite or saved internet-radioYesAVRs and amps only (Pro)
Onkyo / IntegraStarred receiver NET station or saved internet-radioYesYes (Pro)
SonosPlayable Sonos favorite or saved internet-radioYesNot available
Chromecast / Google CastSaved internet-radioYesNot available
DLNA renderersSaved internet-radioYesNot available
AirPlaySaved internet-radioYesNot available
Yamaha MusicCastSaved internet-radioYesNot available
RokuSaved internet-radioYesNot available
WiiM / LinkPlaySaved internet-radioYesNot available
Bluesound / BluOSSaved internet-radioYesNot available
moOde AudioSaved internet-radioYesNot available
Amazon EchoSaved internet-radioYesNot available
SnapcastSaved internet-radioYesNot available
Smart plugs (Kasa, Shelly)Not availableNot availableYes (Pro)

22. Settings reference

All settings live on the Settings tab in the sidebar. They are organized into categories you tap into: Devices & sources, Audio & volume, Appearance & layout, Accounts & cloud sync, Automations, Updates, Audio Hero Companion, Home Assistant, and System & advanced. Three connection toggles also live at the top of the Players tab. The tables below group the settings by what they do rather than by category.

Players tab connection toggles
SettingWhat it doesDefault
Auto-discover on startupRuns SSDP discovery automatically when Audio Hero opens. Useful if your IPs change often (DHCP).Off
Remember discovered devicesSaves the list of devices found during discovery so they reappear next launch without needing another scan.Off
Auto-connect last deviceOn launch, reconnects to whichever device you were last using.On
Behavior
SettingWhat it doesDefault
Always skip thumbs-down itemsWhen you thumbs-down a track, Audio Hero immediately skips to the next track. The thumbs-down is also forwarded to the streaming service, but services may still serve the track again. This setting guarantees it does not play.On
Set volume at startApplies a chosen volume preset when waking a powered-off device, when Audio Hero first connects, or both (you pick which), so playback never starts at the device's own default volume. The companion Volume preset at start control sets the percentage.On
Remember last volume per music sourceRemembers the volume you last used for each music source on each device and re-applies it when you switch back to that source on that device, so a level chosen for one speaker never jumps onto another. An optional sub-setting also restores it when Audio Hero resumes a source on launch.Off
Auto-sort volume presetsKeeps the six volume presets sorted automatically after every change (smallest or largest value first, your choice), with empty slots pushed to the end. Turn off to drag presets into your own order.Off
Use a separate max-volume limit for each device ProWhen off, the Limit max volume cap uses one on / off state and percentage for every device. When on, Audio Hero remembers the cap separately for each device.On
Use separate startup-volume settings for each deviceWhen off, Set volume at start is shared by every device. When on, Audio Hero remembers its enabled state, trigger, and preset percentage separately for each device.Off
Remember last view & window size on exitReopens in the same view (full / compact / ultra-compact) you closed in, and in full view restores the last window size, position, and panel layout (sidebar width and Now Playing height). When off, the app always opens at the default size in full view.On
Hide music services you aren't signed intoHides paid services you have not signed into so the sources list only shows what you can actually play. Free services like TuneIn and built-in inputs are always shown.On
Music source orderChooses how your drag-and-drop order for music sources is remembered: shared across all devices, kept separately per device type (HEOS, Sonos, and so on), or kept separately for each individual device.Per device type
Group players by device typeGroups the Players list under per-ecosystem headers (HEOS, Sonos, Google Cast, and so on) when more than one device type is connected. Headers can be collapsed, reordered, renamed, and hidden. See Organizing the Players list.On
Group players by roomGroups the Players list under rooms you create and assign devices to (Office, Bedroom, and so on). Combine with device-type grouping to nest device types inside each room. Assign a device by right-clicking it; Manage rooms... creates, renames, and deletes rooms.Off
Show under each deviceWhat the second line under each name in the Players list shows: Model and IP address, Device model only, IP address only, or Nothing.Model and IP address
Scan additional local subnets for devicesAlso looks for devices on other network ranges reachable through your router, not just the one your PC is on. Helps when speakers or plugs sit on a separate guest, IoT, or extender network. Manage local subnets... shows and edits the list of ranges. See Devices on other networks.On
Alert me when automations fail to runTells you when a scheduled automation could not do what it was asked. Failures recorded by the Companion while Audio Hero was closed are shown the next time you open it. See Telling you when an automation did not work.On
Include support for legacy HEOS devicesAdds discovery and volume/mute/power control for pre-HEOS Denon and Marantz devices (CEOL Piccolo, M-CR, older AVRs). Playback still goes through your HEOS device.Off
Check for device firmware updatesAsks each HEOS device whether a firmware update is available and shows a small โฌ† FW chip in the sidebar when one is. Audio Hero only notifies; install the update from the official HEOS app.On
Automatic app update checkPeriodically checks the Microsoft Store for a new Audio Hero version in the background and shows the "update available" banner when one is found. The update itself is applied in the Microsoft Store app. Audio Hero always checks once at startup regardless of this setting.On
Update check intervalHow often background checks run: from 15 minutes up to 7 days, in 15-minute steps (15 / 30 minutes, 1 / 4 hours, 1 day, etc.).4 hours
Detailed debug loggingCaptures much more detail in the diagnostics log to troubleshoot sync, sign-in, network, and device behavior. Leave off unless you are collecting logs for support.Off
Submit bug report to developerOpens a review window where you can describe a problem, enter the email address that will receive your private progress link, and explicitly send a sanitized diagnostic report over HTTPS. Nothing is sent automatically.Manual only
Submit a diagnostic bug report

Use this when Audio Hero behaves unexpectedly and you want to send the developer the information needed to investigate it. Reports are never sent automatically.

  1. Open Settings, then open System & advanced.
  2. If support asked for detailed logs, turn on Detailed debug logging, reproduce the problem, then return here. Otherwise leave detailed logging off.
  3. Click Submit bug report to developer.
  4. Review the explanation of what will and will not be included. Optionally describe what happened, then enter the email address where Audio Hero should send your private report-progress link.
  5. Click Submit report. Closing or canceling the window sends nothing.
  6. After the upload succeeds, keep the displayed report number and check your email for the private tracking link. That page shows whether the developer has reviewed the report, whether it was fixed, and customer-visible developer updates. You can also open the status page directly from the submission window.

Audio Hero compresses the report into a ZIP and sends it over encrypted HTTPS. It includes the report number; Audio Hero, package, Windows, and .NET runtime versions; edition and connection state; culture, time zone, uptime, and a summary of network-adapter types; a device summary with each room/device name, player ID, type, manufacturer, model, firmware, direct-or-presumed detection status, current group role, and group-leader player ID; recent diagnostic logs; your optional description; and the contact email used to deliver the private progress link.

The report excludes settings.json, passwords, tokens, cookies, browser profiles, media files, playlists, ratings, and saved favorites. The device summary retains room/device names and player IDs so an individual device can be matched to diagnostic events. In diagnostic logs, common sensitive patterns, email addresses, computer and known device names, IP addresses, MAC addresses, and user-folder paths are removed or replaced before upload. Diagnostic logs are free-form text, so a station name, file name, service display name, or other text involved in the problem can remain. Your description is sent exactly as entered. Your email is used only for support and to deliver the private report-progress link.

The server accepts only the expected report text, optional description, contact email, and diagnostic-log files, keeps the ZIP in a web-inaccessible folder, and does not extract it to disk. It emails a private, unguessable tracking link to the supplied address. That link opens only this report and shows the submitted description while retained, review and resolution progress, and customer-visible developer updates. It never shows contact information, diagnostic logs, attachments, private investigation notes, or other reports. The raw ZIP, contact email, and original description are removed after 30 days. A minimal record containing the random report number, application versions, status, category, customer-visible update, and developer-written summary and resolution may remain so progress, recurring defects, and completed work can be tracked. To prevent abuse, the server allows up to six submission attempts per hour from one public IP address.

If submission fails: Check that the PC has internet access, wait a few minutes, and try again. If several attempts were made recently from the same network, wait one hour before retrying.
Accounts
Audio Hero Companion New

Point Audio Hero at a Companion on another PC to offload web music and PC audio. Turn on Run the Companion on another PC, find it on your network or type its address, enter a 4-digit PIN if you set one, and test the connection. You can also choose which sources use the Companion and whether to fall back to this PC when the Companion is unreachable. Full walkthrough in Audio Hero Companion.

Once a Companion is connected, a Companion PC power group appears here with three controls that live on the other PC: Wake the Companion PC for scheduled actions, Run missed actions when the Companion PC wakes, and Never let the Companion PC sleep. They decide whether Companion-owned scheduled actions fire on time when that PC sleeps, and they change it there immediately. Because they describe one machine rather than your account, they are never included in cloud sync. See Smart devices on a Companion.

Shortcuts

A Create desktop shortcut for Audio Hero link adds a shortcut to your desktop. Once it exists, the link is replaced by a "Desktop shortcut created" note. Shown on the Microsoft Store install.

Appearance & layout New

See Color theme and brightness for the full description. These choices are cloud-synced.

Album / service art display
SettingOptionsDefault
Animation - motionSlight rotation or No rotationSlight rotation
Animation - page flipPage turn or No animationPage turn
Animation - timing between flip5 / 10 / 30 / 60 / 300 seconds5 seconds
ArtworkAlbum and service art / Album art / Service art / Nothing (stock image) / Nothing (blank)Album and service art

23. Cloud sync between PCs Pro

Cloud sync keeps Audio Hero the same on every PC you use. Sign in once with your Microsoft account and your settings, ratings, starred favorites, saved streams, device order, and more follow you from PC to PC. Everything is stored in a single file inside a private app folder in your own OneDrive. The Audio Hero bug-report server is not involved and never sees it.

By default every PC is an equal partner: whichever PC changed a setting most recently wins. If you would rather have one PC be in charge, the optional settings master makes your other PCs take their settings from it.

Turning it on
  1. Open Settings → Accounts & cloud sync.
  2. Click Sign in with Microsoft and complete the sign-in. Personal Microsoft accounts are supported.
  3. That is it. Audio Hero syncs a few seconds after any change, and also checks for changes from your other PCs every 15 minutes.
  4. Repeat on each of your other PCs, signing in with the same Microsoft account.

The section shows the account you are signed in as, when the last sync happened, and a Sync now button if you do not want to wait. Sign out stops syncing on that PC and leaves its settings exactly as they are.

If your sign-in expires, the button changes to Reconnect and the status explains what happened. Nothing is lost in the meantime; the PC simply stops sending and receiving until you reconnect.
Choosing what syncs

Click Choose what to sync... to see every category, each with a short description of exactly what it covers. Untick one and that category stops syncing entirely: it stays on whichever PC it is on and is removed from the cloud file.

Categories include track ratings, starred favorites, saved internet radio streams, music source order and visibility, player order / names / grouping, volume presets, the volume cap, remembered source volumes, hidden device inputs, speaker EQ presets, receiver zone names, custom sleep timer durations, window and artwork preferences, color theme and brightness, startup and update behavior, playback behavior, smart-device switch display, legacy device support, saved layouts, and panel sizes.

Two categories are off until you turn them on, because they are the ones people most often want to differ per PC: Color theme & brightness and Smart-device switch display.

Your choices here apply to every PC on the account, not just the one you are sitting at. That is deliberate: it is one shared list of what this account syncs. Sensitive things are never uploaded at all, whatever you pick, including your HEOS and music-service passwords and your linked smart plugs.
The settings master (optional)

Without a master, your PCs are equal and the most recent change wins wherever it was made. That is fine when one person uses every PC the same way. It is less good when a laptop keeps re-arranging the desktop's carefully ordered player list, or when other people use one of the PCs.

Naming a settings master makes one PC authoritative. Your other PCs pull their settings from it and never push their own back, so nothing they do can change what the master says.

Setting a master

On the PC you want in charge, open Settings → Accounts & cloud sync and click Make this PC the master. Confirm, and that is done. The section then reads "This PC is the settings master. Your other PCs follow its settings."

On every other PC the same section reads "Following Office PC" (using that PC's name), followed by a note that changes made there stay on that PC.

You only ever set this on one PC. The choice travels through the cloud file to the others within a few seconds, or at their next sync.

What happens on the PCs that follow
  • They take the master's settings. The first time a PC sees a master, it adopts that master's settings for every category set to follow it, no matter which PC changed what more recently. This is what makes setting up a brand-new PC painless.
  • They can still change anything. Nothing is locked or greyed out. Change a setting on a following PC and it applies there immediately.
  • Their changes stay local. A change made on a following PC is never sent to the master or to any other PC.
  • The master can reclaim a setting. A local change lasts until the master changes that same setting. When it does, the master's value wins and replaces it. Every other setting is left alone.
Example: the master has compact mode off. On your laptop you turn it on. The laptop stays in compact mode indefinitely, and no other PC is affected. If someone later changes compact mode on the master, the laptop follows the master again for that one setting.
What the master does and does not control

The master owns your preferences: window and artwork options, player order and names, volume presets, the volume cap, music source order, hidden inputs, panel sizes, saved layouts, and the rest.

Three categories are never owned by the master and are always shared by every PC, whether or not you set one:

  • Track ratings - a thumbs-down given on any PC counts everywhere.
  • Starred favorites - a favorite starred on the laptop appears on the desktop.
  • Saved internet radio streams - a station added anywhere is available everywhere.

These three collect things rather than express a preference. A preference has one right answer, so it makes sense for one PC to decide it. A collection is everything you have added across all your PCs, and a master could only ever hold the part it happened to see, so letting it take charge would quietly strand a favorite starred anywhere else. There is nothing to configure here; it simply works this way.

Worth thinking about for Panel & layout sizes and Saved layouts: these remember real pixel sizes, and the master owns them. If your PCs have very different screens, a large desktop's window size may not suit a small laptop. Untick those categories in Choose what to sync... if that is a problem; each PC then keeps its own.
Pushing your settings up to the master

Sometimes you get a PC set up exactly right and want that to become the shared arrangement. On a following PC, click Push this PC's settings to all PCs.

This replaces the settings the master controls, on the master itself and on every other PC, with the ones on the PC you are sitting at.

  • Which PC is the master does not change. The master keeps its role, it simply picks up the pushed settings like everyone else.
  • Your ratings, starred favorites, and saved streams are not affected. Those are always shared by every PC, so a push never overwrites them. A favorite starred only on your desktop is still there afterwards.
  • You are asked to confirm first, and the confirmation names the master PC.
  • It cannot be undone. Audio Hero keeps no history of what a PC's settings were before a push.
Changing or removing the master
  • Move the role. Click Make this PC the master on a different PC. It takes over, and every other PC re-adopts settings from the new master. If two PCs are made master at nearly the same moment, the later one wins everywhere.
  • Remove it. Click Remove master on any PC. All your PCs go back to sharing settings equally, where the most recent change wins. Nothing is erased; each PC keeps whatever it currently has.
Moving the role re-syncs the other PCs from the new master, so any local-only changes they were holding for master-governed categories are replaced. Removing the master and setting it again does the same thing.
If the master PC is retired or stops being used

Following PCs simply keep the master's last known settings and carry on. Audio Hero never promotes a new master on its own, because quietly changing which PC is in charge is a surprising thing for an app to do.

So that you notice, following PCs show a line such as "Office PC last synced 14 days ago" under the master status. When you see that and the PC is gone for good, click Make this PC the master on a PC you still use, or Remove master to go back to equal sharing.

Good to know

24. App updates

How updates are delivered Changed

Audio Hero is distributed exclusively through the Microsoft Store, and updates are delivered as new Store packages. Audio Hero itself only tells you a new version exists; the Store app does the installing. It works like this:

  1. Audio Hero checks for a newer published version at startup and, if Automatic app update check is on, again in the background on the interval you chose. You can force a check at any time with the ๐Ÿ”„ icon in the header.
  2. When one is found, a banner appears in the header reading ⬆ v6.x.x.x available! with an Open Store link. Click โœ• to dismiss it until the next check.
  3. Click Open Store. A short reminder of the steps appears, then Audio Hero's page opens in the Microsoft Store app.
  4. On that page, select Update. If the page shows Open instead, the Store has not noticed the new version yet: choose Downloads in the Store's left menu, then Get updates.
  5. Audio Hero closes while the Store installs the update. Reopen it from the Start menu when the install finishes.

The Microsoft Store also updates Audio Hero on its own schedule, so if you leave automatic Store updates turned on in Windows you will often find the update has already been applied before you see a banner at all.

What changed. Earlier versions could download and install an update from inside the app, with an optional Automatically install app updates setting that applied updates silently and restarted Audio Hero afterwards. That has been removed. The small helper script it used to relaunch the app after an update was being flagged by some antivirus products, which quietly broke every automatic install on those PCs. The banner is now a notice only, and the Store applies the update, which is the same trusted path every other Store app uses. The automatic check, its interval setting, and the manual ๐Ÿ”„ check button all remain. The first launch after upgrading also removes any leftover scheduled task or script from the old mechanism.
Which playback is affected by an update

Because the Store closes Audio Hero to install the update, anything Audio Hero itself is streaming from this PC stops: local files, internet radio it is serving, YouTube Music, Apple Music, Device + This PC, PC Line Out, and mixed-brand groups fed from this PC. Music a device plays for itself (its own Spotify, Pandora, favorites, or inputs) keeps going, and so does anything served by an Audio Hero Companion on another PC; Audio Hero simply picks those streams back up when you reopen it. If you would rather not interrupt what is playing, dismiss the banner and update later.

25. Device firmware updates

How the firmware badge works

When Check for device firmware updates is enabled, Audio Hero asks each connected HEOS device whether a firmware update is available. A small yellow โฌ† FW chip appears next to that player in the sidebar when one is.

Audio Hero only notifies. To install the firmware update, use the official HEOS app on your phone (the HEOS API does not expose firmware install).

26. Pro vs Free

Audio Hero has two editions. Free is the app as installed from the Microsoft Store. Pro is a one-time in-app purchase that unlocks the features below. Throughout this guide, anything marked Pro needs the upgrade; everything else is Free. Where a section has both, the text says which parts are which.

Volume and zone controls at a glance

This is the question we are asked most, so here it is in one place. The full table is in Volume and presets.

What Free includes
What Pro unlocks Pro

One-time purchase. No subscription or recurring fees. Audio Hero Pro remains permanently unlocked through your Microsoft Store account.

Everything not listed above is Free. Upgrade from inside the app on a Store install, or visit the Microsoft Store listing directly.

27. Keyboard shortcuts

Available shortcuts
KeysAction
โ†‘ / โ†“Volume up / down
โ† / โ†’Previous track / next track
Enter in the search boxRun search
Mouse middle-click on artworkManually flip the tile (when animations are on)
Right-click on player / source / browse itemOpen context menu (reorder, rename, reboot, star, etc.)
Long press on preset buttonSave current volume to that preset slot

28. Privacy and data

What Audio Hero sends and where

Audio Hero collects no automatic telemetry, has no ads, and sets no tracking cookies of its own (the built-in browser windows used for web-player sources keep only the sign-in cookies those services need). Bug reports are user-initiated, sanitized, and used only for support. The app has no Audio Hero account system; the optional cloud-sync feature uses your own Microsoft account. Full Privacy Policy.

How credentials are stored

The HEOS account password is stored locally using Windows DPAPI (CurrentUser scope) so only your Windows account can decrypt it. Older builds stored it as plain text; Audio Hero automatically migrates the plaintext value to the encrypted form on first run after the upgrade.

29. Troubleshooting

Discovery does not find my device
A smart plug does not switch when it should
Connection drops or "Connection Trouble" appears
Some buttons are greyed out
I can see my receiver and change its volume, but there is no Zone 2 volume control

This is the most common multi-zone question, and it is not a Pro limitation. On a multi-zone Denon or Marantz AVR (Cinema series, AVR-X, AVR-S, AVC, and similar), zone volume is a Free feature: the All / Z1 / Z2 / Z3 bar under the volume slider lets you pick a zone, and the slider then controls that zone.

See Multi-zone receivers for the details.

Track info panel says "unavailable"
Local file playback fails
App will not update
Where to send bug reports

Use Settings > System & advanced > Submit bug report to developer. Audio Hero displays a report number, emails your private tracking link, and automatically notifies the developer. Keep the tracking link private. You can also post the report number and any additional details on the r/AudioHero subreddit.

30. Windows firewall New

To play to your speakers, Audio Hero does more than send commands out to them: it also runs small local servers on your network that your speakers and receivers connect back into, both to discover them and to stream audio. Windows blocks incoming connections like that by default. Audio Hero now ships with the firewall permission it needs built into its app package, so Windows sets it up automatically when the app installs or updates. In almost every case there is nothing for you to do, and you should not see a firewall prompt at all.

Is this safe? Yes. The permission only allows incoming connections to Audio Hero's own program and its Companion, and Audio Hero only ever listens on your local network, where your speakers live. It does not open your PC to the internet.
Why Windows needs a permission at all

Most apps only send data out, which Windows allows by default. Audio Hero is different: several features need to receive a connection back from a device on your network, and incoming connections are exactly what a firewall blocks. The features that listen for an incoming connection are:

How Audio Hero handles it for you

Audio Hero declares the firewall permission it needs inside its app package. When Windows installs or updates Audio Hero from the Microsoft Store, Windows creates the rule itself and ties it to the app's identity. That means:

There is nothing to switch on. Earlier versions asked you to add the rule yourself from a popup or from Settings; that is no longer needed, and those controls have been removed.

If Windows still prompts

On a fully updated version you should not see the "Windows Defender Firewall has blocked some features of this app" prompt at all. If you do see it, for example while you are still on an older version, just click Allow access. You can leave the default boxes as they are; Audio Hero only needs your local network. Once you are on the latest version, the built-in permission takes over and the prompt should not come back.

Finding the rule in Windows

If you would like to see the permission for yourself, you can view it in the built-in Windows Defender Firewall with Advanced Security console:

  1. Open the firewall console. Press the Windows key, type wf.msc, and press Enter. (You can also reach it from Control Panel → System and Security → Windows Defender Firewall, then click Advanced settings in the left-hand column.)
  2. Select Inbound Rules. In the left-hand pane, click Inbound Rules. The middle pane lists every inbound rule on your PC.
  3. Find the Audio Hero rules. Sort by the Name column and look for entries named Audio Hero. You will normally see one for Audio Hero itself and one for its Companion.
  4. View the details. Double-click a rule to open its Properties, where you can see it is an inbound Allow rule scoped to the Audio Hero program.

Windows owns these rules, so they are added when you install Audio Hero and removed when you uninstall it. You do not normally need to touch them.

On a separate Companion PC

Everything above is about the firewall on the PC running Audio Hero. When you offload streaming to a standalone Audio Hero Companion on another PC, that PC needs its own inbound rule instead. Its installer adds one automatically for TCP 47708 (control and audio) and UDP 47707 (discovery) on private and domain networks, so you should not be prompted there. If you ever need to add it by hand, allow AudioHero.StreamHost.exe for inbound connections on your private network.

31. Devices on other networks New

Most homes have one network, and everything on it can talk to everything else. Some homes are split into several smaller networks instead, often without the owner realizing it: a mesh Wi-Fi system with a separate guest or "IoT" network, a router with more than one LAN port range, a range extender that hands out its own addresses, or a deliberate setup with a separate network for smart-home gear. Each of those smaller networks is called a subnet. You can usually spot them by the addresses: devices on 192.168.1.x are on one subnet, devices on 192.168.20.x are on another.

This normally causes a problem, because the usual way to find speakers is to shout a question at the whole network and listen for answers. That shout does not travel from one subnet to the next, so a speaker on the other subnet never hears it and never appears. Audio Hero handles this for you. It works out which other subnets exist and goes looking on them as well.

If everything on your network already shows up, there is nothing to do here. This whole section only matters when a speaker, receiver, or smart plug is missing from the Players list.
How Audio Hero finds the other subnets

Audio Hero builds its list of subnets from several clues, so it does not have to guess:

The first two are precise. The last three only tell Audio Hero one address, so it assumes the usual home-network size around it and labels the entry Estimated /24, which simply means "the 254 addresses that share the first three numbers".

Turning it on or off, and managing the list

Open Settings → Devices & sources and look for Network discovery.

In that window you can:

Virtual and VPN network ranges are listed but left switched off, because they belong to software on your PC rather than to your home. Ranges that are too large to search politely are shown for reference only, marked Shown for reference.

What the search actually does

Audio Hero is deliberately gentle about this, so it does not look like something scanning your network for weaknesses:

Searching extra ranges takes a little longer than searching one, which is normal. The progress line under the Discover button tells you when Audio Hero has moved on to the additional subnets.

If a device still does not show up

32. File locations

Where Audio Hero stores data

All Audio Hero data lives under %LOCALAPPDATA%\Audio Hero\:

File / folderWhat it stores
settings.jsonEvery setting, paired devices, friendly names, presets, votes, starred favorites, saved streams, and zone configuration. Written atomically (temp file + rename) so a crash mid-write cannot corrupt it.
diagnostics.logRolling diagnostic log capped at about 1 MB. Used for bug reports. Each line is timestamped and tagged.
art-cache\Extracted album art for local files, keyed by file hash.

You can safely delete the entire folder to reset Audio Hero to a clean state. The app rebuilds anything it needs on next launch.

If you spot anything out of date, please let me know.