ff-tabs-host

Native messaging host that exposes Firefox tabs over TCP. Bridges the Firefox extension API with local applications.

Components

• extension/ - Firefox extension that communicates tab data
• tabs-host/ - Rust native messaging host (TCP server on 127.0.0.1:19876)

Installation

1. Build the native host

cd tabs-host
cargo build --release

2. Register with Firefox

.\install.ps1

This generates the native messaging manifest and registers it in the Windows registry.

3. Load the extension

1. Open Firefox and go to about:debugging
2. Click "This Firefox" > "Load Temporary Add-on"
3. Select extension/manifest.json

Protocol

Local apps connect to 127.0.0.1:19876 and send JSON commands:

{"action": "get_tabs"}

{"action": "switch_tab", "tabId": 123, "windowId": 1}

Response (get_tabs)

[
  {
    "id": 123,
    "windowId": 1,
    "title": "Example",
    "url": "https://example.com",
    "favIconUrl": "data:image/png;base64,...",
    "windowBounds": {"left": 0, "top": 0, "width": 1920, "height": 1080}
  }
]

Uninstall

.\uninstall.ps1