mirror of
https://github.com/gorhill/uBlock.git
synced 2024-09-02 00:59:38 +02:00
.. | ||
description | ||
README.md |
INSTALL
Chromium
- 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
Firefox
- Download
ublock0.firefox.xpi
(latest release desirable). - Drag and drop the previously downloaded
ublock0.firefox.xpi
into 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
.
Build instructions (for developers)
- 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:
./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
into Firefox.
- Chromium: load the unpacked extension folder