https://github.com/andrewsomething/site-limiter-chrome-ext
A Chrome extension that limits how long you spend on distracting websites.
https://github.com/andrewsomething/site-limiter-chrome-ext
Last synced: about 1 month ago
JSON representation
A Chrome extension that limits how long you spend on distracting websites.
- Host: GitHub
- URL: https://github.com/andrewsomething/site-limiter-chrome-ext
- Owner: andrewsomething
- Created: 2026-05-25T19:19:39.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-25T19:38:55.000Z (about 1 month ago)
- Last Synced: 2026-05-25T21:26:59.938Z (about 1 month ago)
- Language: JavaScript
- Size: 261 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Site Limiter
A Chrome extension that limits how long you spend on distracting websites. After your watch limit is reached, the site is blocked for a configurable cooldown period.
## Features
- **Per-site time limits** — track and enforce limits independently per site
- **Configurable limits** — set your own watch limit and cooldown duration
- **Cooldown blocking** — overlay blocks the page until the cooldown expires, with a live countdown
- **Multi-site support** — comes with defaults for YouTube Shorts, Reddit, X/Twitter, TikTok, and Instagram Reels
- **Custom sites** — add any site using URL glob patterns (e.g. `reddit.com/*`)
- **Subdomain matching** — patterns match across subdomains (e.g. `old.reddit.com`)
- **Per-site reset** — manually reset a site's timer at any time
- **System theme** — follows your OS light/dark mode preference
## Installation
1. Clone or download this repo
2. Open `chrome://extensions` in Chrome
3. Enable **Developer mode** (top right)
4. Run `npm install && npm run build` to install dependencies and copy vendored assets
5. Click **Load unpacked** and select the `extension/` subdirectory
## Usage
Click the extension icon to open the popup:
- **Status tab** — see time used per site, reset individual sites, and open the Stats page
- **Sites tab** — enable/disable sites and add custom ones
- **Settings tab** — configure the watch limit and cooldown duration
The **Stats page** shows 30 days of per-site usage history with time spent and blocks triggered per day.
## Development
```bash
npm install # installs deps and copies vendored assets (via prepare)
npm test # run unit tests
npm run lint # ESLint
npm run format # Prettier
```
A pre-commit hook runs ESLint and Prettier automatically via husky + lint-staged.
### Project structure
```
extension/ # Chrome extension source (load this folder in Chrome)
manifest.json
background.js
content.js
popup.html / popup.js
lib/utils.js
icons/
tests/ # Jest unit tests
```