Skip to content

Xerolux/violet-hass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1,553 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

๐ŸŠ Violet Pool Controller for Home Assistant

English | Deutsch

GitHub Release Downloads GitHub Activity License HACS

Discord Community Forum GitHub Sponsor Ko-Fi Buy Me A Coffee PayPal Tesla Referral

Release Management

Turn your pool into a smart pool! Complete local control and monitoring of your Violet Pool Controller โ€“ no cloud, no subscription.

Violet Home Assistant Integration


๐ŸŒŸ Features

Category What's Included
๐ŸŒก๏ธ Climate Control Heater & solar with thermostat and scheduling
๐Ÿงช Chemical Dosing Automatic pH & chlorine with safety limits (standalone dosing supported)
๐Ÿ’ง Filter & Pump 3-speed pump, automatic backwash
๐ŸŠ Cover Weather-dependent cover automation
๐Ÿ’ก LED / DMX 8 controllable scenes, RGB lighting
๐Ÿ“Š Monitoring pH, ORP, temperatures, pressure, flow rate, runtime
โšก Energy PV surplus mode for solar heating
๐Ÿ”’ Security 100% local, SSL/TLS, rate limiting, input sanitization
๐Ÿ”ง Multi-Controller Multiple pools in a single HA instance

โšก Quick Start

1. HACS โ€“ Add Integration

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

HACS โ†’ Integrations โ†’ โ‹ฎ โ†’ Custom Repositories
URL: https://github.com/xerolux/violet-hass  |  Category: Integration
โ†’ Download "Violet Pool Controller" โ†’ Restart HA

2. Set Up Integration

Settings โ†’ Devices & Services โ†’ Add Integration โ†’ "Violet Pool Controller"
Enter host IP (and adjust port if different from 80) โ†’ Select features โ†’ Done!

3. Ready! ๐ŸŽ‰ Your pool is now smart.

Detailed guide โ†’ Installation & Setup


๐Ÿ“– Documentation (Wiki)

The full documentation is available in the Wiki:

Section Pages
๐Ÿš€ Getting Started Installation & Setup ยท Configuration ยท Multi-Controller
๐Ÿ“Š Entities Sensors ยท Switches ยท Climate ยท Device States
โš™๏ธ Automation Services Reference ยท Automation Examples
๐Ÿ”ง Operation Troubleshooting ยท Diagnostics ยท Error Codes ยท FAQ
๐Ÿ” Security Security & SSL ยท Advanced Logging
๐Ÿ‘ฉโ€๐Ÿ’ป Development Contributing ยท API Reference ยท Changelog

๐Ÿ”‘ Requirements

  • Home Assistant 2026.5.0+ (tested up to 2026.x)
  • HACS (Installation guide)
  • Violet Pool Controller accessible on your local network
  • Python 3.14.2+

๐Ÿ’ Support

This integration is developed in my spare time:

GitHub Sponsor Ko-Fi Buy Me A Coffee

  • โญ Star the repository on GitHub
  • ๐Ÿ› Report bugs
  • ๐Ÿ“ข Share with other pool owners
  • ๐Ÿ’ฌ Help others in the Community & Discord

๐ŸŠ About the Violet Pool Controller

Violet Pool Controller

The VIOLET Pool Controller by PoolDigital GmbH & Co. KG is a premium smart pool automation system developed in Germany โ€“ with a JSON API for seamless Home Assistant integration.


Made with โค๏ธ for the Home Assistant & Pool Community

GitHub Discord Email


About

This custom integration allows you to monitor and control your pool equipment using the Violet Pool Controller in Home Assistant. It includes sensors, binary sensors, and switches to track various pool metrics and perform essential operations.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors