47bdec422a | ||
---|---|---|
.. | ||
chromium | ||
description | ||
firefox | ||
mv3 | ||
README.md | ||
version |
README.md
INSTALL
Chromium
- Download and unzip
ublock0.chromium.zip
(latest release desirable). - Rename the unzipped directory to
ublock
.- When you update manually, replace the content of the
ublock
folder with the content of the latest zipped version. This ensures all extension settings are preserved. - As long as the extension loads from the same folder path as it was originally installed, your settings will be kept.
- When you update manually, replace the content of the
- Open Chromium/Chrome and go to Extensions.
- Click to enable Developer mode.
- Click Load unpacked extension....
- In the file selector dialog:
- Select the
ublock
directory you created. - Click Open.
- Select the
The extension will now be available in your Chromium/Chromium-based browser.
Note: You must update manually. For some users, manual updates are beneficial because:
- You can update when you want.
- If a new version is unsatisfactory, you can easily reinstall the previous one.
Firefox
Compatible with Firefox 52 and beyond.
For Stable Release Version
This method only works if you set xpinstall.signatures.required
to false
in about:config
.see "Add-on signing in Firefox"
- Download
ublock0.firefox.xpi
(latest release desirable).- Right-click and choose "Save As...".
- Drag and drop the downloaded
ublock0.firefox.xpi
into Firefox.
For Beta Version
- Click on
ublock0.firefox.signed.xpi
(latest release desirable).
Location of uBO Settings
On Linux, the settings are saved in a JSON file located at:
~/.mozilla/firefox/[profile name]/browser-extension-data/uBlock0@raymondhill.net/storage.js
When you uninstall the extension, Firefox deletes this file, and all your settings will be lost.
Firefox Legacy
Compatible with Firefox 24-56, Pale Moon, and SeaMonkey.
- Download
ublock0.firefox-legacy.xpi
(latest release desirable).- Right-click and select "Save Link As..."
- Drag and drop the downloaded
ublock0.firefox-legacy.xpi
into Firefox.
For 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 preserved even after uninstalling the addon.
- On Linux, settings are saved in a SQLite file located at:
~/.mozilla/firefox/[profile name]/extension-data/ublock0.sqlite
- On Windows, settings are saved in a SQLite file located at:
%APPDATA%\Mozilla\Firefox\Profiles\[profile name]\extension-data\ublock0.sqlite
Build Instructions (for Developers)
- Clone the uBlock repository:
git clone https://github.com/gorhill/uBlock.git
- Set the path to uBlock:
cd uBlock
- The official version of uBO is in the
master
branch:git checkout master
- Build the plugin:
- Chromium:
make chromium
- Firefox:
make firefox
- NPM package:
make npm
- Chromium:
- Load the result of the build into your browser:
- Chromium:
- Navigate to
chrome://extensions/
- Check "Developer mode"
- Click "Load unpacked"
- Select
/uBlock/dist/build/uBlock0.chromium/
- Navigate to
- Firefox:
- Navigate to
about:debugging#/runtime/this-firefox
- Click "Load Temporary Add-on..."
- Select
/uBlock/dist/build/uBlock0.firefox/
- Navigate to
- Chromium: