master
AdGuard Block Battle Rankings
A Flask dashboard that pulls client block stats from AdGuard Home and displays each client as a ranked anime-tier character card.
Tier System
| Tier | Label | Block Range | Color |
|---|---|---|---|
| 1 | Civilian | 0-50 | Green |
| 2 | Rookie | 51-200 | Yellow |
| 3 | Protagonist | 201-500 | Orange |
| 4 | Hardened Fighter | 501-1000 | Red |
| 5 | Final Boss | 1000+ | Purple |
Setup
-
Install dependencies: pip install -r requirements.txt
-
Set environment variables (or edit app.py directly): export ADGUARD_HOST=http://vpn.umbrellapants.xyz:3000 export ADGUARD_USER=your_username export ADGUARD_PASS=your_password
-
Run: python app.py
Swapping in Character Art
Each tier uses an SVG placeholder. To replace with real images:
- Add your images to static/characters/ named tier1.png through tier5.png
- In index.html, replace the charSVG() call in the card template with:

Deployment with mod_wsgi
Create a wsgi.py at the project root:
from app import app as application
Then point your Apache VirtualHost at wsgi.py.
Auto-refresh
The dashboard polls AdGuard every 60 seconds automatically. Adjust the interval at the bottom of index.html (setInterval line).
Description
Languages
HTML
91.8%
Python
8.2%