Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
uBlock Origin - Define Macro Implementation
GitHub didn't answer, so this is the saved copy from 1 days ago
Will it work on macOS?
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install. The repo uses git submodules, so the clone fetches them too.
git clone --recurse-submodules https://github.com/BlazeFTL/uBlockDefine.git cd uBlockDefine
Node.js >=22
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install --lts
npm ci
build.yml runs on every push and pull request. It checks out upstream gorhill/uBlock, applies apply_patches.py and patch.py, then runs make firefox. Download the result from Actions → latest run → uBlockOrigin Define V<version> Fork Unsigned.
Run the Release XPI workflow manually. It:
uBlockDefine.firefox.xpi from this repo.v<version>. If that release already exists, it is skipped.update_url in the manifest. Set the repository variable ADDON_ID to override the add-on ID.updates.json to the updates release, so installed copies update themselves (Firefox 115+).For a signed build, head to the Release section.
sync-upstream.yml runs daily at 03:17 UTC. It merges gorhill/uBlock master into this repo, keeps this README and the fork's workflows, then triggers Release XPI.
No reports for macOS yet.
GitManual AI Agent reads the 9 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.