Home Assistant integration for R_volution players

This integration will interface with the R_volution player series by R_volution. This repository delivers the latest features via HACS. You can use it for testing until I can get the integration accepted to HA core (no timeline for that, sorry).

If you encounter problems, please file an issue at the integrations issue tracker. If possible, add a diagnostics dump always. This is important also for enhancements if they target new data or information to be retrieved from the unit to see what it has to offer. Always check that dump if you want to further redact information in it. The MACs and the units serial number are redacted already, but check for yourself! If you find information in the dump that you consider private, please file a bug request so that I can update the anonymizing code.

• Disclaimer
• Installation
  • HACS Installation
  • Manual Installation

Disclaimer

This integration is provided without any warranty or support by R_volution (unfortunately). I do not take responsibility for any problems it may cause in all cases. Use it at your own risk.

Installation

The recommend way to install this extension is using HACS. If you want more control, use the manual installation method.

HACS Installation

1. Go to HACS -> Integrations
2. Click the Triple-Dot menu on the top right and select Custom Repositories
3. Set https://github.com/volkerrichert/ha_R_volution_player.git as repository name for the category Integrations
4. Open the repository (it will be displayed by default), select Download and confirm it
5. Restart Home Assistant
6. In the HA UI go to Configuration -> Integrations click "+" and search for "R_volution Player"

Manual Installation

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called e3dc_rscp.
4. Download all the files from the custom_components/r_volution_player/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant
7. In the HA UI go to Configuration -> Integrations click "+" and search for "R_volution Player"

Configuration

Once you add the integration, you'll be asked to authenticate yourself for a connection to your R_volution .

• Username: Your r_volution user name
• Password: Your r_volution password
• Hostname: The Hostname or IP address of the r_volution player
• API key: Your api key for R_volution api calls. It can be requested as decribed in the first steps documentaion

---