Tailtab 0.2.3

Highlights

• Simpler manual installation: tailtab install now defaults to the released extension IDs, fixing the empty --edge-id error. Custom builds can still override both IDs. PR #4
• Chrome Flatpak support on Linux: an opt-in installer copies the host and unpacked extension into Chrome's app directory, with staged upgrades, rollback, and per-app locking. It requires no Flatpak permission overrides. PR #5
• Clearer exit-node names: location-aware nodes such as Mullvad servers are grouped by country and labelled by city. PR #1
• Distribution improvements: checksum-verifying install scripts, Firefox extension self-updates, and CI with host smoke tests on Linux, macOS, and Windows. PR #3

Thanks to @Hajfi for the exit-node contribution and the detailed Chrome Flatpak report in issue #2.

Install or update the native host

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Stocist/Tailtab/main/scripts/install.sh | sh

Windows, in PowerShell:

irm https://raw.githubusercontent.com/Stocist/Tailtab/main/scripts/install.ps1 | iex

Close browsers using Tailtab before updating the Windows host. These scripts download the latest release, verify SHA256SUMS, and register the native host for your user account.

For manual installation, download the host matching your OS and architecture, verify its checksum, place it in a permanent location, and run tailtab install. On Windows, the usual location and command are:

& "$env:LOCALAPPDATA\tailtab\tailtab.exe" install

On macOS/Linux, make the downloaded host executable first. The host binaries are not code-signed or notarised; see the installation guide for platform-specific setup.

Browser extension

• Firefox / Zen: install the Mozilla-signed tailtab-0.2.3.xpi. Users on 0.2.2 or earlier should install this XPI once to enable future extension self-updates. Host updates remain separate.
• Chrome / Edge: extract tailtab-chromium-0.2.3.zip and load the directory through the browser's extensions page with Developer mode enabled. Reload an existing unpacked extension after replacing its files.
• tailtab-firefox-0.2.3.zip is also available for temporary unpacked development use.

Chrome Flatpak on Linux

Install and launch Chrome Flatpak once, then fully quit it. Extract tailtab-chromium-0.2.3.zip into a directory and run the matching Linux host, for example on x86-64:

unzip tailtab-chromium-0.2.3.zip -d tailtab-chromium-0.2.3
chmod +x tailtab-linux-amd64
./tailtab-linux-amd64 install --chrome-flatpak --extension-dir ./tailtab-chromium-0.2.3

Load the copied extension directory printed by the installer in chrome://extensions. The regular download one-liner remains native-browser-only. See the Flatpak guide for upgrades and removal.

Assets

The release includes native hosts for macOS, Linux, and Windows on AMD64 and ARM64, both browser bundles, the signed Firefox XPI, updates.json, and SHA256SUMS.

Full changelog from v0.2.2

Tailtab 0.2.2

Install

Host (macOS): download tailtab-darwin-arm64 (Apple silicon) or tailtab-darwin-amd64 (Intel), then:

chmod +x tailtab-darwin-arm64
xattr -d com.apple.quarantine tailtab-darwin-arm64   # the binary is not notarised yet
mkdir -p ~/.local/bin && mv tailtab-darwin-arm64 ~/.local/bin/tailtab
~/.local/bin/tailtab install --edge-id kejfineblfbjfolkgjkancapnpknomod --gecko-id tailtab@stocist.dev

Or build from source with ./scripts/build.sh, which needs no quarantine step.

Host (Linux): download tailtab-linux-amd64 or tailtab-linux-arm64, chmod +x it, put it somewhere permanent such as ~/.local/bin/tailtab, and run the same install command. Manifests go to ~/.config/microsoft-edge/, ~/.mozilla/native-messaging-hosts/ and, when present, Chrome, Chromium and Brave.

Host (Windows): download tailtab-windows-amd64.exe, put it somewhere permanent such as %LOCALAPPDATA%\tailtab\tailtab.exe, and run the same install command from a terminal. It writes the manifests next to itself and registers them under HKCU\Software\<browser>\NativeMessagingHosts. Linux and Windows hosts are built and unit-tested but not yet exercised end to end; reports welcome.

Extension:

• Zen / Firefox: install tailtab-0.2.2.xpi (signed by Mozilla for self-distribution) by opening it in the browser, or load tailtab-firefox-0.2.2.zip unpacked as a temporary add-on.
• Edge / Chrome: unzip tailtab-chromium-0.2.2.zip and load it unpacked from edge://extensions or chrome://extensions with developer mode on.

SHA256SUMS lists every asset. See the README for first login and the docs for how routing, exit nodes and accounts behave.

Changes

Full Changelog: v0.2.1...v0.2.2

Tailtab 0.2.1

Install

Host (macOS): download tailtab-darwin-arm64 (Apple silicon) or tailtab-darwin-amd64 (Intel), then:

