Custom Web Blocker

Home

Block distractions.
Keep your focus.

Browser extension plus native blocking for Mac and iOS. Schedules, timers, strict freeze, and custom JavaScript rules.

Pan around to find downloads and docs.

Statistics

Global Statistics

Anonymous, aggregate counts — sampled once an hour. Nothing here is tied to a name or account.

Loading statistics…

100% free

Free. For real.

Everything here is free to use — and I want to be specific about exactly what that means.

  • Completely free. No one-time purchase, no freemium tiers, no subscriptions — not now, not later.
  • No advertisements. Nothing is injected into your browsing: no banners, no sponsor slots, no “promoted” anything.
  • Never shared, never monetized. We will never share your data with third parties or generate revenue from it. You can optionally opt in to anonymously share channel ids — only the id, never titles or watch history — to help classify creators for everyone.
  • No hidden monetization. No trackers, no affiliate funnels, no data brokering quietly running in the background.
  • Open source. Every line is public, so you can verify all of this yourself instead of taking my word for it.
  • Donations only — and optional. The single way I’d ever earn from this is a spontaneous donation. It will always work fully without one.

Why I can keep it free

The servers barely cost anything. The site itself is just static files, which a CDN serves for $0. The only running piece is the creator-tag API — a small database plus a lightweight server that fits on a roughly $5–15/month machine at hobby scale. Even the tag system stays cheap: each video or channel is classified once by a batched AI pass over its title (well under a cent per item) and the label is cached forever, so that cost never repeats. Day to day it’s dominated by a tiny database, not the AI.

Code costs nothing to copy. Unlike a physical product, handing the app to one more person costs essentially nothing — no manufacturing, no inventory, no shipping. Ten users or ten thousand, my effort is the same, so there’s no honest reason to charge per copy.

I’m a high-school student, and this is my first real project. I built it for myself and for people who just want to focus — not to run a business. I’d much rather it be genuinely free and useful. If it helps you and you feel like chipping in one day, that’s welcome, but it will always work fully without it.

Manual

Instruction Manual

YouTube

Creator Tag System

Checking API…

Tag Tree

Loading tags…

Tip: click any tag to highlight the tags it co-occurs with. Toggle Heatmap to see coverage.

Creators

Loading creators…

Classification Queue

The browser extension discovers channels automatically as you watch YouTube (only the channel id is shared, when you opt in there). They flow through the pipeline: looking up → sub count fetched in batches → queued for tag classification → tagged into the public Creators list.

Loading the queue…

Contribute Channels

Paste YouTube channel links or IDs (one per line). They're queued for automatic classification — we never store anything but the channel id.

Similar Creators

Click a creator on the left to see who's most alike (by shared tags).
App

Blocker App

Extension

Browser Extension

What this is, in one minute

This is a focus toolkit that blocks websites, apps — really anything that pulls you off track. It comes in two programs that look and work almost the same, so once you learn one you already know the other.

Everything you do happens inside block groups: small, self-contained rule sets you turn on and off. You never need an account, and nothing you set up leaves your device.

Browser extension Lives in Chrome, Edge, Brave or Firefox. It blocks websites — whole sites, specific pages, feeds, Shorts, and more — right inside the browser.
App (macOS) A native Mac app that blocks applications system-wide — chat apps, games and the like — no matter how you try to launch them. Websites stay with the extension; the two can share one limit through the bridge.
02 · The layout

The two-panel window

Both programs open to the same screen: a list of your groups on the left, and an editor on the right that shows whichever group you've selected.

Click a group on the left to load it on the right. Everything you change in the editor applies to that one group only — so you can keep, say, a strict “Work” group and a gentler “Evening” group at the same time.

03 · The core idea

Block groups

A block group is one bundle of rules with its own name and on/off switch. You can have as many as you like, and they're shown as a list you can scroll through.

Why groups instead of one big list?

Because different situations need different rules. A group can hold the sites to block, a schedule, a time budget, and more — all toggled together. Turn the group on and the whole bundle takes effect.

They're checked top to bottom

