Chrome Plugin | Firefox Plugin

Part-DB Browser Plugin

A browser extension for Chrome and Firefox that lets you submit any product page to Part-DB with one click. Part-DB then extracts part information from the page HTML (JSON-LD, OpenGraph, meta tags) and pre-fills the part creation form — no copy-pasting required.

How it works

1. Browse to any product page (distributor, manufacturer datasheet, etc.)
2. Click the Part-DB toolbar button
3. The extension sends the page HTML and URL to your Part-DB instance
4. Part-DB opens the pre-filled "Create Part" form in a new tab

The extension sends the already-loaded page HTML, so Part-DB never needs to fetch the page itself — meaning it works even behind logins, CAPTCHAs, or bot-blocking sites.

Requirements

• Part-DB server v2.12+ with browser plugin support enabled
• Chrome 109+ or Firefox 109+

Installation

From browser extension store (recommended)

The extension is available in the Chrome Web Store and Firefox Add-ons store. Just search for "Part-DB Browser Plugin" or click the links below:

• Chrome Web Store
• Firefox Addons-Store

Install unsigned version from this repository

1. Download partdb-browser-plugin.zip from the latest release
2. Extract the zip

Chrome / Chromium / Edge:

• Open chrome://extensions
• Enable Developer mode (top-right toggle)
• Click Load unpacked and select the extracted folder

Firefox:

• Open about:debugging#/runtime/this-firefox
• Click Load Temporary Add-on
• Select manifest.json inside the extracted folder

For firefox the plugin is only temporary loaded and will be removed when you restart the browser.

From source

git clone https://github.com/Part-DB/part-db-browser-plugin.git
cd part-db-browser-plugin

Then load the src/ directory as an unpacked extension (see above).

Configuration

After installing, click the extension icon and then Open Settings (or right-click the icon → Options). You can configure one or more Part-DB instances; click + Add instance to add another.

Setting	Description
Name	Optional label to tell instances apart, e.g. Production. Defaults to the hostname if left blank.
Part-DB base URL	Root URL of your Part-DB instance, e.g. https://partdb.example.com
Interface locale	Language code used in Part-DB URLs, e.g. en, de, fr. Check your browser's address bar when using Part-DB.

Use the Test Connection button on an instance to verify its URL is reachable and you are logged in.

If you configure more than one instance, the popup shows an Instance dropdown to pick which one to submit to — it remembers your last choice for next time.

Permissions

Permission	Type	Reason
storage	Required	Saves your configured Part-DB instances and settings
activeTab	Required	Reads the page HTML on demand when you click Submit
scripting	Required	Executes the page-reading code in the active tab
Host access to your Part-DB URL(s)	Optional — granted when you save a server URL	Required to reach your Part-DB instance(s); scoped to exactly the URLs you configure

No host permissions are requested at install time. The extension has no passive presence on web pages — it reads page content only at the moment you click Submit.

Building

The extension is plain JavaScript with no build step. PNG icons can be generated from the SVG source:

# or
bash generate_icons.sh      # requires inkscape, rsvg-convert, or imagemagick

The GitHub Actions CI packages the extension as a zip on every push and for every release tag (v*).

Contributing

Bug reports and pull requests are welcome. Please open an issue first for significant changes.

License

GNU Affero General Public License v3.0 — see LICENSE.