A very simple REST API to Denon receivers.

The API of the server is defined by the api/server.yml Swagger specification.

• /status: to the get connection status
• /command/PWON: to turn the receiver on
• /command/PW%3F: check the power
• /command/ZM%3F: check the status of main zone

For a list of commands check the Denon AVR Control Protocol (Google!).

The configs/config-template.yml offers a template for the service configuration.

Make sure you that

• you have Go version 1.11 or higher
• your GOPATH and GOROOT environments are set properly.

There is a Makefile provided that offers a number of targets for preparing, building and running the service. To build and run the service against the configs/test.yml configuration, simply call the run target:

make clean run

I currently have a very basic systemd unit file defined under init/api-denon.service. This can be later improved.

Before using the service definition, make sure that you go through the file and update the WorkingDirectory and ExecStart to match your installation.

Once you have the service running on a machine, you can use the following configuration in your Home Assistant's configuration.yaml file to add a power switch for your receiver:

switch:
  - platform: command_line
    switches:
      denon_receiver_switch:
        command_on: "curl -X POST http://<IP-ADDR>/denon/command/PWON"
        command_off: "curl -X POST http://<IP-ADDR>/denon/command/PWSTANDBY"
        command_state: "curl -X POST http://<IP-ADDR>/denon/command/PW%3F | grep PWON" 
        friendly_name: Denon Receiver Switch

Change <IP-ADDR> to the IP address of the machine running the service.

The code is published under an MIT license.

Please report issues or feature requests using Github issues. Code contributions can be done using pull requests.