Rafal Zielinski
e29f7c025b
Some checks failed
🧪 Integration Testing / 🔧 Test Integration (2023.12.0, 3.11) (push) Successful in 2m11s
🧪 Integration Testing / 🔧 Test Integration (2023.12.0, 3.12) (push) Successful in 2m2s
🧪 Integration Testing / 🔧 Test Integration (2024.1.0, 3.11) (push) Successful in 1m4s
🧪 Integration Testing / 🔧 Test Integration (2024.1.0, 3.12) (push) Successful in 1m19s
🛡️ Code Quality & Security Check / 🔍 Code Quality Analysis (push) Failing after 56s
Signed-off-by: Rafal Zielinski <sq4ind@gmail.com>
63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
# 🛡️ AdGuard Control Hub
|
|
|
|
**Transform your AdGuard Home into a smart network management powerhouse!**
|
|
|
|
## 🎯 What Makes This Special?
|
|
|
|
Unlike the basic AdGuard integration, **AdGuard Control Hub** gives you complete control over every aspect of your network filtering:
|
|
|
|
### 🏠 **Smart Home Integration**
|
|
- **Individual Device Control**: Every AdGuard client becomes a Home Assistant switch
|
|
- **Service-Level Blocking**: Block YouTube on kids' tablets while allowing it on work computers
|
|
- **Automated Parenting**: Bedtime routines that automatically restrict internet access
|
|
- **Work Productivity**: Focus modes that eliminate distracting websites during work hours
|
|
|
|
### 🎛️ **Rich Dashboard Controls**
|
|
- **One-Click Emergency Override**: Temporary unblock for urgent situations
|
|
- **Family Management Panel**: Control all kids' devices from a single card
|
|
- **Guest Network Controls**: Different rules for visitor devices
|
|
- **Real-Time Statistics**: See exactly what's being blocked and when
|
|
|
|
### 🤖 **Automation Paradise**
|
|
- **Time-Based Rules**: Different restrictions for school nights vs weekends
|
|
- **Presence Detection**: Automatically adjust rules when people arrive/leave
|
|
- **Bulk Operations**: Update multiple devices with pattern matching
|
|
- **Custom Schedules**: Per-device blocking schedules with precise time control
|
|
|
|
## 🛠️ **What You Get**
|
|
|
|
### **Entities Created**
|
|
- `switch.adguard_protection` - Global protection toggle
|
|
- `switch.adguard_client_*` - Individual device protection
|
|
- `switch.adguard_client_*_service_*` - Per-device service blocking
|
|
- `sensor.adguard_*` - DNS statistics and monitoring
|
|
- `binary_sensor.adguard_*` - Status indicators
|
|
|
|
### **Services Available**
|
|
- `adguard_hub.add_client` - Add new devices
|
|
- `adguard_hub.block_services` - Block specific services
|
|
- `adguard_hub.bulk_update_clients` - Manage multiple devices
|
|
- `adguard_hub.emergency_unblock` - Temporary access override
|
|
|
|
## 🎬 **Perfect For**
|
|
|
|
- **Parents** wanting automated screen time controls
|
|
- **Remote Workers** needing focus mode automation
|
|
- **Tech Enthusiasts** wanting complete network visibility
|
|
- **Families** needing different rules for different people
|
|
- **Anyone** who wants their network to be truly "smart"
|
|
|
|
## 📋 **Requirements**
|
|
|
|
- Home Assistant 2023.1+
|
|
- AdGuard Home with API access enabled
|
|
- Admin credentials for your AdGuard Home instance
|
|
|
|
## 🚀 **Quick Start**
|
|
|
|
1. Install via HACS or manually
|
|
2. Add integration: Settings → Devices & Services → Add Integration
|
|
3. Enter your AdGuard Home IP, port, username, and password
|
|
4. Watch as all your devices appear as controllable entities!
|
|
|
|
**Ready to take control of your network? Let's get started! 🚀** |