Skip to main content

Developer Setup

Web Browser Extension

Install browser extension

git clone
cd localnative-browser-extension/app
npm i -g web-ext
web-ext run --verbose # firefox

Setup browser extension host binary

  • Download and run the desktop applcation from release archive

    this will create ~/LocalNative/bin directory containing the host binary

  • or use cargo install localnative_cli, and find the binary at ~/.cargo/bin/localnative-web-ext-host

  • or build from source, via cargo

cd localnative-rs/localnative_cli
cargo build

If build succeed, the web extension host debug executable location is


Setup native messaging manifest to point to extension host binary

  • Copy manifest json template file app.localnative.json from localnative-browser-extension/host to your browser's specific manifest location
  • Change the host path in app.localnative.json to where localnative-web-ext-host binary is from previous step
Firefox example manifest file


"name": "app.localnative",
"description": "Local Native Host",
"path": "PREFIX/localnative/localnative-rs/target/debug/localnative-web-ext-host",
"type": "stdio",
"allowed_extensions": [
Chromium example manifest file


"name": "app.localnative",
"description": "Local Native Host",
"path": "PREFIX/localnative/localnative-rs/target/debug/localnative-web-ext-host",
"type": "stdio",
"allowed_origins": [
// use this ID if you install from chrome web store,
// or add/change to what the actual ID is if you "LOAD UNPACKED" from source.


If above things are correctly setup, localnative.sqlite3 database file is created at the directory ~/.ssb/localnative.sqlite3 the first time you click the web ext popup.

hint to see what localnative-web-ext-host went wrong:

RUST_BACKTRACE=1 chromium-browser
RUST_BACKTRACE=1 web-ext run --verbose

You can use DB Browser for SQLite to explore the database.


Rust GUI using Iced

see tutorial

Electron - only Mac and GNU/Linux - deprecated

cd localnative-electron
npm i
npm run build
npm run dev





There are scripts to bump version and release

├── release-appimage
├── release-mac
├── release-web-ext-host
└── set-version