- Download and unzip
ublock0.chromium.zip
(latest release desirable). - Rename the unzipped directory to
ublock
- When you later update manually, replace the content of the
ublock
folder with the content of the latest zipped version. - This will ensure that all the extension settings will be preserved
- As long as the extension loads from same folder path from which it was originally installed, all your settings will be preserved.
- When you later update manually, replace the content of the
- Go to chromium/chrome Extensions.
- Click to check Developer mode.
- Click Load unpacked extension....
- In the file selector dialog:
- Select the directory
ublock
which was created above. - Click Open.
- Select the directory
The extension will now be available in your chromium/chromium-based browser.
Remember that you have to update manually also. For some users, updating manually is actually an advantage because:
- You can update when you want
- If ever a new version sucks, you can easily just re-install the previous one
Compatible with Firefox 52 and beyond.
This works only if you set xpinstall.signatures.required
to false
in about:config
.see "Add-on signing in Firefox"
- Download
ublock0.webext.xpi
(latest release desirable).- Right-click and choose "Save As...".
- Drag and drop the previously downloaded
ublock0.webext.xpi
into Firefox
- Click on
ublock0.webext.signed.xpi
(latest release desirable).
On Linux, the settings are saved in a JSON file located at ~/.mozilla/firefox/[profile name]/browser-extension-data/[email protected]/storage.js
.
When you uninstall the extension, Firefox deletes that file, so all your settings are lost when you uninstall.
Compatible with Firefox 24 to Firefox 56.
- Download
ublock0.firefox.xpi
(latest release desirable). - Drag and drop the previously downloaded
ublock0.firefox.xpi
into Firefox
With Firefox 43 and beyond, you may need to toggle the setting xpinstall.signatures.required
to false
in about:config
.see "Add-on signing in Firefox"
Your uBlock Origin settings are kept intact even after you uninstall the addon.
On Linux, the settings are saved in a SQlite file located at ~/.mozilla/firefox/[profile name]/extension-data/ublock0.sqlite
.
On Windows, the settings are saved in a SQlite file located at %APPDATA%\Mozilla\Firefox\Profiles\[profile name]\extension-data\ublock0.sqlite
.
- Clone uBlock and uAssets repositories in the same parent directory
- Set path to uBlock:
cd uBlock
- Optional: Select the version to build:
git checkout <tag>
- Build the plugin:
- Chromium:
./tools/make-chromium.sh
- Firefox webext:
./tools/make-webext.sh all
- Firefox legacy:
./tools/make-firefox.sh all
- Chromium:
- Load the result of the build into your browser:
- Chromium: load the unpacked extension folder
/uBlock/dist/build/uBlock0.chromium/
in Chromium to use the extension. - Firefox: drag-and-drop
/uBlock/dist/build/uBlock0.firefox.xpi
or/uBlock/dist/build/uBlock0.webext.xpi
into Firefox.
- Chromium: load the unpacked extension folder