wagesj45/archive-org-link-grabber
wagesj45/archive-org-link-grabber
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: document per-tab badges and release:push updates.json automation

Browse source
This commit is contained in:
Jordan Wages 2025-08-23 00:30:56 -05:00
commit ff5b02d07c
2 changed files with 13 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

7
README.md
View file

@ -30,7 +30,7 @@ Add-on for Firefox that enhances archive.org download pages (https://archive.org
- Send to aria2: pushes to your configured aria2 RPC server using `aria2.addUri`.
- Or use the page’s context menu: right‑click → "Collect links…" for quick "All" or top‑type actions.
Tip: The browser action badge shows counts when collecting/sending via context menu quick actions.
Tip: The browser action badge is per‑tab and reactive: on archive.org download pages it defaults to the total number of links; when you adjust filters in the popup, it shows the filtered count for that tab. It updates as you switch tabs.
## Regex and Matching
@ -141,7 +141,7 @@ For development, make changes and click “Reload” in `about:debugging` to pic
- Background is a non‑module MV2 script. `src/lib/aria2-bg.js` exposes `addUri`, `addUrisBatch`, and `getVersion` on `globalThis` for background use.
- Context menu parent: "Collect links…" appears on archive.org `/download/*` pages; submenu is rebuilt dynamically for top file types per page.
- BrowserAction badges show counts and state after collecting, copying, or sending.
- BrowserAction badges are per‑tab: default to total links on archive pages; switch to filtered counts when the popup is used on that tab. They also show counts and state after quick actions (copy/send) scoped to the current tab.
## Contributing
@ -164,6 +164,7 @@ This project is not affiliated with archive.org or aria2. Use responsibly and re
- Set environment secrets locally (do not commit): `AMO_JWT_ISSUER=... AMO_JWT_SECRET=...`
- Run: `npm run release:sign`
- Artifacts land in `releases/<version>/`
- Self-hosted updates: `releases/updates.json` is tracked; update with the new version and `update_link` like `https://add-ons.jordanwages.com/archive-org-link-grabber/releases/<version>/archive-org-link-grabber-<version>.xpi`.
- Push (self-hosted): `npm run release:push` uploads the signed artifacts in `releases/<version>/` and prepares/uploads `releases/updates.json` automatically (deriving the `update_link` from the manifest’s `applications.gecko.update_url`).
- Ensure FTP env vars are set (see `.env.example`).
Notes: Keep AMO secrets local (see `.env.example`). CI is optional. You can tag releases with `git tag vX.Y.Z` and push tags if desired.