Update README.md

README.md

@@ -1,2 +1,71 @@
-# Adguard_Block
+# AdGuard Block Page
 
+A custom AdGuard Home blocking page that notifies users when a domain has been blocked and gives them a Tetris game to pass the time.
+
+## Features
+
+- Displays the blocked domain name to the user
+- Retro terminal aesthetic
+- Fully playable Tetris game embedded in the page
+- Leaderboard to track high scores
+
+## Stack
+
+- Python / Flask
+- SQLite (leaderboard scores)
+- Apache with mod_wsgi
+
+## Setup
+
+### Prerequisites
+
+- Python 3
+- Apache with mod_wsgi
+- AdGuard Home configured to redirect blocked domains to this page
+
+### Installation
+
+```bash
+sudo mkdir -p /opt/flaskapp
+sudo python3 -m venv /opt/flaskapp/venv
+sudo /opt/flaskapp/venv/bin/pip install flask
+```
+
+Copy files:
+```bash
+sudo cp app.py /opt/flaskapp/
+sudo cp app.wsgi /opt/flaskapp/
+sudo cp -r templates /opt/flaskapp/
+```
+
+### Apache Configuration
+
+Add a `WSGIScriptAlias` in your Apache config pointing to `app.wsgi`:
+
+```apache
+WSGIScriptAlias /blocked /opt/flaskapp/app.wsgi
+
+<Directory /opt/flaskapp>
+    WSGIProcessGroup flaskapp
+    WSGIApplicationGroup %{GLOBAL}
+    Require all granted
+</Directory>
+```
+
+### AdGuard Home Configuration
+
+In AdGuard Home, set the **Custom blocking page** URL to:
+
+```
+http://192.168.1.189/blocked?domain=%DOMAIN%
+```
+
+## Project Structure
+
+```
+flaskapp/
+├── app.py            # Flask app
+├── app.wsgi          # Apache mod_wsgi entry point
+└── templates/
+    └── blocked.html  # Blocking page with Tetris
+```