Skip to content

Building AdNauseam from source (for developers)

Daniel Howe edited this page Jun 28, 2019 · 54 revisions

Setup (on OS X only, linux instructions pending)

  • First, install python3 and jq if you don't have them
  • Then do the following from the terminal:
$ git clone https://github.com/dhowe/AdNauseam.git
$ git clone https://github.com/uBlockOrigin/uAssets
$ cd AdNauseam

For Chromium / Opera:

  1. Update the uAssets repo: $ cd ../uAssets && git pull && cd -

  2. Build the extension (via the terminal) $ tools/make-chromium.sh or $ tools/make-opera.sh

  3. Open the browser and go to settings, with URL chrome://extensions/

  4. Enable Developer mode in the settings page and load extension from /dist/build/adnauseam.chromium or /dist/build/adnauseam.opera

  5. To view console messages, go to chrome://extensions/, and select 'background.html' under the AdNauseam entry

For Firefox:

  1. Make sure to have the web-ext tool installed.

  2. Update the uAssets repo: $ cd ../uAssets && git pull && cd -

  3. In terminal: $ tools/run-firefox.sh

  4. (Optional) To use a Firefox profile other than the default, pass the profile path to run-firefox.sh:

    $ tools/run-firefox.sh /path/to/profile

  5. To view console messages, select the Tools->Web Developer->Browser Console menu option

Next...

Clone this wiki locally