Firefox update

This commit is contained in:
Joey Yakimowich-Payne 2025-10-14 14:12:42 -06:00
commit 8fd5438f6c
4 changed files with 345 additions and 42 deletions

View file

@ -1,6 +1,6 @@
# Reilly SafariBooks Downloader (Chrome & Edge)
# Reilly SafariBooks Downloader (Chrome, Edge & Firefox)
This extension ports the `safaribooks.py` script into a browser workflow so you can download EPUBs directly from [learning.oreilly.com](https://learning.oreilly.com).
This extension ports the `safaribooks.py` script into a browser workflow so you can download EPUBs directly from [learning.oreilly.com](https://learning.oreilly.com) in Chrome, Edge, or Firefox.
## Installation (Chrome or Edge)
@ -10,8 +10,27 @@ This extension ports the `safaribooks.py` script into a browser workflow so you
- **Edge**: `edge://extensions/`
3. Enable **Developer mode** (toggle in the top-right corner).
4. Click **Load unpacked** and select this project folder.
5. The “Reilly SafariBooks Downloader” icon should appear in the toolbar.
5. The "Reilly SafariBooks Downloader" icon should appear in the toolbar.
## Installation (Firefox)
The packaged `.xpi` is unsigned, so the Firefox release channel blocks it. Pick the approach that matches your setup:
- **Temporary load (any Firefox build)**
1. Open `about:debugging#/runtime/this-firefox`.
2. Click **Load Temporary Add-on...** and select `firefox-extension.xpi`.
3. Keep the tab open while testing; Firefox unloads temporary add-ons after a restart.
- **Persistent install for testing (Firefox Developer Edition or Nightly)**
1. Switch to Developer Edition or Nightly—only these builds allow signing to be disabled.
2. In `about:config`, set `xpinstall.signatures.required` to `false`.
3. Open `about:addons`, click the gear icon, and choose **Install Add-on From File...**.
4. Pick `firefox-extension.xpi`, confirm the prompts, then flip the preference back to `true` when you return to normal browsing.
- **Permanent install on Firefox Release**
1. Sign the add-on through Mozilla’s Add-on Developer Hub (https://addons.mozilla.org/developers/) or `web-ext sign`.
2. Use the signed `.xpi` that Mozilla returns; only signed builds will install on stable Firefox.
## Usage
1. Log into [learning.oreilly.com](https://learning.oreilly.com) in the same browser profile.
@ -27,3 +46,4 @@ This extension ports the `safaribooks.py` script into a browser workflow so you
- The extension uses your authenticated cookies; ensure you are signed in before downloading.
- If an image fetch fails, the downloader logs each attempt and tries alternate URLs.
- Placeholder icons live in the `images/` directory—swap them out with custom artwork if you prefer.