Skip to content

ringku1/commitment-timer

Repository files navigation

πŸ”’ Commitment Timer

Browse with intention, not impulse.

A Chrome extension that forces you to commit to a reason before visiting distracting sites like YouTube, Reddit, or Twitter β€” then holds you accountable.

✨ Features

  • πŸ”’ Intercepts distracting sites with a commitment screen
  • ⏱️ Floating countdown timer while you browse
  • 😬 Guilt screen when time's up β€” did you keep your promise?
  • πŸ”₯ Streak tracking β€” consecutive days of kept promises
  • ⏸️ Snooze tax β€” extensions get progressively harder
  • ❄️ Cooldown penalty β€” break a promise, site locked 10 mins
  • πŸ“Š Dashboard with honesty score + 30-day calendar
  • πŸ”” Desktop notifications β€” 1 min warning + time's up alert
  • ⏱️ Overstay detection β€” auto breaks session at 2x committed time
  • 🎨 Consistent design on every site β€” Reddit, YouTube, Twitter etc.
  • πŸ”˜ Enable/disable toggle anytime

🌐 Supported Browsers

Browser Support Install
βœ… Chrome Full support Manual install
βœ… Edge Full support Manual install
βœ… Brave Full support Manual install
βœ… Opera Full support Manual install
βœ… Firefox Full support Firefox Add-ons Store
❌ Safari Not supported Extensions API incompatible

πŸš€ Install Guide

Chrome / Edge / Brave / Opera

Step 1 β€” Download

Step 1 Click the green Code button above β†’ Download ZIP β†’ save to your computer


Step 2 β€” Extract

Step 2 Find the ZIP in your Downloads folder β†’ right-click β†’ Extract All


Step 3 β€” Load in your browser

Step 3 Open your browser and go to the extensions page:

Browser URL
Chrome chrome://extensions
Edge edge://extensions
Brave brave://extensions
Opera opera://extensions
  1. Enable Developer mode (top right toggle)
  2. Click Load unpacked
  3. Select the extracted Commitment Timer folder
  4. βœ… Done!

🦊 Firefox

Install directly from the Firefox Add-ons Store β€” no manual setup needed:

πŸ‘‰ Install for Firefox


🌐 Blocked Sites (default)

YouTube Β· Reddit Β· Twitter Β· Instagram Β· TikTok Β· Facebook Β· X

You can add/remove sites via the extension settings βš™οΈ

πŸ›‘οΈ Privacy

Everything stays on your device. No data is collected or transmitted ever.

Privacy Policy

πŸ“„ License

MIT

About

A Chrome extension that forces you to commit before visiting distracting sites

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors