 |
Summary | Discover scenes from StashDB that you don’t have locally. View missing scenes for performers and studios, with optional Whisparr integration for automated downloading and cleanup. |
 |
Repository | https://github.com/carrotwaxr/stash-plugins/tree/main/plugins/missingScenes |
 |
Source URL | https://carrotwaxr.github.io/stash-plugins/stable/index.yml |
 |
Install | How to install a plugin? |
Missing Scenes
Discover scenes from StashDB that you don’t have in your local library. Browse missing scenes for performers and studios, with optional Whisparr integration for automated downloading and cleanup.
Links
- Repository: GitHub - carrotwaxr/stash-plugins
- Issues: GitHub · Where software is built
Installation
- Go to Settings → Plugins → Available Plugins
- Add source:
https://carrotwaxr.github.io/stash-plugins/stable/index.yml - Find “Missing Scenes” under “Carrot Waxxer” and click Install
- Reload plugins
Features
Core
- Find missing scenes for any performer or studio linked to StashDB
- Visual grid with thumbnails, titles, release dates, and performer info
- Click any scene to view it on StashDB
- Works with StashDB, FansDB, or any configured stash-box endpoint
Whisparr Integration (Optional)
- Add missing scenes directly to Whisparr with one click
- Bulk “Add All to Whisparr” button
- Live status tracking: Downloading (with %), Queued, Stalled, Waiting, Downloaded
- Auto-cleanup: Automatically removes scenes from Whisparr when tagged in Stash
Automation
- “Scan for New Scenes” task uses your Stash scan defaults
- “Cleanup Whisparr” bulk task for maintenance
- Scene.Update.Post hook for automatic Whisparr cleanup
Configuration
Configure in Settings → Plugins → Missing Scenes:
| Setting | Description |
|---|---|
| Stash-Box Endpoint | Which stash-box to query (defaults to first configured) |
| Whisparr URL | Your Whisparr instance (e.g., http://localhost:6969) |
| Whisparr API Key | From Whisparr Settings → General → Security |
| Quality Profile ID | Whisparr quality profile (default: 1) |
| Root Folder | Where Whisparr downloads scenes |
| Search on Add | Auto-search when adding to Whisparr |
| Auto-cleanup Whisparr | Remove from Whisparr when scene gets tagged |
| Unmonitor Instead of Delete | Keep in Whisparr but prevent re-download |
| Scan Path | Path for “Scan for New Scenes” task (e.g., /data/unsorted) |
Recommended Workflow
- Browse missing scenes for a performer or studio
- Add scenes to Whisparr (individually or bulk)
- Whisparr downloads the scenes to your scan path
- Run “Scan for New Scenes” task (or schedule it via cron/User Scripts)
- Tag imported scenes using Stash’s Tagger
- Hook automatically removes tagged scenes from Whisparr
Requirements
- Stash v0.25.0 or later
- At least one stash-box endpoint configured (Settings → Metadata Providers)
- Performers/Studios must be linked to stash-box (use the Tagger)
- Whisparr v3 for Whisparr integration
Troubleshooting
“Performer/Studio is not linked to StashDB”
Use the Tagger to match and link the performer/studio to StashDB first.
“No stash-box endpoints configured”
Add an endpoint at Settings → Metadata Providers → Stash-box Endpoints.
Whisparr status not showing
Verify your Whisparr URL and API key in plugin settings. Check Stash logs for errors.
Issues? Report them at GitHub · Where software is built
Changelog
v1.2.0
- Added Whisparr status tracking (Downloading %, Queued, Stalled, Waiting)
- Added Auto-cleanup hook (removes from Whisparr when tagged in Stash)
- Added “Scan for New Scenes” task with user’s default scan settings
- Added “Cleanup Whisparr” bulk task
v1.1.0
- Added Whisparr integration
- Added bulk “Add All to Whisparr” button
v1.0.0
- Initial release with performer and studio support
