FFFF GitHub - a-irch/RotGuard: A browser extension to reduce social media overconsumption by adding intentional friction. · GitHub
[go: up one dir, main page]

Skip to content

a-irch/RotGuard

Repository files navigation

RotGuard's Logo

RotGuard

A browser extension to reduce social media overconsumption and boost your productivity!

Overview

RotGuard is a browser extension designed to help you regain control over your digital habits.

Instead of blocking websites entirely (which often leads to frustration and instantly disabling the extension), RotGuard adds intentional friction before accessing distracting content.

How it works

  1. The extension injects a blocking UI over the restricted websites.
  2. The user must consciously confirm they want to access the site.
  3. The user has to wait through a mandatory, custom delay.
  4. After the delay, the content is unlocked for a limited "session". Once the time is up, the friction resets!

Features

  • Custom Blocklist: Restrict specific distracting websites.
  • Intentional Delay: Mandatory waiting time before access to break bad habits.
  • Session Durations & Daily Limits: Set custom session lengths and limit how many times you can access a site per day.
  • Usage Statistics: Visualize your browsing habits with a 7-day interactive chart right from the popup.
  • On-Screen Timer: Optionally display the remaining session time directly on the restricted pages.
  • Data Management: Export and import your configuration and statistics via JSON backups.
  • Privacy First: Runs 100% locally in your browser. No tracking, no data collection, no account required.

Installation

From Firefox Add-ons Store

Get it on Firefox

On Chrome / Edge / Brave (Manual Installation)

Option A: The Easy Way (Recommended)

  1. Go to the Releases page of this repository.
  2. Download the latest chrome-mv3-prod.zip file.
  3. Extract the ZIP file into a folder on your computer.
  4. Open your browser and navigate to chrome://extensions/ (or edge://extensions/, brave://extensions/).
  5. Enable Developer mode (usually a toggle in the top right corner).
  6. Click on Load unpacked and select the folder you just extracted.
  7. You're good to go!

Option B: Build from source

  1. Clone the repository :

    git clone https://github.com/a-irch/RotGuard.git
    cd RotGuard
  2. Install dependencies :

    pnpm install
  3. Build for production :

     pnpm build
  4. Load the production build :

    • Go to chrome://extensions/ (or edge://extensions/, brave://extensions/)
    • Enable Developer mode
    • Click Load unpacked
    • Select the build/chrome-mv3-prod folder

About

A browser extension to reduce social media overconsumption by adding intentional friction.

Topics

Resources

Stars

Watchers

Forks

Contributors

0