🎵 Audio Hero Documentation

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. On first run the app opens with the Players tab selected and prompts you to start discovery.
4. Click Discover Devices. Audio Hero broadcasts an SSDP discovery probe on every active network adapter and lists every HEOS device that responds.
5. Click a device in the list to connect. The status dot turns green once connected.

• Windows 10 or Windows 11.
• .NET 10 runtime (bundled with the Store install).
• HEOS-compatible Denon or Marantz device on the same local network (HEOS speakers, HEOS soundbars, HEOS amps such as PMA-900HNE and HEOS Link, or HEOS-equipped AVRs).
• SSDP multicast (UDP port 1900) and HEOS CLI (TCP port 1255) reachable on your LAN. Most routers allow this by default.
• For legacy device support: pre-HEOS Denon/Marantz models with HTTP control (CEOL Piccolo, M-CR series, older AVRs).

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 devices is enabled in Settings, a second field appears below for adding pre-HEOS Denon/Marantz devices by IP.

• App icon and title. Shows the app name and the active edition (Free or Pro).
• 🛒 Store, 💬 Support, 🌐 Website. Quick links to the Microsoft Store listing, the support subreddit, and bommerts.com/audiohero.
• Update banner. Appears when a new version of Audio Hero is available. Shows three states: Update available, Downloading, and Update installed. See App updates.
• Version label. Shows the running version (for example v4.10.0).
• 🔄 Check for updates. Forces a manual update check.
• 📌 Always on top. Pins the window above other applications. The icon rotates 45 degrees when active.
• 🔽 Compact / 🔼 Full / ⏬ Ultra compact. Switches window layout. Compact and ultra compact are Pro features.
• ⏊ Minimize to tray. Sends Audio Hero to the system tray with a popup mini player. Pro feature.

The sidebar has three tabs:

• Players. Discovery controls, the list of paired devices, and per-device actions (rename, reboot, play an input, send an input elsewhere). Includes a small green or gray status dot showing connection state.
• Groups. Create and manage HEOS speaker groups. Per-member volume sliders are exposed once a group is selected so you can trim individual levels. Pro feature.
• Settings. Every app-wide toggle. See the full Settings reference below.

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.

• Now Playing panel. Album art, title, artist, album, source, station, audio info, and which player the audio is on.
• Track Info panel (Pro). Optional sidebar showing artist biography, song facts, and merged metadata pulled in parallel from TheAudioDB, Deezer, Wikipedia, and MusicBrainz.
• Transport controls. Play, pause, stop, next, previous, repeat, shuffle, thumbs up, thumbs down, and timeline scrubber when the source allows seeking.
• Volume controls. Master volume slider, mute, optional volume cap, six volume presets (Pro), and a zone selector for multi-zone receivers.
• Music Sources panel. A Finder-style column browser for navigating HEOS services, internet radio, local files, and starred favorites.
• Search panel. A unified search across HEOS music services. Show or hide it from the Music Sources header.

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.

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

• Seekable tracks. Position and duration appear with a draggable progress bar. Click anywhere on the bar to seek to that point. Audio Hero checks the device or service for seek capability and only shows the bar when seeking is possible. If the device does not advertise it via HEOS, a UPnP AVTransport Seek request is sent as a fallback.
• Live streams. A red dot and a LIVE label show the station name. The scrubber is hidden because live radio has no fixed timeline.

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.

• Slider. Drag from 0 to 100 percent. Changes are debounced to avoid flooding the device with commands.
• Numeric box. Click the % value to type an exact volume (Pro).
• 🔊 / 🔇 Mute. One-click mute and unmute.
• Keyboard. Use ↑ and ↓ arrows to nudge volume.

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.

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.

• Apply a preset. Left-click a filled preset button to set that volume.
• Save a preset. Long-press (press and hold) a preset button to capture the current slider value into that slot. Empty slots stay blank until you save one.
• Clear a preset. Right-click a preset and choose Clear.
• Reorder. Drag a preset to rearrange the slots by hand.
• Auto-sort. Turn on Auto-sort volume presets in Settings to keep the slots ordered automatically (smallest or largest value first, your choice), with empty slots pushed to the end.

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