When you open a page, the engine walks your groups from the top. The first group with an opinion about that page decides what happens — which is why the order matters (more on that soon).

04 · Create one

Add a block group

Pick a type from the dropdown, then press Add. The new group appears in the list and opens in the editor, ready to set up.

What's a type?

The type just pre-shapes the group for a job. Default blocks any websites (or apps) you list. The platform types — YouTube, TikTok, Reddit, Instagram, Discord and more — come with ready-made switches for that service. Custom is for your own logic.

You can add as many groups as you want and rename them later, so don't overthink the first pick.

05 · The top bar

Language, Manual & Settings

Across the very top of both programs sit three things that apply everywhere, not to one group: a language picker, the Instruction Manual, and Settings.

Language

Switch the entire interface to another language instantly. Your groups and rules are untouched — only the labels change — so you can flip languages any time.

Instruction Manual & Settings

Instruction Manual opens the built-in help. Settings opens the global preferences that sit behind every group. We'll come back to both later in this tour.

06 · Identify it

Name a group

The first field in the editor is the group's name. It's just a label for you — call it “Work focus”, “Doomscrolling”, “After 10pm”, whatever helps you recognise it in the list.

Names also matter for the web-app bridge later on: when you connect the browser and the Mac app, groups that share the exact same name can be linked into one synced cluster. For now, just give it something clear.

07 · Switch it on

Enable or disable a group

Every group has a single Enable checkbox. When it's off, the group does nothing at all — its rules are simply ignored. When it's on, the group is live.

This is the fastest way to pause a set of rules without deleting them. Build a “Deep work” group once, then flip it on in the morning and off in the evening — all your sites, schedules and limits come back exactly as you left them.

Note this is different from Snooze and Freeze (covered later), which are deliberate, harder-to-undo controls. Enable is the everyday on/off.

08 · Block or allow

Rule effect: Block vs Allow

Each group either blocks what it matches or allows it. Most groups block. But an “Allow” group is a powerful escape hatch.

Why allow?

Because groups are checked top to bottom and the first match wins, you can place a small Allow group above a broad blocking group to rescue exceptions. For example: block all of YouTube, but allow one course channel you actually need.

So the effect plus the order together let you express “block everything here, except these”.

09 · Order matters

Reorder your groups

Drag a group up or down in the list to change its priority. The engine reads top to bottom and stops at the first group that matches the page — so higher groups win.

A worked example

Put a narrow Allow “study channel” group at the top, and a broad Block YouTube group below it. Your study channel slips through; everything else on YouTube is blocked. Flip the order and the allow rule would never be reached.

When two groups could both apply, ordering is how you decide which one has the final say.

10 · How it blocks

Blocking behavior

This setting decides what happens when a group matches. There are three modes, and they change the whole feel of the group.

Block immediately

The strict option: the moment you hit a matching page or app, it's blocked. No grace period.

Block after a number of minutes

A daily time budget. You get, say, 20 minutes — then it blocks for the rest of the cycle.

Timer (count down, then block)

A countdown you set. While it runs the group stays open; the moment it reaches zero the group blocks for the rest of the cycle — “I get 30 focused minutes here, then I'm done.”

11 · Time budgets

Allowed minutes & the reset

When a group blocks after a number of minutes, two fields appear: how many minutes you're allowed, and how often that allowance resets.

Allowed minutes before block

Your budget. Spend it however you like across the cycle; once it runs out, the group blocks until the next reset.

Reset interval (hours)

How long until the budget refills — 24 hours for a daily limit, or shorter for tighter pacing. The Timer mode uses the same reset idea: its countdown refills each cycle.

12 · The blocked screen

Redirect when blocked

When a website is blocked, you choose where the browser lands. Leave it empty for a clean blank page, or point it somewhere intentional.

A redirect can turn a dead end into a nudge: send yourself to your task list, a note that says “back to work”, or a calmer site. It's a small touch that makes blocking feel like redirection rather than punishment.

Extension Full control of the destination URL — the blocked tab is sent wherever you point it.
App (macOS) Blocks whole applications, so there's no “page” to redirect to — the app simply can't open during the block.
13 · Default group (web)

