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