When connected to a Denon or Marantz AVR with multiple zones, an extra control bar appears below the slider:

• All / Z1 / Z2 / Z3. Selects which zone the slider currently controls.
• Your selection persists per-receiver and is restored when you reconnect.
• The volume slider always reflects the selected zone's level.

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

• HEOS streaming services. Examples: Spotify, Tidal, Amazon Music, Pandora, SiriusXM, Deezer, iHeartRadio, TuneIn, Soundcloud, Napster, Mood:Mix, JUKE, and more depending on your region and device firmware.
• Aux / physical inputs. Phono, CD, Optical, Coaxial, HDMI, AUX, Bluetooth, USB.
• Local Media. DLNA / UPnP servers on your network.
• HEOS Favorites. The presets you've saved in the official HEOS app.
• ★ Starred favorites. Audio Hero's own cross-service favorites list (see section 7).
• 📻 Internet Radio. Audio Hero's own list of saved stream URLs (see section 8).
• YouTube Music and Apple Music. Play these web services on your device by streaming them from your PC (see below). Free.
• HEOS + PC. Play a web music service on your PC and your device at the same time (see below). Free.
• Local Music (Your PC). Play audio files stored on this computer (see section 9). Pro.

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.

• Columns scroll horizontally; the leftmost Sources column is pinned and resizable by dragging its right edge.
• Each opened browse column is also resizable and remembers its width for the session.
• Items load in pages of about 100 at a time. Audio Hero requests more as you scroll.
• Click ✕ Close Browser in the header to return to the now-playing view at any time.
• Audio Hero remembers your last-visited source and restores it when you reconnect.

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

• Drag the ☰ handle to reorder.
• Right-click a source for Move to Top or Move to Bottom.
• Custom order is persisted to settings.json.

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.

• The dialog shows whether you are signed in and, when signed in, the account name. Click Sign in and enter your HEOS account email and password, or Sign out to clear the active session on the device.
• Credentials you choose to store are encrypted with Windows DPAPI (per-user) and never sent anywhere except to your HEOS device. They are never uploaded, even with cloud sync on.
• This is also where additional device platforms (such as Sonos) will appear in the future.

Audio Hero adds two sources, YouTube Music and Apple Music, that play those web services on your HEOS device even though neither is a native HEOS service. 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.

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.

The HEOS + PC source plays a web music service on your computer and your HEOS device at the same time, kept roughly in sync. Open it to choose from the supported services: YouTube Music, Apple Music, Amazon Music, Pandora, Tidal, Deezer, SiriusXM, Spotify, iHeartRadio, and TuneIn.

• Click a service to open its web player and start playing on both your PC and the device.
• An Audio Sync delay slider appears for services that allow it, so you can nudge the PC audio to line up with the device. Services protected by DRM (for example Tidal, Amazon Music HD, Spotify, Apple Music) play through your PC's normal output instead, and the sync slider is disabled for those.

Toggle the search panel with the 🔍 Show Search button in the Music Sources header.

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.

The Starred favorites list is your own quick-access library, stored locally and independent of any single music service.

• Add to favorites. Right-click any browse item (station, playlist, album, song) and choose ★ Add to Starred favorites.
• Remove. Right-click a starred item and choose ✕ Remove from Starred favorites.
• Browse. Click the Starred favorites source in the Music Sources column.
• Drill in. Starred playlists, albums, and folders open exactly like the originals; the underlying source ID is preserved so HEOS handles playback the same way.

Favorites are saved to settings.json with just enough HEOS context (source id, parent cid, mid/cid, type, name, image) to replay the same browse or play command later.

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.

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

• Curated providers. SomaFM (live channel list refreshed from somafm.com), Radio Paradise, FIP / Radio France, KEXP, KCRW, WFMU, WWOZ, NTS Radio, Linn Radio (FLAC), Nightwave Plaza, Jazz 24, Rainwave, and others.
• Browse the web. Searches the live community-curated directory at radio-browser.info by station name or genre. Results are sorted by popularity and can be loaded in batches.
• Double-click a station to add it to your list and start playing immediately, or use Add station to add without playing.

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.

