67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
# 🛡️ AdGuard Control Hub
|
|
|
|
**The ultimate Home Assistant integration for AdGuard Home**
|
|
|
|
## ✨ Features
|
|
|
|
### 🎯 Smart Client Management
|
|
- Automatic discovery of AdGuard clients as Home Assistant entities
|
|
- Add, update, and remove clients directly from Home Assistant
|
|
- Per-client protection controls
|
|
|
|
### 🛡️ Granular Service Blocking
|
|
- Per-client service blocking for YouTube, Netflix, Gaming, Social Media, etc.
|
|
- Emergency unblock for temporary internet access
|
|
- Real-time blocking statistics
|
|
|
|
### 🏠 Home Assistant Integration
|
|
- Rich entity support: switches, sensors, binary sensors
|
|
- Automation-friendly services
|
|
- Real-time DNS and blocking statistics
|
|
|
|
## 📦 Installation
|
|
|
|
### 🔧 Method 1: HACS (Recommended)
|
|
1. Open Home Assistant and go to **HACS > Integrations**
|
|
2. Click menu (⋮) → **Custom repositories**
|
|
3. Add repository URL: `https://git.sq4ind.eu/sq4ind/adguard-control-hub`
|
|
4. Set category to **Integration**, click **Add**
|
|
5. Search for **AdGuard Control Hub**
|
|
6. Click **Install**, then restart Home Assistant
|
|
7. Go to **Settings > Devices & Services > Add Integration**
|
|
8. Search and select **AdGuard Control Hub**, enter your AdGuard Home details
|
|
|
|
### 🛠️ Method 2: Manual Installation
|
|
1. Download the latest release zip
|
|
2. Extract `custom_components/adguard_hub` into your Home Assistant config directory
|
|
3. Restart Home Assistant
|
|
4. Add integration via UI
|
|
|
|
## ⚙️ Configuration
|
|
- **Host**: IP or hostname of your AdGuard Home
|
|
- **Port**: Default 3000 unless customized
|
|
- **Username & Password**: Admin credentials for AdGuard Home
|
|
- **SSL**: Enable if AdGuard Home runs HTTPS
|
|
|
|
## 🎬 Example Automation
|
|
|
|
```yaml
|
|
automation:
|
|
- alias: "Kids Bedtime - Block Entertainment"
|
|
trigger:
|
|
platform: time
|
|
at: "20:00:00"
|
|
action:
|
|
service: adguard_hub.block_services
|
|
data:
|
|
client_name: "Kids iPad"
|
|
services:
|
|
- youtube
|
|
- netflix
|
|
- gaming
|
|
```
|
|
|
|
## 📄 License
|
|
This project is licensed under the MIT License.
|
|
|
|
Made with ❤️ for Home Assistant and AdGuard Home users! |