Haketilo

# Installation instructions ((Ungoogled) Chromium)

Here we'll describe how to install Hachette as an *Unpacked Extension*. Chromium extensions are most often installed from Chrome Web Store, but for the sake of privacy and freedom, you should not use it!

Although installation as Unpacked Extension is meant mainly for developers during testing, it is also simple enough for casual users. We also have plans to start distributing Hachette as a .crx file, so you can come back here from time to time and see if this is already an option.

*Note: If you want, you can also follow [this](https://avoidthehack.com/manually-install-extensions-ungoogled-chromium) third-party guide to generate a .crx file yourself and install from it.*

## Browser compatibility

Hachette is currently compatible with recent versions of Chromium. It has been tested with Ungoogled Chromium 90.0, and is expected to also work with slightly newer and older versions. Although Hachette should also run fine under the standard, non-Ungoogled Chromium and Google Chrome, these browsers are unrecommended due to serious privacy and freedom violations.

## Steps

First, download the extension's .zip file from  the [[Releases]]. You can also download the .gpg signature to verify the file hasn't been tampered with (although it is of little benefit unless you have a proof developer's [signing key](https://koszko.org/key.gpg) does indeed belong to him...). After downloading, extract zip file's contents to some directory. Here we use `/tmp/`. Then, go to the `chrome://extensions` URL. In the extensions management page that shows up, you need to enable developer mode using toggle in the top right of the page. Once you do so, you should see a "Load unpacked" button. Click it.

![chrome extensions page](https://hachettebugs.koszko.org/attachments/download/39/chrome_extensions.png)

Navigate to the extracted directory and choose it.

![navigating to the extension directory](https://hachettebugs.koszko.org/attachments/download/41/navigate_extension_dir.png)

Your browser has just installed Hachette. You can now delete the extracted directory and disable developer mode. If you want Hachette's icon to be permanently visible in the top right corner of your browser window, click on the extensions icon, and then, on Hachette's pin icon as shown below.

![pinning extension icon](https://hachettebugs.koszko.org/attachments/download/40/chrome_hachette_installed.png)

That's it. You can now play a bit with the extension and [learn how it works](https://hachettebugs.koszko.org/projects/hachette/wiki/User_manual#Understanding-the-concepts).