Project

General

Profile

Actions

Installation instructions (browser extension Mozilla) » History » Revision 13

« Previous | Revision 13/20 (diff) | Next »
koszko, 02/26/2022 02:22 PM
Add global install instructions


Installation instructions (Mozilla)

Browser compatibility

Haketilo is currently compatible with browsers based on Mozilla Firefox 60 and upwards.

Although this makes little difference to Haketilo, please consider using a Firefox derivative that isn't malware respects your freedom and privacy (i.e. does not snoop on you). Valid options are browsers in some of the "ethical" GNU/Linux distros like Parabola and Trisquel, the Tor Browser, and LibreWolf.

Single-user install

Here we'll describe how to install Haketilo from a .xpi file served by our servers. Extensions in Firefox and its derivatives are often installed from the Mozilla Add-ons website (AMO) but this approach has serious privacy and freedom problems.

Right now we only provide an unsigned .xpi extension file. This means it hasn't been cryptographically signed by Mozilla and therefore some of Mozilla browsers and even derivatives will refuse to install it. While we're going to provide a signed version of the extension soon, you are strongly encouraged to use a Firefox derivative that allows you to manage your software and install unsigned add-ons as well.

Note: even if your browser refuses to install a unsigned extensions, you can still 1) try it out by installing it as a "temporary" add-on on about:debugging page or 2) try installing it globally

Steps

Note: depending on the versions of your web browser and Haketilo some UI elements and text messages might be slightly different on your machine than on the screenshots below

First, download the extension's .xpi file from the Releases. You can also download the cryptographic signatures to verify the file hasn't been tampered with. After downloading, go to the about:addons URL. In the extensions management page that shows up, click on the gear icon and select "Install Add-on From File...".

extensions page

Now, navigate to the downloaded .xpi file and select it.

navigating to the extension file

Note: if, at this point, your browser shows you an error message about extension file being invalid but you're sure the browser supports installation of unsigned extensions, go to the about:config URL, confirm the warning prompt that appears, search for the xpinstall.signatures.required preference and double-click it to toggle its value to "false"

You should be presented with a dialog asking whether to add Haketilo to your browser. Once you click "Add", the add-on will install.

adding Haketilo

The browser might ask whether you want to allow Haketilo to run in private windows. If you installed Haketilo for its script-blocking capabilities, then you most likely also want that and you can check this option. Otherwise, it is a perfectly valid approach to aim for a purely script-less experience in private browsing windows and use an add-on like NoScript or uBlock Origin there instead of Haketilo.

Haketilo installed, allowing extension to run in private windows

Global install (GNU/Linux distributions)

Most Firefox-based browsers from GNU/Linux distros' package managers (including firefox-esr from Debian and abrowser from Trisquel) are configured to automatically pick up extensions placed under

/usr/share/mozilla/extensions/{ec8030f7-c20a-464f-9b0e-13a3a9e97384}

where {ec8030f7-c20a-464f-9b0e-13a3a9e97384} is the ID of Mozilla Firefox. This is what enables commands like apt install webext-ublock-origin to work on distros (in this case, Debian and Trisquel).

Here, we'll leverage this to install Haketilo system-wide and have it appear in the browser of every user account.

Note: you need access to root account via sudo command for the instructions below to work

Note: it is assumed you have curl and unzip commands installed

Steps

Note: depending on the versions of your web browser and Haketilo some UI elements and text messages might be slightly different on your machine than on the screenshots below

Run the following in your POSIX shell, type your user password when prompted:

HAKETILO_VER="1.0b1" # replace with the version you want to have installed
HAKETILO_URL="https://hydrilla.koszko.org/downloads/haketilo-$HAKETILO_VER.xpi"
FIREFOX_ID="{ec8030f7-c20a-464f-9b0e-13a3a9e97384}"
HAKETILO_ID="{6fe13369-88e9-440f-b837-5012fb3bedec}"
EXT_PATH="/usr/share/mozilla/extensions/$FIREFOX_ID/$HAKETILO_ID/"

install_haketilo() {
    sudo mkdir -p "$EXT_PATH"
    cd "$EXT_PATH"
    curl "$HAKETILO_URL" -o /tmp/haketilo.xpi
    sudo unzip /tmp/haketilo.xpi
    rm /tmp/haketilo.xpi
}

install_haketilo

Optionally, you can modify this snippet to also verify the downloaded file with signatures provided on the Releases page.

Once you have performed the installation, you might (or might not) want to give Haketilo access to private browser tabs. You can do it from the about:addons page.

Haketio manage

Haketio allow in private tabs

Post-install notes

restrictedDomains preference

In some browsers, extensions are by default blocked from running on privileged domains. This is done as a security measure to prevent add-ons from exploiting "sync" feature, the add-ons website, etc. Unfortunately, this prevents Haketilo from applying policies there. If you want Haketilo to function on those sites, go to the about:config URL and click through the warning prompt that appears.

Clicking through the about:config warning prompt

Search for the extensions.webextensions.restrictedDomains preference. When it appears, double-click on it, erase any text and press "enter" to make all websites unprivileged.

Clearing the "extensions.webextensions.restrictedDomains" preference

Gratulations

That's it. You can now play a bit with the extension and learn how it works. Also, make sure you realize its limitations.

Updated by koszko over 1 year ago · 13 revisions

Also available in: PDF HTML TXT