chmod +x tailtab-darwin-arm64
xattr -d com.apple.quarantine tailtab-darwin-arm64   # the binary is not notarised yet
mkdir -p ~/.local/bin && mv tailtab-darwin-arm64 ~/.local/bin/tailtab
~/.local/bin/tailtab install --edge-id kejfineblfbjfolkgjkancapnpknomod --gecko-id tailtab@stocist.dev

Or build from source with ./scripts/build.sh, which needs no quarantine step.

Host (Linux): download tailtab-linux-amd64 or tailtab-linux-arm64, chmod +x it, put it somewhere permanent such as ~/.local/bin/tailtab, and run the same install command. Manifests go to ~/.config/microsoft-edge/, ~/.mozilla/native-messaging-hosts/ and, when present, Chrome, Chromium and Brave.

Host (Windows): download tailtab-windows-amd64.exe, put it somewhere permanent such as %LOCALAPPDATA%\tailtab\tailtab.exe, and run the same install command from a terminal. It writes the manifests next to itself and registers them under HKCU\Software\<browser>\NativeMessagingHosts. Linux and Windows hosts are built and unit-tested but not yet exercised end to end; reports welcome.

Extension:

• Zen / Firefox: install tailtab-0.2.1.xpi (signed by Mozilla for self-distribution) by opening it in the browser, or load tailtab-firefox-0.2.1.zip unpacked as a temporary add-on.
• Edge / Chrome: unzip tailtab-chromium-0.2.1.zip and load it unpacked from edge://extensions or chrome://extensions with developer mode on.

SHA256SUMS lists every asset. See the README for first login and the docs for how routing, exit nodes and accounts behave.

Changes

Full Changelog: v0.2.0...v0.2.1

Tailtab 0.2.0

Install

Host (macOS): download tailtab-darwin-arm64 (Apple silicon) or tailtab-darwin-amd64 (Intel), then:

chmod +x tailtab-darwin-arm64
xattr -d com.apple.quarantine tailtab-darwin-arm64   # the binary is not notarised yet
mkdir -p ~/.local/bin && mv tailtab-darwin-arm64 ~/.local/bin/tailtab
~/.local/bin/tailtab install --edge-id kejfineblfbjfolkgjkancapnpknomod --gecko-id tailtab@stocist.dev

Or build from source with ./scripts/build.sh, which needs no quarantine step.

Host (Linux): download tailtab-linux-amd64 or tailtab-linux-arm64, chmod +x it, put it somewhere permanent such as ~/.local/bin/tailtab, and run the same install command. Manifests go to ~/.config/microsoft-edge/, ~/.mozilla/native-messaging-hosts/ and, when present, Chrome, Chromium and Brave.

Host (Windows): download tailtab-windows-amd64.exe, put it somewhere permanent such as %LOCALAPPDATA%\tailtab\tailtab.exe, and run the same install command from a terminal. It writes the manifests next to itself and registers them under HKCU\Software\<browser>\NativeMessagingHosts. Linux and Windows hosts are built and unit-tested but not yet exercised end to end; reports welcome.

Extension:

• Zen / Firefox: install tailtab-0.2.0.xpi (signed by Mozilla for self-distribution) by opening it in the browser, or load tailtab-firefox-0.2.0.zip unpacked as a temporary add-on.
• Edge / Chrome: unzip tailtab-chromium-0.2.0.zip and load it unpacked from edge://extensions or chrome://extensions with developer mode on.

SHA256SUMS lists every asset. See the README for first login and the docs for how routing, exit nodes and accounts behave.

Changes

Full Changelog: v0.1.0...v0.2.0

Tailtab 0.1.0

Install

Host (macOS): download tailtab-darwin-arm64 (Apple silicon) or tailtab-darwin-amd64 (Intel), then:

chmod +x tailtab-darwin-arm64
xattr -d com.apple.quarantine tailtab-darwin-arm64   # the binary is not notarised yet
mkdir -p ~/.local/bin && mv tailtab-darwin-arm64 ~/.local/bin/tailtab
~/.local/bin/tailtab install --edge-id kejfineblfbjfolkgjkancapnpknomod --gecko-id tailtab@stocist.dev

Or build from source with ./scripts/build.sh, which needs no quarantine step.

Extension:

• Zen / Firefox: install tailtab-0.1.0.xpi (signed by Mozilla for self-distribution) by opening it in the browser, or load tailtab-firefox-0.1.0.zip unpacked as a temporary add-on.
• Edge / Chrome: unzip tailtab-chromium-0.1.0.zip and load it unpacked from edge://extensions or chrome://extensions with developer mode on.

SHA256SUMS lists every asset. See the README for first login and the docs for how routing, exit nodes and accounts behave.

Changes

Full Changelog: https://github.com/Stocist/Tailtab/commits/v0.1.0