refactor: Refactoring most of the project
Some checks failed
🧪 Integration Testing / 🔧 Test Integration (2025.9.4, 3.13) (push) Failing after 24s
Some checks failed
🧪 Integration Testing / 🔧 Test Integration (2025.9.4, 3.13) (push) Failing after 24s
Signed-off-by: Rafal Zielinski <sq4ind@gmail.com>
This commit is contained in:
70
info.md
70
info.md
@@ -1,63 +1,15 @@
|
||||
# 🛡️ AdGuard Control Hub
|
||||
# AdGuard Control Hub
|
||||
|
||||
**Transform your AdGuard Home into a smart network management powerhouse!**
|
||||
The complete Home Assistant integration for AdGuard Home network management.
|
||||
|
||||
## 🎯 What Makes This Special?
|
||||
## Features
|
||||
- Smart client management and discovery
|
||||
- Granular service blocking controls
|
||||
- Emergency unblock capabilities
|
||||
- Real-time statistics and monitoring
|
||||
- Rich automation services
|
||||
|
||||
Unlike the basic AdGuard integration, **AdGuard Control Hub** gives you complete control over every aspect of your network filtering:
|
||||
## Installation
|
||||
Install via HACS or manually extract to `custom_components/adguard_hub/`
|
||||
|
||||
### 🏠 **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! 🚀**
|
||||
Restart Home Assistant and add via Integrations UI.
|
Reference in New Issue
Block a user