HOLOWHAS Home Assistant Plugin

HOLOWHAS Home Assistant Plugin enables seamless integration of HOLOWHAS AVRs and multi-room audio devices into Home Assistant. With this plugin, users can:

• Monitor playback status and zone information for HOLOWHAS devices
• Adjust volume, switch sources, and control multiple zones directly from Home Assistant
• Trigger automation scenes such as Movie Mode, Party Mode, or Relaxation Mode
• Integrate with Home Assistant dashboards and Lovelace UI
• Use example scripts for Python/NodeJS automation

Official HOLOWHAS resources:

• HOLOWHAS Products
• HOLOWHAS Official Website

---

Features

• Home Assistant integration for HOLOWHAS AVRs and multi-room amplifiers
• Zone and playback status monitoring
• Volume control and source switching per zone
• Automation scene triggers: Movie Mode, Party Mode, Relaxation Mode
• Developer-friendly with Python/NodeJS example scripts
• Fully compatible with Home Assistant dashboards and Lovelace cards

---

Installation

Clone the repository and copy the plugin into Home Assistant's custom_components directory:

git clone https://github.com/username/HOLOWHAS-HomeAssistant-Plugin.git
cp -r HOLOWHAS-HomeAssistant-Plugin <home_assistant_config>/custom_components/holowhas/

Restart Home Assistant to activate the plugin.

Configuration

Add the following to your configuration.yaml:

holowhas:
  host: "192.168.1.100"
  api_key: "YOUR_API_KEY"
  zones:
    - name: "Living Room"
      id: 1
    - name: "Bedroom"
      id: 2

Project Structure

HOLOWHAS-HomeAssistant-Plugin/
├─ README.md
├─ LICENSE
├─ custom_components/
│   └─ holowhas/         # Home Assistant plugin code
├─ examples/             # Python/NodeJS automation scripts
├─ docs/                 # Plugin documentation
├─ assets/               # Banner, illustrations
└─ .github/              # Issue & PR templates

Documentation

Official HOLOWHAS Web API PDF Plugin usage examples in examples/ folder (coming soon) Dashboard and Lovelace UI integration guides in docs/ (coming soon)

Contributing

Contributions are welcome! Please see CONTRIBUTING.md (coming soon) for guidelines.

License

This project is licensed under the MIT License. See LICENSE for details.