Install on Linux

Requirements: a systemd distro, Python 3.12+, root access, and a Telegram account (plus a friend willing to be your accountability buddy).

1. Get the code and dependencies

# Arch
sudo pacman -S python-telethon python-yaml python-cryptography python-gobject gtk4 libadwaita
# Debian/Ubuntu
sudo apt install python3-yaml python3-cryptography python3-gi gir1.2-adw-1 && pip install telethon

git clone https://github.com/eyeofliberty/MassMediaBlock.git
cd MassMediaBlock

2. Telegram credentials

The daemon sends messages as you via a Telethon session. Create API credentials at my.telegram.org, put them in .env (API_ID, API_HASH), and run python3 authorize.py once to sign in — this writes telegram.session.

3. Run the installer

sudo ./install.sh

The installer merges the porn blocklists, asks for your name and your buddy's Telegram @username, generates the local certificate authority for the HTTPS block page, enables the systemd service (starts on every boot), and points system DNS at the local filter — auto-reverting if a DNS test fails, so it can't strand your connection.

4. Check it

mmblock status          # streak, categories, plan, pending approvals
mmblock add reddit.com  # block a site instantly
mmblock-gui             # the GTK4 control panel

Open a blocked site — you should see the block page, and your buddy should get a Telegram message. To remove: ./uninstall.sh restores everything (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