Audio Hero can stream audio files from your computer to any HEOS device 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.

• 📁 Play Files. A row in the Local Music source that opens a file picker so you can choose one or more audio files. The selected files become a play queue.
• 📂 Play Folder. A row that opens a folder picker and recursively queues every supported audio file inside.
• Supported formats: MP3, FLAC, WAV, AAC, M4A, WMA, OGG, ALAC.
• Queue display. Shows the current track and the upcoming items.
• Next / Previous. Navigates your local queue when active and falls back to HEOS controls otherwise.
• The device's internal HEOS queue is cleared when local playback starts to prevent cross-talk with previously queued service tracks.

Audio Hero reads embedded tags from each file:

• Tag systems: ID3v2 (MP3), Vorbis (FLAC, OGG), iTunes atoms (M4A, ALAC), ASF (WMA).
• Album art: Extracted directly from APIC frames (MP3) or Windows Shell thumbnails (other formats), then cached locally in %LOCALAPPDATA%\Audio Hero\art-cache.
• Audio properties: Bitrate, sample rate, bits per sample, channels, and codec are read for the now-playing audio info badge.

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.

• The server binds to your local LAN IP on a random available port. It starts on demand and stops when the app closes.
• Each file is registered with a random opaque token, not its real path. This prevents anyone on your LAN from probing arbitrary paths on your computer.
• Tokens are reused for the same file so repeated plays do not bloat memory.

Audio Hero has two separate features for playing to several devices at once. They work very differently, so pick the one that matches what you want:

• Synced group. Two or more speakers of the same family play exactly the same audio, perfectly in step. This is true multi-room sync and works for HEOS speakers grouped together and for Sonos speakers grouped together.
• Broadcast. The same audio is sent to a mix of different devices at once (for example a HEOS speaker, a Sonos, and an AirPlay receiver). Broadcast devices are kept roughly together rather than perfectly in step, so you may hear a small difference between rooms.

Both live in the Groups tab and both are Pro features.

A synced group links two or more speakers of the same family (HEOS with HEOS, or Sonos with Sonos) so they play the same audio in sync. To create one:

1. Open the Groups tab in the sidebar.
2. Pick a leader player in the dropdown at the top.
3. Check the boxes for every additional player you want to add.
4. Click Create group. The new group appears in the groups list.

Selecting a group makes Audio Hero treat the leader as the playback target while still showing per-member volume sliders so you can trim individual levels.

• Per-member volume. Each group member gets its own slider; changes are sent to that speaker only.
• Match volume. Sync all members to the leader's current level in one click.
• Ungroup. Disbands the group and returns each member to standalone playback.
• Refresh groups. Re-queries the device for the current group layout (useful if you've changed groups in another app).

Broadcast sends whatever Audio Hero is playing to several devices at once, even when they are different brands. Unlike a synced group, the devices are kept roughly together rather than perfectly in step. It is the way to play to a mix of platforms at the same time.

1. Open the Groups tab and find Broadcast to multiple devices.
2. Tick Enable broadcast, then check the extra devices you want to include.
3. Play something on your main device as usual, or click Apply to current to fan out what is already playing. Stop ends the broadcast on the extra devices.

A few platform notes:

• Chromecast: one Cast device or Cast group per broadcast.
• Roku: needs the free Media Assistant channel installed on the Roku.
• Amazon Echo: Alexa only accepts a stream from a public internet (HTTPS) source.

Synced group means perfectly in step, same family only. Broadcast means play to a mix of devices at once, kept roughly together.

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.

• Rename. The ✎ icon opens a dialog where you set a friendly name (up to 64 characters) that overrides the device's own name throughout the app. Leave blank to revert.
• Reboot. The ⟳ icon power-cycles the device after a confirmation prompt. If you reboot the device Audio Hero is currently connected to, the connection drops automatically and reconnects after about 30 seconds.

For HEOS integrated amps (Denon PMA-900HNE, HEOS Link, HEOS Drive, and similar), Audio Hero offers a simplified control panel:

• Identity. Device name, model, IP address, and a "Volume only" note where applicable.
• Rename. Set a friendly name (local label only).
• Power. Toggle on or standby. Shows the current state.
• Input source. Buttons for every input the amp exposes: Phono, CD, Analog 1/2, Optical 1/2, Coaxial 1/2, Bluetooth, AUX, etc. Audio Hero merges the inputs the firmware reports with a per-model catalog so missing inputs still show up.

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

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.

"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.

1. Open the Settings tab.
2. Enable Include support for legacy 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.

Click the ⚙ gear on a legacy device in the sidebar to open its settings panel:

• Friendly name. Rename for local display.
• Mirror volume from. Pick a HEOS player to follow. Volume, mute, and power changes on that HEOS device are mirrored to the legacy receiver.
• Max volume cap. A per-device safety ceiling from 10 to 100 percent.
• Default input on power-on. The input the device switches to whenever it wakes (Phono, CD, AUX, etc.). Leave blank to keep whatever input was last selected.
• Status. Read-only display of current power, volume, and mute state.

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.

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 Sonos, Chromecast / Google Cast, DLNA / UPnP renderers, AirPlay and AirPlay 2, Yamaha MusicCast, Roku, Onkyo / Integra, Snapcast, and Amazon Echo. Each appears in the Players list next to your HEOS devices, with its own ⚙ gear settings and a power button.

1. Open the Settings tab and click 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). 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, Amazon Echo). The ⚙ gear opens a per-device panel for volume, mute, and renaming, plus a fuller set of controls on receivers.

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. Support is still being refined and may be incomplete on some models.

