Install on Windows

Requirements: Windows 10/11, Python 3.12+ (check "Add to PATH" in its installer), Administrator rights, and a Telegram account.

1. Get the code and dependencies

git clone https://github.com/eyeofliberty/MassMediaBlock.git
cd MassMediaBlock
pip install telethon pyyaml cryptography psutil

2. Telegram credentials

Create API credentials at my.telegram.org, put them in .env (API_ID, API_HASH) in the repo folder, and run python authorize.py once to sign in.

3. Run the installer (as Administrator)

powershell -ExecutionPolicy Bypass -File .\install.ps1

The installer asks for your name and your buddy's Telegram @username, downloads and merges the porn blocklists, installs the local certificate authority for the HTTPS block page, registers the daemon as a startup task (runs as SYSTEM on every boot, plus a health-check task), and points your network adapter's DNS at the local filter — testing resolution first and reverting automatically if it fails.

4. Check it

mmblock status          # streak, categories, plan, pending approvals
mmblock add reddit.com  # block a site instantly

Open a blocked site — you should see the block page and your buddy should get a Telegram message. To remove: run uninstall.ps1 as Administrator (your buddy is notified when protection goes down).

Premium features

mmblock license MMB1.…                                # activate (key from your purchase page)
mmblock schedule add news_en --days mon-fri --from 09:00 --to 17:00
mmblock report week                                   # accountability report
mmblock report auto weekly                            # auto-send to your buddy