Alpha

v0.7.0 is out now. Expect bugs. Report one on GitHub

[ Developers ]

Build winnower yourself

All of winnower's code is public. Build it to try changes before they reach the store, or to send your own. Just want to block ads? Install it from the store.

  1. 01

    Get the code and build it

    You need Git, and Node 22.18 or newer.

    npm run update fetches the filter lists, builds winnower into the extension folder and checks the result.

    git clone https://github.com/meistyr/winnower-adblock.gitcd winnower-adblocknpm installnpm run update
  2. 02

    Open the extensions page

    Type this into Chrome's address bar and press Enter:

    chrome://extensions
    chrome://extensionsEnter ↵
  3. 03

    Turn on Developer mode

    Switch on Developer mode at the top right of the page. A row of buttons appears underneath.

    It's what lets Chrome load an extension from a folder on your computer.

    chrome://extensions
  4. 04

    Load unpacked

    Click Load unpacked and choose the extension folder inside winnower-adblock. winnower's card appears on the page, switched on.

    chrome://extensions

[ Testing ]

A build is for testing.

Not your everyday copy

A build has whatever is in the code right now, including work that isn't finished. Use it to try changes, and keep the store copy for every day.

Turn the store copy off first

On chrome://extensions, switch off the store copy of winnower while your build is loaded. With both on, every page is filtered twice. The two don't share settings either.

Updating your build

Run git pull, then npm run update, then click the reload button on your build's card in chrome://extensions.

Going back

Click Remove on your build's card, then switch the store copy back on. Your store settings are where you left them.

[ Contributing ]

Reports and changes.

Report a problem

Open an issue on GitHub and pick the form that fits: a site that breaks, an ad that got through, or something else. Each asks for your winnower version, which is at the bottom of its menu. Say if it's a build from the code.

A security problem

Please don't open an issue. Report it privately on GitHub instead.

Send a change

Open a pull request with one change in it, and check that npm run update passes first. CONTRIBUTING.md has the details.

License

winnower is GPL-3.0-or-later, and contributions are licensed the same way. winnower is maintained by one person, so issues and pull requests are read as time allows.