Skip to content

f1shy-dev/distracted

Repository files navigation

distracted! - "block distracting websites! do mini tasks to get back on them..."

Chrome Web Store Firefox Add-ons

what?

  • blocks websites that distract you
  • multiple unlock challenges (more soon):
    • timer
    • hold button
    • typing something random (no copy/paste)
    • solving a math problem
    • active blocking when Claude Code is inactive
  • (optionally) track your visits and success rate
  • all data stays local on your device

how to install

chrome/chromium: install from the chrome web store

firefox: install from firefox add-ons

manual install (all browsers/dev builds):

  1. download the latest release from releases
  2. unzip the file
  3. load it in your browser:
    • chrome/chromium-based browsers: go to chrome://extensions/, enable "developer mode", click "load unpacked", select the unzipped folder
    • firefox/firefox-based browsers: go to about:debugging, click "this firefox", click "load temporary add-on", select the manifest.json file from the unzipped folder
  4. done! configure which sites to block in the extension popup

why?

mindless visiting is more and more common. you end up idling, and then end up on a site you didn't want to be on in the first place.

the idea of this extension is to give you a boring, non-stimulating task. having to wait, hold the button or so on is like giving your mind time to think about what you're doing consciously, or making it annoying enough that you don't want to do it.

it's similar to not remembering/saving your payment details, so you have to find your physical card/wallet when doing online purchases; giving a second chance to rethink your purchase

but... can't i just delete the extension?

yes! you could also just not install it! there is only so many layers of annoyance you can add[1], after which it becomes more about your own self-control than what the technology can do for you.

...but if you do have an idea for how it could be more useful for you, open an issue and let me know!

[1] ideas

how to build

environment

  • operating system: Ubuntu 24.04 LTS (or compatible Linux distribution)
  • package manager: Bun 1.3.6 or later
  • node.js: v25.2.1 or later (required by Bun)

instructions

  1. install bun (if not already installed):

    curl -fsSL https://bun.sh/install | bash

    or follow the official installation guide: https://bun.sh/docs/installation

  2. verify bun installation:

    bun --version
    # should output: 1.3.6 or later
  3. install project dependencies, and build the extension:

    bun install --frozen-lockfile
    # extension code is self-contained in the packages/extension folder.
    cd packages/extension
    bun run zip # for chrome
    bun run zip:firefox # for firefox
  4. outputs (for release or inspection/review):

    • chrome:
      • packages/extension/.output/chrome-mv3/
      • packages/extension/.output/distractedextension-<version>-chrome.zip
    • firefox:
      • packages/extension/.output/firefox-mv2/
      • packages/extension/.output/distractedextension-<version>-firefox.zip
      • packages/extension/.output/distractedextension-<version>-sources.zip

About

blocks distracting websites! annoy you to get back on them...

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 5