Block websites — Extension

In the browser extension, a Default group blocks the websites you list. Add one site per line — plain domains like youtube.com or full URLs both work.

What counts as a match

Listing a domain blocks the whole site, including its subpages. You can be broad (an entire site) or surgical (a single page), and combine that with schedules and budgets from the other sections.

Each site shows as a removable chip. Add opens a box where you paste one or many sites at once; Clear Sites empties the whole list. This is the bread-and-butter of web blocking: the list of places you don't want to end up.

14 · Default group (app)

Block applications — App (macOS)

The Mac app's Default group blocks applications instead of web pages. You pick from the apps installed on your Mac, and the system stops them from opening during the block.

Why this is stronger

A website block lives inside one browser. An app block is system-wide — so blocking a chat or game app holds no matter how you try to open it. It's the right tool for desktop distractions the extension can't reach.

The two pair up nicely: block the website in the extension and the desktop app in the Mac app, and the distraction is closed off on both fronts.

15 · When it applies

Schedule windows

By default a group is active all the time. The Schedule section lets you restrict it to certain days and time windows instead.

Days & windows

Tick the days it should run, then add time ranges in HHMM-HHMM form (for example 0900-1200). Leave the windows blank to mean “all day” on the chosen days.

This is how you build “block social media on weekdays, 9–5” without touching anything on the weekend. Outside the window, the group quietly stands down.

16 · Commit to it

Freeze

Freeze locks a group so you can't quietly weaken it in a moment of temptation. It's the “I mean it” switch for when simple on/off isn't enough.

The freeze modes

Frozen holds your settings for a set number of hours. Strict frozen is harder to reverse early. Parental frozen is meant to be set by someone else. While frozen, the group's rules can't be loosened until it unlocks.

Use it when you already know future-you will try to bargain. Freeze removes the bargaining table for a while.

17 · A measured break

Snooze

Snooze lets you temporarily lift a group — but with friction on purpose, so a “quick break” doesn't quietly become the whole afternoon.

The dials

Set snooze minutes (how long the break lasts), an activation delay (a wait before it kicks in), a cooldown (before you can snooze again), and a confirmation count — each confirmation makes you pause a few seconds.

Together these turn an impulsive “unblock now” into a small, deliberate decision — usually long enough for the urge to pass.

Custom rules (no coding)

A Custom group runs a small rule you describe. It sounds technical, but you never have to write code — an AI writes it for you, and the engine just treats it as text.

The three-step flow

1) Press “Prompt for AI” — it copies a ready-made prompt describing what you want. 2) Paste it into any AI chat (ChatGPT, Claude…) and add details in plain English, like “hide the YouTube home feed and Shorts but keep search”. 3) Paste the rule it gives back and save.

That's it — no setup, no syntax to learn. Custom rules can do things presets can't, like hiding one specific button or surface on a page.

Custom rule templates

Don't want to involve an AI at all? Open the templates library: dozens of ready-made rules you can pick, tweak a setting or two, and apply.

Templates cover common wishes — timers, schedule helpers, feed hiders, focus nudges and more. Choose one, adjust its parameters in plain fields, and it replaces the current rule. It's the fastest way to get a powerful custom rule without describing anything.

You can always start from a template and then refine it further with the AI flow from the last box.

20 · Platform groups

Video sites — YouTube, TikTok & more

Some sites deserve more than “block the whole thing”. The video platform types give you switches tuned to how those sites actually pull you in.

Targeted switches

Block the home feed and recommendations while keeping search and subscriptions. Skip to the next video instead of blocking on scroll-feeds like Shorts, Reels and TikTok's FYP. Hide specific surfaces without banning the whole site.

YouTube, TikTok, Twitch and similar all share this idea: keep the part you came for, remove the part that traps you.

21 · Platform groups

Reddit, Discord & the rest

Beyond video, other platform types focus on the spaces that eat time on those sites — and let you allow the genuinely useful corners.

Reddit

Block the home feed, r/popular and r/all, or filter down to specific subreddits — keep r/productivity while the endless front page stays gone.

Discord & others