• Setup: tick Support Sonos devices in Device support selection, then open the Players tab and click Discover Devices. No app, account, or extra software is needed.
• Power button: greyed out. Sonos exposes no network power-off; speakers stay in low-power standby. Unplug to fully power down.

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.

• Setup: tick Support Chromecast devices, then Discover Devices. Cast devices and groups appear next to your HEOS players.
• Power button: greyed out. The Cast protocol has no power-off; power the device down from the device itself or the Google Home app.

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.

• Controls: volume and mute where the device exposes them, plus play / pause / stop.
• Setup: tick Support DLNA devices, then Discover Devices. Anything that advertises a UPnP MediaRenderer should appear.
• Power button: mapped to "Stop playback on this device". DLNA renderers have no network standby.

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.

• Setup: tick Support AirPlay devices, then Discover Devices.
• AirPlay 2-only devices such as HomePods need a pairing handshake that may not succeed with every device.
• Power button: mapped to "Stop playback on this device". AirPlay receivers have no network standby.

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.

• Controls: volume, mute, input selection, and a real power toggle per zone, each with its own gear settings and power button.
• Setup: tick Support Yamaha MusicCast devices, then Discover Devices. Each zone appears as its own device.
• Power button: a real network standby toggle (green when on, red in standby).
• Pro Zone power and the zone settings panel are a Pro feature. Discovery and basic playback work on the free tier.

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.

• Setup: tick Support Roku devices, then Discover Devices.
• To play Audio Hero's own audio to a Roku, install the free Media Assistant channel from the Roku Channel Store, then enable Settings › System › Advanced system settings › Control by mobile apps on the device.
• Power button: a real power command on Roku TVs (green / red); on sticks and boxes, which have no network standby, it stops playback.
• Pro The on-screen remote and Roku TV power are a Pro feature.

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.

• Controls: power, volume, mute, input selection, listening mode, tone, options, and Zone 2, wherever the receiver exposes them.
• Setup: tick Support Onkyo receivers, then Discover Devices.
• Power button: a real network power toggle over eISCP.

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

• Controls: volume, mute, soft on / off, and per-client latency.
• Setup: tick Support Snapcast devices, then Discover Devices. If a server is not found automatically, type its host name or IP (control port 1705) into the box that appears and click Add server.
• Power button: mapped to a soft on / off (client mute): green when on, red when muted.
• Playing Audio Hero's own audio to Snapcast is planned for a later update; for now Snapcast support is control only.

Audio Hero controls Amazon Echo devices through a separate Alexa bridge service that you run on your own network. Audio Hero never signs in to Amazon directly and never stores your Amazon password: the bridge owns the Amazon account link and the Alexa skill, and Audio Hero is simply a client of the bridge. This separation is what keeps Echo control within Amazon's terms.

