Hydra browser extension — installing the unsigned build
=======================================================

These are UNSIGNED builds: they carry no Chrome Web Store or
addons.mozilla.org signature, so each browser needs its developer mode (or a
temporary install) to accept them. The extension itself is identical to the
store build.

The paths below are where Hydra installs these files; if you are reading
this from an archive you extracted yourself, use the directory this file is
in instead.

In this directory:

  hydra-chrome-0.3.0.zip
      packed build for the Chromium family (Web Store upload format)
  hydra-firefox-0.3.0.xpi
      packed build for Firefox
  chrome/
      the same Chromium build, already unpacked and ready to load
  firefox/
      the same Firefox build, already unpacked
  INSTALL.txt
      this file

Chrome, Edge, Opera, Brave, Vivaldi, Arc, Chromium
--------------------------------------------------
Chromium only installs a .crx that came from the Web Store, so an unsigned
build is loaded from the unpacked directory instead. (The .zip is the same
build for a store upload — to use it here, unzip it somewhere permanent and
point step 3 at that folder.)

  1. Open the extensions page:
         Chrome   chrome://extensions
         Edge     edge://extensions
         Opera    opera://extensions
         Brave    brave://extensions
         Vivaldi  vivaldi://extensions
         Arc      arc://extensions
  2. Turn on "Developer mode" — top right in Chrome, Brave, Vivaldi and Arc;
     bottom left in Edge; the sidebar in Opera.
  3. Click "Load unpacked" and select:
         %LOCALAPPDATA%\Programs\Hydra\extensions/chrome
  4. Leave that folder where it is. The browser re-reads it from disk at every
     start, and moving or deleting it uninstalls the extension.

The extension id is jpnonmbbkjdpeebdhkjoliklfhkdcomj in every Chromium
browser — it is pinned by the manifest key, and it is the id Hydra's native
messaging host already allows, so nothing else needs configuring.

Firefox
-------
Temporary — works in every Firefox, and is removed at the next restart:

  1. Open about:debugging#/runtime/this-firefox
  2. Click "Load Temporary Add-on..." and select:
         %LOCALAPPDATA%\Programs\Hydra\extensions/hydra-firefox-0.3.0.xpi
     (or %LOCALAPPDATA%\Programs\Hydra\extensions/firefox/manifest.json)

Permanent — Developer Edition, Nightly and ESR only:

  1. Open about:config and set
         xpinstall.signatures.required = false
     Release and Beta Firefox ignore this setting and will keep refusing an
     unsigned add-on; use the temporary install above, or a signed build.
  2. Open about:addons, click the gear icon, choose
     "Install Add-on From File..." and select the .xpi above.

After installing
----------------
Restart the browser once so it picks up Hydra's native-messaging manifest,
then open the Hydra toolbar icon: the status dot is green when the extension
has reached the app (WebSocket 127.0.0.1:6799).

If the dot stays red, this browser has no native-messaging manifest for
Hydra. The DMG/PKG, .deb/.rpm and Windows installers register Chrome, Edge,
Brave, Vivaldi, Chromium and Firefox for you — for anything else (or an
install from a plain archive) run the registration script that ships with
Hydra:
    macOS / Linux   scripts/install-native-host.sh
    Windows         scripts\install-native-host.ps1