Target specific servers or channels by their IDs, and block the busy DMs/home screens. Facebook, Instagram, Twitter/X and more each get their own relevant switches.

The web-app bridge

The browser extension and the Mac app can be connected so your groups stay in sync. This is the web-app bridge — and it's entirely local to your machine.

How it fits together

The Mac app runs a small hub at a fixed local address. The browser connects to it. Once linked, groups with the same name on both sides become one shared cluster — change it in one place and the other follows.

Nothing goes to the internet: the bridge only talks to an address on your own computer. The next two boxes show the two halves — connecting the programs, then linking an individual group.

Extension Owns your website rules; shows app-managed lists read-only.
App (macOS) Owns your application rules and runs the local hub the browser connects to.
23 · Bridge, part 1

Connect the programs

This is the one-time, global setup, done in Settings. The Mac app runs the hub; the browser connects to it over the fixed local address.

Run the hub, then connect

In the app's Settings you turn on “Run local server (hub)”. In the extension's Settings you press Connect. Once the address shows as connected, the two programs can talk — for every group, not just one.

You only do this once per device. After that, linking individual groups (next box) is a single click.

24 · Bridge, part 2

Link a single group

With the programs connected, each group gets a Web-app bridge section. Linking is per group: you decide which groups are shared and which stay local.

Same name, one cluster

Link a group to a same-named group on the connected program and they form one shared cluster. Edit the “Focus” group in the browser and the “Focus” group on the Mac updates too — sites on one side, apps on the other, kept in step.

Groups you don't link simply stay independent, so you keep full control over what syncs.

25 · Preferences (web)

Settings — Extension

The extension's Settings hold preferences that apply across all your groups, plus the browser side of the bridge and file access.

What lives here

Default snooze length and fallback URL for new groups, responsiveness tuning, a debug mode, and the connection panel for the web-app bridge. There's also the anonymous creator-tag option (off by default), which only ever shares channel ids — never titles or history.

These are set-and-forget defaults — most people open this once and rarely return.

26 · Preferences (app)

Settings — App (macOS)

The Mac app has the same Settings layout, so it feels familiar — but it owns the half of the bridge that the browser connects to.

The key difference

Here you turn on “Run local server (hub)” — the app is the host other programs link to. The shared preferences (defaults, behavior, file access) mirror the extension, so anything you learned there applies.

We give each platform its own box because, while they look identical, the app is the one running the hub — a small but important distinction when you set up the bridge.

27 · Move groups around

Export & import a group

Any group can be saved to a file and loaded back later. It's how you back up a setup, move it to another device, or share it with someone else.

Export

Writes the selected group — all its sites, schedule, limits and rules — to a single file you keep.

Import

Loads a group from a file back into the list, ready to use. Built a great “Deep work” group on your laptop? Export it, import it on your desktop, done — no retyping.

Next to them sits Delete Group, which removes the selected group for good — the one editor action you can't undo, so it asks before it bites.

The Instruction Manual

One last control before we wrap up. Inside both programs, the Instruction Manual button in the top bar opens the full, always-current help — the same topics you just saw, in even more depth.

Whenever you forget what a field does, that button is the place to look first — it's written in your chosen language and stays in sync with the program you're using.

You now know the whole model: groups, how they're checked, blocking behavior, schedules, freeze and snooze, custom and platform rules, the web-app bridge, settings, and import/export. Go build your first group.

One idea, start to finish

Step back and it's all one simple loop: you write a few rules into a block group, flip it on, and the program enforces it for you — on every page or app it can reach — so the decision is made once, in a calm moment, instead of a hundred times a day when your willpower is thin.

Everything you just walked through hangs off that loop. Groups hold the rules and are checked top to bottom, so their order decides who wins. Behavior, schedules, freeze and snooze shape when and how firmly a block bites. Custom and platform rules let you go from “block a whole site” down to “hide just the feed,” and the web-app bridge lets the Mac app and the browser share one limit.

You don't have to use all of it. The honest starting move is one group, one site or app, switched on. Add a schedule when you want it to clock off; reach for freeze the day you want to mean it. The rest is here for when you need it — and the Instruction Manual inside each program always has the long version.

