Skip to content

Repository files navigation

Curbox

Curbox Browser

Break the doomscroll.

A browser extension that shows where your time actually goes online. It blocks the sites and feeds that keep pulling you back, and when you hit one it puts a calm breathing screen in the way instead of a hard wall. There is also a Curbox app for Android if you want the same thing on your phone.

Chromium Firefox WXT React TypeScript

Discord · Donate · Android app · Instagram


Features

Usage Stats

See where your time actually goes. Curbox only counts a tab while you are looking at it, so something left open in the background never inflates your numbers. You get today's total at the top, a weekly bar graph you can scroll back through, and a list of sites sorted by time spent. Open any site and it breaks down by path, so youtube.com splits into the videos and the /shorts that quietly ate your afternoon.

Website Blocker

Put websites into groups and combine the same controls used by the Android app:

  • Active hours. Choose all day, one daily schedule, or different ranges by weekday.
  • Usage limits. Count only browsing inside those active hours; a zero-minute limit blocks the whole window.
  • On each open. Curbox stops you once when you enter a group, then asks again after you leave and return.

Keyword Blocker

Block by URL pattern instead of a whole domain, so you can kill the feed and keep the tool. A group can hold keywords like:

  • youtube.com/shorts for one section of a site
  • /reels for a path on any site
  • *.reddit.com for every subdomain
  • r:shorts|reels for a raw regex when you need it

Warning Screen

This is what you hit when you try to get past a block. Instead of a flat wall there is a breathing overlay that asks you to slow down for a second. You decide how hard it pushes back:

  • Never unlock. The block holds and there is no way through.
  • Require effort. Type a sentence, write down why you want in, or solve an adaptive math set.
  • Wait to unlock. A timer runs before the page will open.

You can add your own message, require completed focus time first, and cap how many times you are allowed through, so it stays a pause and not a punishment.

Encrypted Sync

Sync browser settings, focus groups and sessions, and four weeks of browsing usage through the same end-to-end encrypted Curbox account used by Android. Device filters, pairing codes, explicit manual sync, deletions, and account-local device identities follow the Android sync contract.

Installation

Curbox is not on the browser stores yet, so you load it yourself. It takes about two minutes.

npm install        # grab dependencies
npm run build      # Chromium  →  .output/chrome-mv3
npm run build:firefox  # Firefox  →  .output/firefox-mv2

For Chrome, Brave, and other Chromium browsers

  1. Run npm install then npm run build.
  2. Open your extensions page (for example chrome://extensions).
  3. Turn on Developer mode.
  4. Click Load unpacked and pick the .output/chrome-mv3 folder.

For Firefox

  1. Run npm install then npm run build:firefox.
  2. Open about:debugging and click This Firefox.
  3. Click Load Temporary Add-on and pick any file inside .output/firefox-mv2.

Temporary add-ons in Firefox are removed when you restart the browser.

Contributing

Issues, ideas, and pull requests are all welcome. See CONTRIBUTING.md to get set up.

Made by Nethical

About

Open Source Website Blocking extension

Resources

Contributing

Stars

24 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages