Home Assistant Integration for Marantz/Denon AVR

A Home Assistant custom integration to control Marantz and Denon AVR receivers using the aiomadeavr library.

Features

• Auto-Discovery: Automatically detects AVR devices on your network via SSDP
• GUI Configuration: Easy setup through the Home Assistant UI (manual IP entry also supported)
• Multi-Zone Support: Control Main Zone, Zone 2, and Zone 3 as separate entities
• Push Updates: Real-time state updates via the AVR's telnet connection (no polling)
• Full Media Player Support:
  • Power on/off
  • Volume control (set, up/down, mute)
  • Source selection
  • Sound mode selection (main zone, optionally for other zones)

Installation

HACS (Recommended)

1. Open HACS in Home Assistant
2. Click on "Integrations"
3. Click the three dots in the top right corner
4. Select "Custom repositories"
5. Add https://github.com/frawau/ha-aiomadeavr as a custom repository (Category: Integration)
6. Click "Install"
7. Restart Home Assistant

Manual Installation

1. Copy the custom_components/aiomadeavr folder to your Home Assistant's custom_components directory
2. Restart Home Assistant

Configuration

Auto-Discovery

Home Assistant will automatically detect Marantz/Denon AVR devices on your network. When a device is discovered, you'll see a notification in Settings > Devices & Services to confirm the setup.

Manual Setup

1. Go to Settings > Devices & Services
2. Click + Add Integration
3. Search for "Marantz/Denon AVR"
4. Enter the IP address of your AVR
5. Optionally provide a custom name

Entities

The integration creates media player entities for:

Entity	Description
Main Zone	Primary media player with full sound mode support
Zone 2	Secondary zone (if available on your AVR)
Zone 3	Third zone (if available on your AVR)

Options

After setup, you can configure additional options:

• Enable sound mode control for Zone 2: Allow changing sound mode from Zone 2 entity
• Enable sound mode control for Zone 3: Allow changing sound mode from Zone 3 entity

Note: Sound mode is typically a global setting on the AVR, so changing it from any zone affects all zones.

Supported Features

Main Zone

• Turn on/off
• Volume set/step/mute
• Source selection
• Sound mode selection

Zone 2 & 3

• Turn on/off
• Volume set/step/mute
• Source selection
• Sound mode selection (optional, via configuration)

Troubleshooting

Cannot Connect

• Ensure the AVR is powered on and connected to your network
• Verify the IP address is correct
• Check that port 23 (telnet) is not blocked by a firewall
• Some AVRs require "Network Standby" to be enabled in the settings

Entity Shows Unavailable

• The AVR may have disconnected. Check network connectivity
• Try power cycling the AVR
• Reload the integration from Settings > Devices & Services

Requirements

• Home Assistant 2023.1 or newer
• Marantz or Denon AVR with network/telnet support
• aiomadeavr library (automatically installed)

License

MIT License - see LICENSE for details.

Credits

This integration uses the aiomadeavr library for communication with AVR devices.