Take back your attention

New here? Start with this. The sites and apps you use all day are built to keep you there — endless feeds, autoplay, little red badges. This toolkit is the counterweight: it lets you decide what's off-limits and when, then quietly holds that line so you don't have to fight it in the moment.

What you're looking at

These boxes are a guided tour, strung together like a chain in reading order. Follow the links from one to the next — you can drag the canvas to pan and scroll to zoom. Each box explains one idea and most show a live slice of the real program so you see exactly what's described.

Where it ends up

By the last box you'll understand the whole thing and be ready to build your first rule. No account, no cost, and nothing you set up ever leaves your device. Take it one box at a time — the next three show the two programs and how to install them.

Start · The extension

The browser extension

One half of the toolkit lives inside your web browser. It installs like any other add-on, then watches the pages you open and applies whatever your enabled groups say.

Where it runs

Chrome, Edge, Brave and Arc (same engine), plus Firefox. Each browser keeps its own copy, so a rule you add in Chrome won't apply in Firefox unless you set it there too — or sync them through the bridge.

What it can block

Whole websites, single pages, and — its superpower — parts of a page: the YouTube home feed, Shorts, Reels, a Reddit front page, a comment section. It can also redirect a blocked tab somewhere kinder instead of just closing it.

What it can't reach

It only sees the browser it's installed in. A desktop app — or the same site opened in a different browser — is outside its reach. That's exactly the gap the Mac app fills.

Start · The native apps

The native apps

The other half runs as native programs outside any browser. There are builds for macOS and Windows that enforce blocks at the system level, plus a Safari blocker for Apple's own browser — together they cover the ground a single browser add-on can't.

macOS & Windows — block whole apps

The Mac and Windows builds block applications installed on your computer — chat apps, games, clients. An app block is system-wide, so it holds no matter how you try to launch the program — something no browser extension can do.

Safari — block sites in Apple's browser

The main extension covers Chrome, Edge, Brave, Arc and Firefox, but not Safari. The separate Safari blocker fills that gap, blocking individual sites right inside Safari so the same pages stay closed there too.

macOS runs the hub

The Mac app also hosts the small local hub the browser extension connects to for the web-app bridge — so one shared limit can cover an app on your Mac and the matching sites in your browser at once. When you pair them, the Mac is the host and the browser connects to it.

Same model, stronger reach

Every build uses the very same groups, schedules, freeze and snooze you'll learn here — nothing new to learn. They just apply them with the authority of a native app rather than a browser add-on.

Start · Install

Download & open it

Got the files? Here's how to actually get each half running. Everything is free and no account is needed — an account only adds optional cross-device sync, never blocking itself.

Browser extension — add it, then pin it

Open your browser's add-on store and click Add to Chrome (the same build covers Edge, Brave and Arc); on Firefox use Add-ons. Confirm Add extension, then click the puzzle-piece icon in the toolbar and pin the blocker so its popup — the one you'll see throughout this tour — stays one click away.

macOS app — open the .dmg, then Applications

Double-click the downloaded .dmg, drag the app onto the Applications folder, then launch it from there. On first run macOS asks you to approve it once under System Settings → Privacy & Security — that permission is what lets it hold blocked apps shut. Launching it also starts the local hub the extension connects to.

Windows app — run the installer

Open the downloaded installer and follow the prompts. When SmartScreen or the User Account Control dialog asks, choose Run anyway / Yes — that approval is what lets it hold blocked apps shut system-wide. It then runs quietly in the background and enforces your groups.

Safari blocker — enable it in Settings

Open the Safari blocker once, then turn it on under Safari → Settings → Extensions and allow it on the sites you want it to manage. Safari only applies it after you grant that access.

New here? Take the one-minute tour next — it explains the whole model, then walks every control in turn.

Forum

Forum and Creator Q&A

Ask the creator and the community anything, or just discuss. Vote posts and answers up or down, reply in threads, and tag questions by topic. Filter by topic (pick several), pinned, or answered. Reading is open to everyone; posting, replying and voting need a free account (the box up top).

Loading questions…