Rafal Zielinski
554b8ac16b
Some checks failed
Integration Testing / Integration Tests (2024.12.0, 3.11) (push) Failing after 27s
Integration Testing / Integration Tests (2024.12.0, 3.12) (push) Failing after 56s
Integration Testing / Integration Tests (2024.12.0, 3.13) (push) Failing after 1m38s
Integration Testing / Integration Tests (2025.9.4, 3.11) (push) Failing after 19s
Integration Testing / Integration Tests (2025.9.4, 3.12) (push) Failing after 20s
Integration Testing / Integration Tests (2025.9.4, 3.13) (push) Failing after 25s
Code Quality Check / Code Quality Analysis (push) Failing after 20s
Code Quality Check / Security Analysis (push) Failing after 21s
Signed-off-by: Rafal Zielinski <sq4ind@gmail.com>
64 lines
1.5 KiB
Markdown
64 lines
1.5 KiB
Markdown
# 🛡️ AdGuard Control Hub
|
|
|
|
**The ultimate Home Assistant integration for AdGuard Home**
|
|
|
|
Transform your AdGuard Home into a smart network management powerhouse.
|
|
|
|
## ✨ Features
|
|
|
|
### 🎯 Smart Client Management
|
|
- Automatic discovery of AdGuard clients
|
|
- Per-client protection controls
|
|
- Real-time blocking statistics
|
|
|
|
### 🛡️ Service Blocking
|
|
- Per-client service blocking (YouTube, Netflix, Gaming, etc.)
|
|
- Emergency unblock capabilities
|
|
- Advanced automation services
|
|
|
|
### 🏠 Home Assistant Integration
|
|
- Rich entity support: switches, sensors, binary sensors
|
|
- Automation-friendly services
|
|
- Real-time DNS statistics
|
|
|
|
## 📦 Installation
|
|
|
|
### Method 1: HACS (Recommended)
|
|
1. Open HACS > Integrations
|
|
2. Add custom repository: `https://git.sq4ind.eu/sq4ind/adguard-control-hub`
|
|
3. Install "AdGuard Control Hub"
|
|
4. Restart Home Assistant
|
|
5. Add integration via UI
|
|
|
|
### Method 2: Manual
|
|
1. Download latest release
|
|
2. Extract to `custom_components/adguard_hub/`
|
|
3. Restart Home Assistant
|
|
4. Add via Integrations UI
|
|
|
|
## ⚙️ Configuration
|
|
|
|
- **Host**: AdGuard Home IP/hostname
|
|
- **Port**: Default 3000
|
|
- **Username/Password**: Admin credentials
|
|
- **SSL**: Enable if using HTTPS
|
|
|
|
## 🎬 Example
|
|
|
|
```yaml
|
|
automation:
|
|
- alias: "Kids Bedtime"
|
|
trigger:
|
|
platform: time
|
|
at: "20:00:00"
|
|
action:
|
|
service: adguard_hub.block_services
|
|
data:
|
|
client_name: "Kids iPad"
|
|
services: ["youtube", "gaming"]
|
|
```
|
|
|
|
## 📄 License
|
|
|
|
MIT License - Made with ❤️ for Home Assistant users!
|