Stasharr

Stasharr — StashDB Extension

A browser extension that augments StashDB with Whisparr and Stash integrations.

Repository Layout

• src/ — Extension source (content scripts + background services)
• scripts/ — Build/pack scripts
• manifest/ — Chrome/Firefox manifests
• docs/ — Architecture and development notes

• Scene card actions: add to Whisparr, trigger search for missing files, monitor/unmonitor, exclude/include
• Status indicators on scene cards (in library, missing file, excluded, error)
• Bulk actions on list pages (Add All / Search All / Add Missing) with progress modal feedback
• Scene details panel with status, quality profile selection, tags editing, and monitor/exclude toggles
• Performer and studio panels with status, add/check, monitor toggle, tags/quality editing, and Whisparr links
• Copy StashDB scene IDs from scene cards and the scene details panel
• Direct links to Whisparr and Stash scenes (when configured)
• Options UI with validation and discovery for quality profiles, root folders, and tags
• Background-only networking for LAN services (Firefox-safe)

From repo root:

npm ci npm run build

Build outputs:

• dist/chrome
• dist/firefox

1. Open chrome://extensions/.
2. Enable Developer mode.
3. Click Load unpacked.
4. Select dist/chrome.

1. Open about:debugging#/runtime/this-firefox.
2. Click Load Temporary Add-on.
3. Select dist/firefox/manifest.json.

1. Open the extension’s options page.
2. Configure Whisparr: base URL (include protocol) and API key, then validate and refresh lists.
3. Configure Stash (optional): base URL (include protocol) and API key.
4. Choose whether external links open in a new tab.

Usage

Scene list pages

• Each scene card gets a status indicator and action row.
• Actions include Add, Search (for missing files), Monitor/Unmonitor, Exclude/Include.
• View buttons jump directly to Whisparr or Stash scenes when configured.
• Bulk actions are available on list pages and show progress in a modal.

• A fixed extension panel shows scene status and actions.
• Update quality profile and tags directly from the panel.
• Copy the StashDB scene ID from the panel.

• A fixed extension panel shows status and actions.
• Add/Check, Monitor toggle, update quality profile and tags, and open in Whisparr.

• Buttons not appearing: Reload StashDB and confirm the extension is enabled.
• Permission errors: Ensure the configured domains were granted host permissions.
• Validation failures: Base URLs must include http:// or https://.

From repo root:

npm run lint npm run build npm run tripwire

License

This project is released under the GNU General Public License v3.0. See LICENSE for details.

Credits

Created by enymawse Original inspiration from randybudweiser's stash2whisparr