The chain looks like this:

Audio Hero  →  Alexa bridge (you run it)  →  Alexa skill / Amazon  →  your Echo

• An Amazon account with one or more Echo devices already set up in the Alexa app.
• An Alexa bridge running on your network (on a PC, NAS, Raspberry Pi, or Docker host) that exposes the small HTTP API Audio Hero expects. The bridge is what handles the Amazon sign-in, the Alexa skill, and the public HTTPS endpoint that Alexa requires.
• A way for the Echo to fetch audio over public HTTPS if you want to play Audio Hero's own sources (local files, internet radio, PC audio). Alexa only plays from reachable https:// addresses on port 443; plain LAN http:// URLs will not work.

The community "Music Assistant Alexa skill prototype" does the heavy lifting (Amazon auth, skill creation, HTTPS proxy). Whatever bridge you run, confirm it answers a status check and a device list before continuing.

Audio Hero talks to the bridge over plain JSON, with optional HTTP Basic auth. The bridge must answer these endpoints:

1. Open the Settings tab and click Device support selection.
2. Tick Support Amazon Echo devices (experimental). A configuration panel appears.
3. Fill in the Alexa bridge URL, for example http://localhost:5000 or http://192.168.1.50:5000.
4. If your bridge is protected, add the Basic auth username and password. The password is stored encrypted on your PC (Windows DPAPI) and is never synced.
5. Optionally set the Alexa locale (for example en-US).
6. Optionally set a Public HTTPS stream URL so Audio Hero rewrites its own local stream links to an address Alexa can reach (see below).
7. Click Test connection. You should see "Connected to bridge, N Echo device(s) found."
8. Back on the Players tab, click Discover Devices, then click an Echo to connect. Pick a source and play.

Controlling volume, mute, and play / pause works as soon as the bridge is reachable. Playing Audio Hero's own sources (local files, internet radio, PC audio) is different: Alexa can only fetch audio from a public https:// address, while Audio Hero's built-in stream server uses plain LAN http://. You have two ways to bridge that gap:

• Let the bridge proxy it. If your bridge already exposes Audio Hero's stream over HTTPS, leave the Public HTTPS stream URL field empty.
• Give Audio Hero a public HTTPS base. Put a reverse proxy with a valid certificate (Caddy, Nginx, Cloudflare Tunnel, etc.) in front of this PC, then enter that base URL. Audio Hero rewrites its local stream links to it automatically.

If neither is set up, control still works, but starting a stream shows a clear "Alexa needs a public HTTPS source" message instead of playing.

• Power button. Shown greyed out. Alexa has no network power-off, so Echo devices stay in standby to respond to voice instantly. Unplug the device to fully power it down.
• Next / previous. Driven by Audio Hero's own queue, not the Echo, because Audio Hero hands the bridge a single stream at a time.
• Rate limits and state lag. Sending commands very rapidly can be throttled by the Alexa API, and reported state may briefly differ from reality.
• "Could not reach the Alexa bridge." The bridge is not running, or the URL or credentials are wrong. Open .../api/status in a browser to check.
• No devices found. The bridge is up but returned no devices. Re-check the Amazon account link inside the bridge.
• Control works but streams will not play. The public-HTTPS requirement above is not met yet.

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

• Track summary / song description.
• Artist biography.
• Facts such as genre, release year, country of origin, and album info.
• A clearly labeled "Data from" line listing every contributing service with a clickable link.
• A "Cover from" line crediting the source of the artwork.

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.

• Hide the panel. Uncheck Show track info above the now-playing area.
• Disable TheAudioDB. Toggle EnableTheAudioDbMetadata in settings.json if you prefer Deezer/Wikipedia/MusicBrainz only.
• The panel is hidden automatically for local files (which use embedded tags) and for legacy receivers (which are volume-only).

The artwork tile rotates between two faces:

• Front: Album / track artwork.
• Back: Service logo or station / radio image.

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.

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

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.

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.

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:

• Album art, title, artist, album.
• Previous / Play / Pause / Next buttons.
• Mute and volume slider.
• "Open Audio Hero" link and "Exit" link.

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.

