denonavr Automation Library

To receive instant updates when the receiver's status changes, you can establish a telnet connection on TCP port 23. This allows you to register a callback that triggers whenever a status change event occurs. Note that receivers typically support only one active telnet connection at a time.

1. Call await d.async_telnet_connect() after setup.
2. Define a callback function with the signature callback(zone, event, parameter).
3. Register the callback using d.register_callback(zone, callback). Use "ALL" as the zone to listen to all events.

import asyncio
import denonavr

d = denonavr.DenonAVR("192.168.1.119")
await d.async_setup()
await d.async_telnet_connect()
await d.async_update()

def update_callback(zone, event, parameter):
    print("Zone: " + zone + " Event: " + event + " Parameter: " + parameter)

d.register_callback("ALL", update_callback)

You can install the denonavr library using pip. Use the standard install command or the --use-wheel flag if preferred.

pip install denonavr
# or
pip install --use-wheel denonavr

The library is designed for asynchronous operation. To use it, instantiate a DenonAVR object with the receiver's IP address, then call await d.async_setup() to initialize the connection. You can use await d.async_update() to refresh the local state of the device before reading properties like volume or power.

import asyncio
import denonavr

d = denonavr.DenonAVR("192.168.1.119")
await d.async_setup()
await d.async_update()
print(d.volume)

Denon receivers allow users to rename or delete input sources. DenonAVRInput handles this through two internal mechanisms depending on the receiver model:

1. AppCommand.xml (AVR-X and 2016+ models): Uses async_get_changed_sources_appcommand to query the device via HTTP for a list of renamed and deleted functions.
2. Status.xml (Older AVR models): Uses async_get_changed_sources_status_xml to parse the status XML for RenameSource and SourceDelete tags.

When async_update is called, these mappings are applied so that _input_func reflects the user's custom names rather than the factory defaults.

Before interacting with the device, you must call async_setup() to load configuration from the receiver. To refresh the current status of all components (input, sound mode, volume, etc.), use async_update(). Both methods are asynchronous and should be awaited.

import asyncio
from denonavr import DenonAVR

async def main():
    avr = DenonAVR(host='192.168.1.100')
    
    # Load configuration
    await avr.async_setup()
    
    # Refresh status
    await avr.async_update()

asyncio.run(main())

To control a Denon AVR, instantiate the DenonAVR class. You can specify the host (IP or hostname), an optional device name, and configuration for timeouts and rate limiting. You can also create additional zone instances by providing a dictionary of zones via add_zones.

from denonavr import DenonAVR

# Basic initialization
avr = DenonAVR(host='192.168.1.100', name='Living Room AVR')

# Initialization with additional zones
avr = DenonAVR(
    host='192.168.1.100',
    name='Main AVR',
    add_zones={'Zone2': 'Bedroom'}
)

The library provides several methods for adjusting audio parameters:

Mute

• await d.async_mute(True): Mutes the audio.
• await d.async_mute(False): Unmutes the audio.

Volume

• await d.async_volume_up(): Increases volume.
• await d.async_volume_down(): Decreases volume.
• await d.async_set_volume(value): Sets volume to a specific level.

Bass and Treble

• await d.async_bass_up() / await d.async_bass_down()
• await d.async_treble_up() / await d.async_treble_down()

# Mute
await d.async_mute(True)

# Volume
await d.async_set_volume(50)
await d.async_volume_up()

# Bass/Treble
await d.async_bass_up()
await d.async_treble_down()

Use the following asynchronous methods to control the power state and input selection of the receiver:

• await d.async_power_on(): Turns the receiver on.
• await d.async_power_off(): Turns the receiver off.
• await d.async_set_input_func("InputName"): Sets the input function (e.g., "Phono", "Tuner").

After sending commands, call await d.async_update() to synchronize the local object state with the device.

# Power control
await d.async_power_on()
await d.async_update()
print(d.power) # 'ON'

await d.async_power_off()
await d.async_update()
print(d.power) # 'OFF'

# Input control
await d.async_set_input_func("Phono")
await d.async_update()
print(d.input_func) # 'Phono'

When initializing DenonAVRTelnetApi, you can configure the following attributes:

When initializing DenonAVRApi, you can configure the following attributes:

To ensure the local state of the DenonAVRVolume object matches the actual state of the receiver, call async_update(). This method handles the underlying communication (AppCommand or Status XML) to refresh all volume-related attributes.

• async_update(global_update: bool = False, cache_id: Optional[Hashable] = None): The primary method to refresh state.
• async_update_volume(...): Specifically refreshes volume-related attributes.

await volume.async_update()