Skip to content

Akintayo74/Prometheus

Repository files navigation

Prometheus

You made a promise to yourself. Prometheus makes that promise unbreakable.

Prometheus is a free, open-source tool that blocks access to pornographic content at the system level. No surveillance. No accountability partners. No shame. Just you, a decision you made when you were clear-headed, and a tool that honors that decision even when you're not.


Why Prometheus Exists

Every existing solution treats pornography addiction as a surveillance problem. They take screenshots, email reports to your partner, and treat you like you can't be trusted. Prometheus takes a radically different position: you're an adult who made a promise to yourself, and you deserve a tool that respects that.

Prometheus processes everything locally. No servers. No analytics. No telemetry. No logs of what you tried to access. Your struggle is yours alone.

How It Works

Prometheus operates at the system level, not as a browser extension. It uses defense-in-depth across multiple layers:

  • DNS Filtering — Intercepts DNS queries and blocks resolution of known adult domains before any content can load. Covers every app and every browser on the device.
  • URL Monitoring — Catches what DNS blocking misses, like NSFW content on mixed-use sites.
  • Application Management — Optionally suspend apps with unmoderated adult content. You choose which apps, during setup.
  • Self-Protection — OS-level enforcement prevents circumvention during moments of weakness.

Once activated, protection is irrevocable for the duration you chose. That's the point.

Design Principles

Irrevocability is the product. The lock that can be unlocked during a moment of weakness is no lock at all. Prometheus must survive your worst moments — 2 AM, lonely, exhausted, desperate.

Privacy is sacred. Everything is processed locally. The app knows what to block, not what you did.

Respect, never shame. When Prometheus blocks content, it doesn't wag a finger. It quietly, firmly holds the line. Like a guardrail on a mountain road — you're glad it's there.

No collateral damage. Security measures are scoped tightly to blocking pornographic content. Prometheus will never disable your USB debugging, break your file transfers, or interfere with unrelated device functionality. It protects a promise, not a prison.

Honesty over comfort. Prometheus doesn't pretend to solve addiction. It removes one avenue of acting on it. Recovery is your journey. Prometheus is one tool — a powerful one — but it won't claim to be more than it is.

Platforms

Platform Blocking Method Status
Android VPN-based DNS filtering + Device Owner APIs In development
Linux nftables + systemd service In development
Windows WFP (Windows Filtering Platform) + system service Planned
macOS Network Extension + System Extension Planned
iOS DNS Content Blocker + Supervised Mode Planned

Architecture

prometheus/
  app/               Android app (Kotlin, Jetpack Compose, Device Owner)
  desktop/
    prometheus-core/  Shared Rust library (domain matching, DNS, NTP, timelock, config)
    prometheus-daemon/  Root systemd service (DNS server, nftables, IPC, watchdog)
    prometheus-ui/    Tauri v2 app (React/TypeScript frontend + Rust backend)
    setup/            Install script, systemd units, nftables config
  shared/
    blocklist/        Domain blocklist (single source, all platforms)

The core blocking logic is written in Rust and shared across all platforms. Each platform has a native shell that integrates with OS-level enforcement mechanisms.

Building

Desktop (Linux)

Prerequisites: Rust toolchain, bun

# Build core library and daemon
cd desktop && cargo build --workspace

# Run tests
cd desktop && cargo test --workspace

# Build the UI
cd desktop/prometheus-ui && bun install && bun run build

# Build Tauri app
cd desktop/prometheus-ui/src-tauri && cargo build

# Install (requires root)
cd desktop/setup && sudo ./install.sh

Android

Prerequisites: Android Studio, ADB

The Android app requires Device Owner provisioning via ADB. This is intentional — setup is a deliberate act requiring a computer and intentional effort, not an impulsive app install.

What Prometheus Is NOT

  • Not a parental control app. It's for adults making their own choice.
  • Not a general content blocker. It doesn't block ads, social media, or anything else. One job, done perfectly.
  • Not a recovery program. It doesn't offer therapy, exercises, or community features.
  • Not a surveillance tool. It cannot and will not be adapted to monitor users, report to third parties, or collect data about browsing behavior.

What "Irrevocable" Really Means

Prometheus doesn't claim to make circumvention theoretically impossible — on most platforms, root/admin access can do anything. Instead, it makes circumvention take longer than the urge lasts. Research suggests most compulsive urges peak and subside within 15-30 minutes. If circumvention requires 30+ minutes of deliberate technical effort, Prometheus has done its job.

Contributing

Prometheus is open source because we believe in transparency and trust. If you find a loophole, please report it. Every bypass patched makes the promise stronger for everyone.

When contributing, keep the core philosophy in mind:

  • Protect the promise, never punish the person
  • Scope security tightly — no collateral damage
  • Privacy is non-negotiable
  • Respect the user's autonomy outside of their chosen commitment

Pricing

Free. Forever. No ads.

Prometheus is funded entirely by optional donations from people who found it genuinely useful. No one should have to pay to keep a promise to themselves — especially when the thing they're fighting is free.

License

Prometheus is licensed under the GNU General Public License v3.0. This means you can freely use, modify, and distribute Prometheus, but any derivative work must also be open source under the same license. This ensures Prometheus can never be turned into a closed-source surveillance tool.


Like the Titan who stole fire for humanity — not because humans were weak, but because he believed in what they could become — Prometheus believes in you.

About

A linux desktop and android app made with the sole purpose of making it as difficult as possible to watch porn

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors