Hegel Streaming for Home Assistant

Control a Hegel streaming amplifier from Home Assistant over your local network: power, volume, mute, input, playback, now playing and the stream format. No cloud and no account.

Brought to you by HiFiSync, the hi-fi recommendation engine grounded in physics, not opinions. Check how well your Hegel fits your speakers before you buy the next piece.

---

Features

• Found automatically. The amp announces itself on the network; Home Assistant offers to add it. Entering the IP address by hand works too.
• Instant updates. The integration subscribes to the amp's own event stream, so a volume change or a new track shows up in Home Assistant within a fraction of a second.
• Power on and standby from Home Assistant, automations and voice assistants.
• Volume, mute and input, with the input names this model reports (XLR, Analog 1, BNC, Coaxial, Optical, USB, Network on an H400).
• Radio favourites. Stations you add to the amp's airable radio favourites appear in the input list after the inputs. Selecting one starts it, so an automation can play a station.
• Playback for the built-in streamer: play, pause, stop, next, previous (next and previous only while the amp's player offers them: Spotify Connect gives it pause alone, and play on a Spotify stream resumes the Spotify session), with title, artist, album, cover art, streaming service, track length and position.
• Stream format sensors: audio quality (Hi-Res, CD quality, Lossless, Lossy, DSD), codec, sample rate, bit depth, bitrate, streaming service.
• Clear off state. Standby and "not responding" both show the amp as off. A Network sensor tells them apart, and the entities stay usable after a restart even if the amp is switched off at the mains.
• Volume limit. Set a maximum volume so a slipped slider on a phone can never drive the amp to full power.
• English and Polish translations. Diagnostics download for bug reports.

Supported amplifiers

Hegel has two generations of network amplifiers, and they are controlled in different ways.

Streaming generation: this integration

The H150, H200, H400 and H600 run a StreamUnlimited streaming platform. They are set up with the Hegel Control app and have a web client at http://<amp-address>/webclient/. This integration uses the same local web API as that app and web client.

Model	Firmware	Status
H400	1205.1011	Tested
H200	1205.1011	Tested by a user (#1): all features work
H150, H600		Same platform, expected to work, not tested yet

If you own one of the untested models, please report whether it works.

A quick check: if http://<amp-address>/webclient/ opens a Hegel page, the amp is on this platform.

IP control generation: Home Assistant's built-in Hegel integration

The H95, H120, H190, H190V, H390, H590 and Röst are controlled with Hegel's IP control protocol on TCP port 50001, documented in Hegel's IP control code sheets. Use the Hegel integration that ships with Home Assistant. That protocol offers power, volume, mute and input, but no track information or stream format, so this integration would add nothing for those models.

If you try to add one of these older amplifiers to this integration, the setup dialog recognises it (it answers an IP control status query on port 50001) and points you to the built-in integration.

The streaming generation does not implement IP control: on the H400 port 50001 accepts connections but never answers, whether the amp is on or in standby, and Hegel publishes no IP control codes for it. The built-in integration therefore does not work with these models.

Installation

HACS (recommended)

Or by hand:

1. HACS → ⋮ → Custom repositories.
2. Repository https://github.com/zerostorypoints/hegel-home-assistant, type Integration.
3. Install Hegel Streaming and restart Home Assistant.

Manual

Copy custom_components/hegel_streaming into the custom_components folder of your Home Assistant configuration and restart.

Requires Home Assistant 2025.8 or newer.

Setup

After the restart, Home Assistant lists the amp under Settings → Devices & services → Discovered. Click Add.

If it is not discovered (for example when Home Assistant runs in a separate network or VLAN), go to Settings → Devices & services → Add integration → Hegel Streaming and enter the amp's IP address.

Give the amp a fixed address. Reserve its IP in your router (a DHCP reservation or static lease). If the address changes anyway, discovery picks up the new one by itself and Home Assistant shows a notice under Settings → System → Repairs. Without discovery (another VLAN), use Reconfigure on the integration.

The amp must be powered at the mains; standby is enough.

Entities

For an amp named H400:

Entity	What it does
media_player.h400	Power, volume, mute, input (source) and radio favourites, playback, now playing
sensor.h400_audio_quality	Hi-Res, CD quality, Lossless, Lossy, DSD while the streamer plays
sensor.h400_codec	As reported by the stream (Spotify reports none)
sensor.h400_sample_rate	kHz
sensor.h400_bit_depth	bit
sensor.h400_bitrate	kbit/s
sensor.h400_streaming_service	e.g. Spotify
binary_sensor.h400_network	On while the amp answers on the network, standby included

Off, standby and not responding

Situation	Media player	Network
On	on / playing / paused	on
Standby	off	on
Switched off at the mains, unplugged, network down	off	off

Turning on from standby works from Home Assistant. An amp that does not answer cannot be woken over the network; the turn-on action then says so.

Radio favourites

Add a station to the favourites in the Hegel app or the web client (http://<amp-address>/webclient/): Playback → airable Radio → a station → Add to Radio favorites. Home Assistant reads the list while the amp is on, at power on and every five minutes, and lists the stations after the inputs. Selecting a station plays it; the amp switches to its Network input by itself. While a favourite plays, the media player shows it as the current input. An input with the same name as a station takes precedence.

Stream format sensors have a value only while the built-in streamer is playing or paused, not while a physical input (XLR, analog, optical, USB) is in use.

Options

Settings → Devices & services → Hegel Streaming → Configure:

• Maximum volume (10–100, default 100). Home Assistant never sets the volume above it. The amp's remote and front knob are not limited.
• Input names. Give inputs your own names, for example Turntable for Analog 1. The media player's input list and current input use them. The amplifier cannot rename inputs itself.
• Hidden inputs. Leave unused inputs out of the input list.

Input names and hidden inputs appear once the integration has seen the amp switched on.

Examples

Dashboard card:

type: media-control
entity: media_player.h400

Morning radio (the station must be in the amp's radio favourites):

automation:
  - alias: Hegel morning radio
    triggers:
      - trigger: time
        at: "07:00:00"
    actions:
      - action: media_player.turn_on
        target:
          entity_id: media_player.h400
      - wait_template: "{{ not is_state('media_player.h400', 'off') }}"
        timeout: "00:00:30"
      - action: media_player.volume_set
        target:
          entity_id: media_player.h400
        data:
          volume_level: 0.35
      - action: media_player.select_source
        target:
          entity_id: media_player.h400
        data:
          source: Deutschlandfunk

Put the amp in standby when everyone leaves:

automation:
  - alias: Hegel off when away
    triggers:
      - trigger: state
        entity_id: zone.home
        to: "0"
    actions:
      - action: media_player.turn_off
        target:
          entity_id: media_player.h400

With DomoSenso

DomoSenso is an open framework for building a home on Home Assistant from tested components, made by the same team (zerostorypoints/domosenso on GitHub). Its media component already uses this integration, tested with an H400: it names hegel_streaming as the integration to install from HACS, recognises the amplifier among your Home Assistant devices, and feeds the music view of the DomoSenso Frame wall tablet.

In short, with Home Assistant running as a Container:

1. Install this integration through HACS and add the amp in Home Assistant, as above.

2. Clone DomoSenso and start your coding agent in the clone (git, gh, uv and Claude Code or Codex are listed in its README):

   gh repo clone zerostorypoints/domosenso
   cd domosenso
   uv sync
   claude
   

   In Claude Code, type /onboard-home (with Codex, ask it to run the onboard-home skill). The agent scans your Home Assistant (domosenso recommend --from-ha), finds the amp through hegel_streaming and recommends the media component.

3. The agent adds media to your home repository and points it at the hegel_streaming media player. Home Assistant may also create cast and dlna_dmr players for the same amp; those are not the ones to use.

4. domosenso deploy production --plan shows what would change; after your yes, --apply puts it into Home Assistant and domosenso verify checks that everything that worked before still works.

The H400 is the tested model. The catalog does not list the H150, H200 and H600 yet, so the scan shows them as unmatched; DomoSenso's Integrate a device guide adds one, with the Hegel H400 as its worked example.

Hegel on HiFiSync

Components can be checked on HiFiSync before they go into a system: sourced specs, a comparison with other models, and how well an amplifier fits your speakers. Hegel's range, the H150, H200, H400 and H600 included: Hegel on HiFiSync.

Troubleshooting

• Not discovered. Discovery uses mDNS (_sues800device._tcp). It does not cross VLANs without an mDNS reflector. Add the amp by IP address.

• Shows off although it is on. Open http://<amp-address>/webclient/ from the Home Assistant host. If that page does not load, the network path is the problem.

• Bug reports. Download diagnostics from the device page and attach them to an issue. Debug logging:

  logger:
    logs:
      custom_components.hegel_streaming: debug
  

Security

The amp's web API has no authentication by default: anything on your network can control it. This integration only talks to the amp on your local network. Keep the amp off networks you do not trust.

How it works

The integration uses the same local web API as the amp's own web client: /api/getData, /api/setData and the long-polling event queue under /api/event. A full refresh runs every 30 seconds as a safety net; changes arrive through the event queue in between.

---

About HiFiSync

HiFiSync is a hi-fi recommendation engine that scores system synergy with physics instead of adjectives.

• Match — what fits the gear you already own.
• Compare — component A against component B, by the numbers.
• Build — a complete system from scratch in seven steps: topology, then a model for each slot.
• Synergy score — a deterministic readout of 21 physics-based checks across Signal, Room and Character, each one cited. No brand or dealer can buy a better score.
• Sourced specs — every spec links to a primary source, with manufacturer-confirmed and secondary data marked apart.
• Built in Europe — prices in local currencies and availability checked against EU distributors. A catalogue of 1,600+ components from 76 brands, Hegel included.

Build your system on HiFiSync →

Credits

Made by Zero Story Points, the team behind HiFiSync.

Not affiliated with or endorsed by Hegel Music Systems AS. Hegel is a trademark of its owner.

License

MIT