Browser Extension Pairing

Get the pairing token, connect the desktop app, and troubleshoot failed connections.

Download Desktop App

Install and launch Ghost Downloader first.

Chrome Extension

For Chrome and Chromium-based browsers.

Edge Extension

For Microsoft Edge.

Firefox Add-on

Official Firefox add-on page.

The browser extension connects to the desktop app through a local WebSocket service. The default service address is ws://127.0.0.1:14370.

Get the Pairing Token

Open the Ghost Downloader desktop app and go to Settings -> Browser Extension.

Turn on Enable Browser Extension.

Find Pairing Token on the same page and click Copy Token.

If you think the token has been exposed, or the extension keeps saying the token is invalid, regenerate it with the refresh button on the right.

Connect the Extension

Open the extension popup and go to the Settings page.

Keep Local Service URL as ws://127.0.0.1:14370 unless you have intentionally changed the bridge address in source code.

Paste the copied pairing token into the Pairing Token field and save it.

When the extension status changes to Connected, pairing is complete.

Regenerating the Token Disconnects Existing Sessions

When the desktop app regenerates the pairing token, the old token stored in the extension stops working immediately. Paste the new token again.

Troubleshoot Connection Failures

Check the following in order:

Symptom	Check this first
The extension shows `Waiting for Pairing`	No token has been saved in the extension yet.
The extension shows `Invalid Token`	The extension token does not match the desktop app. Copy it again, or regenerate it and save the new one.
The extension shows `Disconnected` or `Unable to connect to Ghost Downloader`	The desktop app is not running, or `Enable Browser Extension` is turned off.
The status keeps spinning on connecting	The service URL is not `ws://127.0.0.1:14370`, or local connections are blocked by security software.
It disconnects again right after saving	Click `Reconnect` on the extension settings page and check whether the status changes to `Connected`.

If the problem still remains, verify these four items:

The desktop app must stay running. Minimizing to tray is fine, but fully exiting is not.
Enable Browser Extension must remain enabled in the desktop app settings.
The saved token in the extension must exactly match the token currently shown by the desktop app.
Your machine must allow browser access to 127.0.0.1:14370. Do not let firewalls, proxy tools, or security software block the local WebSocket.

Downloads Are Not Being Captured

If the extension is already connected but browser downloads are not being handed over, check whether Intercept Downloads is enabled at the top of the extension UI.