Enable Remember last view on exit in Settings so Audio Hero reopens in whichever view (full, compact, or ultra-compact) was active when you last closed it. When disabled, the app always opens in full view.

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.

Automations let Audio Hero act on a schedule, even when the app is closed. Each one is backed by a Windows scheduled task, so it runs at the time you set without Audio Hero needing to be open.

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

• Device. Which device the automation acts on. Automations work with every device type Audio Hero controls - HEOS, Sonos, Chromecast, Onkyo, DLNA, AirPlay, Yamaha MusicCast, Roku, Amazon Echo and Snapcast - though the actions available depend on the device (see the table below).
• Action. Start a source, stop playback, power the device on, or power it off. The editor only offers the actions the selected device supports.
• Source and volume. For Start a source, pick a starred favorite to play and, optionally, a volume to set first. On non-HEOS devices the list is limited to saved internet-radio stations (see below).
• Time and days. The hour and minute, and which days it repeats - every day, weekdays, weekends, or a custom set.
• Wake the computer. Optionally allow the task to wake your PC from sleep so the automation can run.
• Quit after running. If the automation started Audio Hero, optionally have it close again once the action is done. Audio Hero never closes a session you are actively using.

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.

HEOS devices can start any starred favorite. Every other ecosystem can start a saved internet-radio favorite (a direct stream URL), because services like Spotify, Tidal and TuneIn playlists rely on the HEOS browse catalog, which those devices do not share. Stopping playback works everywhere. Power on / off is only possible on devices that expose network power - HEOS AVRs and integrated amps, and Onkyo receivers - and is a Pro feature.

• Audio Hero account (cloud sync). Sign in with a Microsoft account to sync your settings, votes, starred favorites, saved streams, and source order across PCs. Includes Sync now, Sign out, and a Choose what to sync list so you can include or exclude individual categories. Pro feature; see Pro vs Free and Privacy and data.
• Device accounts. Manage sign-ins for the device platforms Audio Hero controls (HEOS today, with room for more later). Opens the Device Accounts dialog where you sign in to or out of your HEOS account.

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.

Hidden in shipping builds. Only visible when Audio Hero is built in DEBUG mode.

• Debug - Simulate devices. Injects a fake CEOL Piccolo (legacy volume-only) and a fake PMA-900HNE (full HEOS amp with Phono, CD, and Optical inputs) into the Players list so both UX paths can be exercised without real hardware. All commands stay in memory and are never sent over the network. The toggle is always reset to off at startup.

Audio Hero is distributed exclusively through the Microsoft Store. Updates are delivered as new Store packages. There are three states the update banner can show:

1. Update available. A new version is available. Click Update Now to download it, or ✕ to dismiss until later.
2. Downloading. A progress bar shows the download. Audio Hero stays usable while this runs.
3. Update installed. The update is staged. Close and reopen Audio Hero to apply it; click Close now to do so immediately. After applying, the app auto-relaunches.

You can always force a check with the 🔄 icon in the header. A check is also performed every time the app starts.

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).

• Full HEOS device discovery and connection.
• Play, pause, stop, next, previous, repeat, shuffle.
• Volume slider, mute, basic per-device volume memory.
• Music sources browsing (Spotify, Tidal, Amazon Music, TuneIn, Internet Radio, etc.).
• YouTube Music and Apple Music streamed from your PC to your device.
• HEOS + PC: play a web music service on your PC and your device at the same time.
• Search across HEOS services, plus YouTube Music and Apple Music.
• Starred favorites.
• Internet radio (custom streams and catalog browser).
• Scheduled automations (start a source, stop, or power on / off on a timer).
• Sleep timer.
• Thumbs up / thumbs down with optional skip-on-down.
• Album artwork tile with customization.
• Renaming and rebooting devices.
• Sign-in / sign-out for HEOS music services.
• App and firmware update notifications.

