2014-06-24 00:42:43 +02:00
|
|
|
## INSTALL
|
|
|
|
|
|
2015-04-18 01:23:41 +02:00
|
|
|
#### Chromium
|
|
|
|
|
|
2015-04-18 01:32:43 +02:00
|
|
|
- Download and unzip `ublock0.chromium.zip` ([latest release desirable](https://github.com/gorhill/uBlock/releases)).
|
2014-07-15 04:12:29 +02:00
|
|
|
- Rename the unzipped directory to `ublock`
|
2014-08-26 01:50:50 +02:00
|
|
|
- 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.
|
2014-06-24 00:42:43 +02:00
|
|
|
- Go to chromium/chrome *Extensions*.
|
|
|
|
|
- Click to check *Developer mode*.
|
|
|
|
|
- Click *Load unpacked extension...*.
|
|
|
|
|
- In the file selector dialog:
|
2014-07-18 03:03:16 +02:00
|
|
|
- Select the directory `ublock` which was created above.
|
2014-06-24 00:42:43 +02:00
|
|
|
- Click *Open*.
|
|
|
|
|
|
2014-09-26 16:05:12 +02:00
|
|
|
The extension will now be available in your chromium/chromium-based browser.
|
2014-06-29 23:52:42 +02:00
|
|
|
|
2014-08-26 01:50:50 +02:00
|
|
|
Remember that you have to update manually also. For some users, updating manually is actually an advantage because:
|
|
|
|
|
- You can update when **you** want
|
2015-01-24 13:33:02 +01:00
|
|
|
- If ever a new version sucks, you can easily just re-install the previous one
|
2015-04-18 01:23:41 +02:00
|
|
|
|
2017-09-04 13:23:32 +02:00
|
|
|
#### Firefox legacy
|
2015-04-18 01:23:41 +02:00
|
|
|
|
2015-04-18 01:32:43 +02:00
|
|
|
- Download `ublock0.firefox.xpi` ([latest release desirable](https://github.com/gorhill/uBlock/releases)).
|
|
|
|
|
- Drag and drop the previously downloaded `ublock0.firefox.xpi` into Firefox
|
2015-04-18 01:23:41 +02:00
|
|
|
|
2017-09-04 13:23:32 +02:00
|
|
|
With Firefox 43 and beyond, you may need to toggle the setting `xpinstall.signatures.required` to `false` in `about:config`.
|
|
|
|
|
|
2015-08-25 14:56:45 +02:00
|
|
|
Your uBlock Origin settings are kept intact even after you uninstall the addon.
|
2015-04-18 01:27:41 +02:00
|
|
|
|
|
|
|
|
On Linux, the settings are saved in a SQlite file located at `~/.mozilla/firefox/[profile name]/extension-data/ublock0.sqlite`.
|
|
|
|
|
|
2015-04-18 01:41:54 +02:00
|
|
|
On Windows, the settings are saved in a SQlite file located at `%APPDATA%\Mozilla\Firefox\Profiles\[profile name]\extension-data\ublock0.sqlite`.
|
2017-05-26 13:34:01 +02:00
|
|
|
|
|
|
|
|
#### Build instructions (for developers)
|
|
|
|
|
|
|
|
|
|
- Clone [uBlock](https://github.com/gorhill/uBlock) and [uAssets](https://github.com/uBlockOrigin/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`
|
|
|
|
|
- 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.
|
|
|
|
|
|
