Firelink Companion

Browser integration for the Firelink desktop download manager.

What it does

Firelink Companion sends browser downloads, selected links, and media pages to the native Firelink app.

Captured links open Firelink's Add window first. You can review them before starting or queuing a download.

Status

The current Companion release is 2.0.6. It is compatible with Firelink 1.2.0.

The project is actively maintained. Use the latest Companion release with the latest Firelink release.

Installation

• Chromium browsers: Download firelink-chromium.zip from the latest release. Follow the manual installation guide.

After installation:

1. Open Firelink.
2. Go to Settings -> Integrations.
3. Copy the pairing token.
4. Open the Firelink Companion popup.
5. Paste the token and save.

Features

• Automatic capture for ordinary browser downloads.
• Batch selected links from page context menus.
• Optional Firelink folders named from page titles.
• Explicit Fetch media actions from the popup and context menu.
• Firefox and Chromium Manifest V3 support.
• Signed local requests with HMAC-SHA256.
• Desktop identity checks before trusting localhost responses.
• Safe fallback when Firelink is closed or rejects a handoff.
• Recovery for interrupted or ambiguous captures without silent duplicates.
• Dynamic local port discovery across 127.0.0.1:6412-6422.

Handoff and privacy

• Ordinary captures may use browser cookies when the browser session requires them.
• Explicit media requests send the canonical page URL, not a raw browser Cookie header.
• Firelink handles media authentication through its configured media cookie source.
• The original browser download is kept unless Firelink confirms the handoff.
• Requests stay on the local machine. The extension does not send download data to a remote service.

Manual Chromium installation

Chromium builds are distributed as load-unpacked packages until a browser-store release is available.

1. Download firelink-chromium.zip from the latest release.

2. Extract the ZIP to a stable folder.

3. Open your browser's extension manager:

   Browser	Extension manager
   Chrome / Chromium	chrome://extensions
   Edge	edge://extensions
   Brave	brave://extensions
   Vivaldi	vivaldi://extensions
   Opera	opera:extensions

4. Enable Developer mode.

5. Select Load unpacked.

6. Choose the extracted folder containing manifest.json.

7. Pair the extension from Firelink Settings -> Integrations.

Manual Chromium installs do not auto-update. Extract the new ZIP and click Reload after an update. Managed browsers may disable Developer mode.

Temporary Firefox installation

Use this flow for local testing or add-on review:

1. Clone this repository.
2. Open about:debugging#/runtime/this-firefox in Firefox.
3. Select Load Temporary Add-on... and choose manifest.json.
4. Pair the extension from Firelink Settings -> Integrations.

Temporary Firefox add-ons are removed when Firefox restarts.

Development

npm test
npm run check
npm run build

The build writes load-unpacked packages to dist/firefox/ and dist/chromium/.

Release packages are firelink-firefox.zip and firelink-chromium.zip. firelink.zip remains a Firefox-package compatibility alias.

Credits

The extension uses standard WebExtensions APIs. It integrates with Firelink.

Thanks to users who report browser compatibility issues, test releases, and review the integration.

License

Firelink Companion is available under the MIT License.