• Create and play on HEOS receiver groups (multi-room sync).
• Full receiver controls (AVR power, inputs, surround modes, Audyssey, channel levels, multi-zone, tuner, system settings).
• HEOS amp controls (PMA-900HNE, HEOS Link, etc.) with power and input source switching.
• Compact view and ultra-compact view.
• Minimize to tray with mini player.
• Play local files and folders (MP3, FLAC, WAV, AAC, M4A, WMA, OGG, ALAC).
• Audio input monitoring and detailed audio info badge.
• Precision volume control: type the exact volume value.
• Volume presets (six slots) with auto-sort and drag-to-reorder.
• Volume max cap for safety.
• Track info panel with combined data from TheAudioDB, Deezer, Wikipedia, and MusicBrainz.
• Cloud sync between your PCs. Sign in with a Microsoft account and your settings, votes, starred favorites, saved streams, and music-source order stay in sync. Data lives in a private folder inside your own OneDrive - never on an Audio Hero server.

Upgrade from inside the app on a Store install, or visit the Microsoft Store listing directly.

• HEOS commands go only to your local HEOS devices (TCP port 1255).
• SSDP discovery goes only on your local subnet (UDP 239.255.255.250:1900).
• Legacy device commands (volume / mute / power) go only to your local Denon / Marantz device (HTTP ports 8080 / 80 or telnet 23).
• The embedded local file HTTP server serves only your selected audio files and only to the LAN IP of your HEOS device.
• The YouTube Music, Apple Music, and HEOS + PC sources open the chosen service's own website in a built-in browser window, signed in with your own account for that service. That sign-in is kept in a private browser profile on your PC. Audio Hero captures the audio locally and streams it to your device over the LAN; nothing is routed through an Audio Hero server.
• Track info lookups (Pro) are anonymous HTTPS GET requests to TheAudioDB, Deezer, Wikipedia, and MusicBrainz. No accounts, no personal data, no analytics.
• Internet radio catalog searches go to radio-browser.info (anonymous).
• Update checks go to the Microsoft Store.
• If you enable the optional Pro cloud-sync feature, sign-in goes to login.microsoftonline.com and a single audiohero-sync.json file is read and written via Microsoft Graph inside a private app folder in your own OneDrive. Audio Hero has no servers and never sees the file.

Audio Hero collects no 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). The app has no Audio Hero account system; the optional cloud-sync feature uses your own Microsoft account. Full Privacy Policy.

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.

• Confirm the device is on the same subnet as your PC. SSDP multicast does not cross VLANs by default.
• Some VPN and Hyper-V virtual adapters can capture multicast. Try disabling them temporarily.
• Try entering the device IP directly in the Or enter IP address field.
• Confirm UDP port 1900 and TCP port 1255 are not blocked by your firewall.
• If you have many adapters, Audio Hero broadcasts on every active non-loopback, non-tunnel adapter automatically. Discovery still has a 6-second window.

• HEOS devices accept only one CLI connection at a time. Close other HEOS controller apps and try again.
• Reboot the device using the ⟳ icon in its sidebar entry.
• Try a manual connect by IP. If the IP has changed, run discovery again.

• Shuffle / repeat / thumbs / seek: The current source does not support that operation. Pandora, SiriusXM, and similar radio-style services have limited controls by design.
• Pro features: Free edition. A small lock badge marks Pro controls.
• Receiver / amp panel: The selected player is not a HEOS-equipped AVR or amp.

• Audio Hero waits up to 15 seconds for metadata, retries once more, and then shows "unavailable" if all sources fail.
• Click Try again to retry without changing tracks.
• Tracks with unusual tag spellings sometimes do not match cleanly in any of the four services.
• Local files use embedded tags only; the panel is hidden for them.

• The HEOS device must be able to reach your PC over the LAN. Check that your PC firewall is not blocking the random local port the file server picked.
• If your PC has multiple network adapters and is auto-detecting the wrong one, the URL the speaker receives will be unreachable. Disable unused adapters as a workaround.
• Confirm the file format is in the supported list. Some odd container variants may not stream.

• Updates require Audio Hero to be installed from the Microsoft Store (the portable EXE has been discontinued).
• Make sure Microsoft Store updates are not blocked at the OS level.
• Sometimes a Store cache reset (wsreset.exe) fixes stuck updates.

Email bommerts@outlook.com or post on the r/AudioHero subreddit. Attaching the diagnostics log (see below) is very helpful.

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

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