explaingit

gorhill/ublock

🔥 Hot64,783JavaScriptAudience · generalComplexity · 2/5ActiveLicenseSetup · easy

TLDR

Browser extension that blocks ads, trackers, malware, and pop-ups to speed up pages and protect your privacy while browsing.

Mindmap

mindmap
  root((uBlock Origin))
    What it does
      Blocks ads and trackers
      Stops malware sites
      Speeds up pages
    How it works
      Uses filter lists
      Intercepts requests
      Point-and-click firewall
    Supported browsers
      Firefox
      Chrome
      Edge
      Opera
    Use cases
      Faster web browsing
      Privacy protection
      Security from malware
      Control per-site blocking

Things people build with this

USE CASE 1

Install on your browser to automatically block ads and trackers on every website you visit.

USE CASE 2

Use the firewall mode to allow or block specific third-party requests on individual sites.

USE CASE 3

Speed up page loading by preventing dozens of tracking scripts from running in the background.

USE CASE 4

Protect yourself from malware and phishing sites by blocking known dangerous domains.

Tech stack

JavaScriptBrowser Extension API

Getting it running

Difficulty · easy Time to first run · 5min
Free and open-source under GPLv3; you can use, modify, and distribute it freely as long as you keep the same license.

In plain English

uBlock Origin is a browser extension that blocks ads, trackers, malware sites, pop-ups, and other unwanted content when you browse the web. The problem it solves is that modern websites often load dozens of hidden third-party scripts that track your behavior, slow down page loading, and expose you to potential security risks. uBlock Origin intercepts these requests before they reach your browser, making pages load faster and protecting your privacy. It works by consulting filter lists, large community-maintained text files containing rules that describe which web requests to block. By default it uses well-known lists like EasyList for ads and EasyPrivacy for trackers. It extends this standard filter syntax with its own additional capabilities for more precise blocking. The extension is available for Firefox, Chrome, Edge, and Opera, and the README notes that it performs best on Firefox where the browser grants it full access to the network filtering APIs. For most users it is install-and-forget, but an advanced mode exposes a point-and-click per-site firewall for fine-grained control. The README emphasizes that blocking ads is not theft, uBlock Origin's primary aim is protecting user privacy from the broader ecosystem of tracking that ads represent. It is free, open-source under the GPLv3 license, and accepts no donations. The README also notes that Chrome support is ending at version 139 due to Google's changes to the browser extension API. The tech stack is plain JavaScript, packaged as a browser extension.

Copy-paste prompts

Prompt 1
How do I install uBlock Origin on my browser and set it up to block ads and trackers?
Prompt 2
Show me how to use uBlock Origin's firewall mode to control what each website can load.
Prompt 3
What are filter lists in uBlock Origin and how do I add custom ones to block more content?
Prompt 4
How does uBlock Origin differ from other ad blockers, and why does it perform best on Firefox?
Prompt 5
I want to whitelist certain sites in uBlock Origin, how do I disable blocking for specific domains?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.