Jelu Importer Browser Add-on

Jelu Importer is a Firefox browser extension that scrapes metadata from popular book catalog pages (Goodreads, Amazon Books, etc.) and sends it to a self-hosted Jelu instance. The add-on focuses on giving users a fast, editable preview before import so they can clean up titles, IDs, narrators, and other fields.

Please note, that I am not a JavaScript developer, as such most of this project is AI generated. I was very hands-on with the process and defining approaches, but almost all of the code work within this project was completed using AI.

Screenshots

Screenshots will be added once the UI is ready.

• Popup / Import Flow:

• Configuration / Options Page:

Currently Supported Catalogs

• Goodreads
• Amazon Books
• Google Books (often has less complete book information)
• Audible

Installation from Releases

Install in Firefox from Mozilla Addons Site

1. Open Jelu Importer Site in Firefox
2. Click Add to Firefox
3. Read permissions dialog and click Add
4. Open the extension options page to configure your Jelu server URL, port, and authentication details before importing

Install in Firefox from GitHub Release

1. Download the latest .xpi package from the GitHub Releases page once builds are published.
2. In Firefox, open about:addons, select Install Add-on From File..., and choose the downloaded .xpi.
3. Verify that the add-on appears in the toolbar and pin it if necessary.
4. Open the extension options page to configure your Jelu server URL, port, and authentication details before importing any books.

Install in Google Chrome from Chrome Web Store

1. Open Jelu Importer on the Chrome Web Store in Chrome
2. Click Add to Chrome
3. Read permissions dialog and click Add extension
4. Pin the extension and configure it via the options page (Chrome > Extensions > Details > Extension options)

Install in Google Chrome from GitHub Release

1. Download the Chrome ZIP artifact from the latest GitHub Release and extract it.
2. Open chrome://extensions, enable Developer mode, and choose Load unpacked.
3. Select the extracted folder that contains manifest.json.
4. Pin the extension and configure it via the options page (Chrome > Extensions > Details > Extension options).

Configuration & Authentication

• Open the add-on’s options page and enter your Jelu base URL (e.g. https://jelu.example.com).
  • In Firefox enter about:addons in the browser URL bar, click the ... next to Jelu Importer, click Preferences
• Provide the username and password you normally use to sign into Jelu.
  • The extension authenticates every request with HTTP Basic, so these credentials must have permission to add books.
  • Credentials are stored in Firefox local storage without encryption
  • If you are concerned about the security of this, create a dedicated, low-privilege Jelu account for this add-on if possible.
  • Note if you use a different account than the one that you primarily use with Jelu then any of the "My Library" functions will not work.
• Choose any default tags or toggle “add to library automatically” if you want the popup checkbox preselected.

The popup mirrors the default settings so you can override them for a specific book before importing.

Documentation

• Architecture & Feature Overview
• Development & Automation Guide

Additional documents will be added under the docs/ directory as the project evolves.

License

Jelu Importer is released under the Apache License 2.0.