A request app for adult media
Your household browses TPDB and StashDB and asks for a title. You approve it once. Whisparr gets it, and Jellyfin plays it.
- Self-hosted
- MIT license
- One container
- Desktop and phone
Scene · StashDB
- Pendingwaits for a decision
- Approvedadministrator or moderator
- ProcessingWhisparr downloads it
- In libraryJellyfin has the file
One request, from browse to play
Velvarr joins four tools that you already run or use. Each step names the system that does the work.
Browse
Movies, scenes, performers, and studios in one grid, with filters that the URL keeps.
TPDB and StashDBRequest
A member sends one request. Each account can hold up to 500 requests that wait for a decision.
VelvarrApprove
An administrator or moderator decides. An account with the auto-approve grant skips the wait.
Velvarr, then Whisparr V3Watch
When the file is in the library, each user gets a watch link that needs no Jellyfin sign-in.
Jellyfin
Every status is the real status
A plain true status beats a pretty guess. These rules hold everywhere in the app.
- No name matchingA TPDB record and a StashDB record count as one title only when the providers publish the link between them.
- No lost or double addsVelvarr records each attempt before it calls Whisparr, so a restart never loses or duplicates an add.
- Failures have namesWhen a source fails, the page says which one and why. A partial result never reads as complete.
- AI never decides availabilityOptional AI matching only flags a near match for an administrator to review.
What you get
- Catalogs. Movies from TPDB, scenes from TPDB and StashDB, performers, and studios, with each provider’s filters and sort orders.
- Browse. Search, tag include and exclude, up to five performers and five studios, and date ranges. A filter that a source cannot apply says so beside the grid.
- Requests and approvals. Administrator or moderator approval, with an optional auto-approve grant for each account.
- Jellyfin sign-in and playback. Members sign in with their Jellyfin accounts and see availability for their own libraries.
- Performer follows. Follow performers across both providers, with a Following view and a Discover rail.
- Preferences. Hidden tags and Discover shelf order for each account.
- Similar titles. Similar movies and scenes, and “Often appears with” for performers.
- Update notice. The app tells you when a newer GitHub release is out.
Optional: Discord notifications, AI-assisted title matching through TypeSafe or an Ollama model, and natural-language search through an OpenAI-compatible server that you set up. Velvarr checks each tag, performer, and studio before it applies a drafted filter.
Install with Docker
Velvarr runs as one container from ghcr.io/skare69/velvarr.
- Docker with Compose
- Jellyfin for sign-in, libraries, and playback
- Whisparr V3 (Eros) to download approved titles
- A TPDB token, a StashDB key, or both
mkdir velvarr && cd velvarr
curl -fsSLO https://raw.githubusercontent.com/Skare69/velvarr/main/compose.yaml
touch .env.local && chmod 600 .env.local # owner-only: the file holds the database key
printf 'VELVARR_SECRET_KEY=%s\nVELVARR_SETUP_SECRET=%s\n' \
"$(openssl rand -hex 32)" "$(openssl rand -base64 32 | tr '+/' '-_' | tr -d '=')" > .env.local
docker compose up -d
mkdir velvarr; cd velvarr
Invoke-WebRequest https://raw.githubusercontent.com/Skare69/velvarr/main/compose.yaml -OutFile compose.yaml -UseBasicParsing
$rng = [Security.Cryptography.RandomNumberGenerator]::Create()
$k = [byte[]]::new(32); $s = [byte[]]::new(32); $rng.GetBytes($k); $rng.GetBytes($s)
$key = -join ($k | ForEach-Object { $_.ToString('x2') })
$setup = [Convert]::ToBase64String($s).TrimEnd('=').Replace('+', '-').Replace('/', '_')
Set-Content .env.local "VELVARR_SECRET_KEY=$key`nVELVARR_SETUP_SECRET=$setup" -Encoding ascii
docker compose up -d
- Open http://127.0.0.1:6699.
- Enter
VELVARR_SETUP_SECRETfrom.env.localto create the owner account. - Save your TPDB token and StashDB key in Settings, then connect Whisparr.
Back up VELVARR_SECRET_KEY. If you lose it, you cannot read the database or any backup.
Upgrades, health checks, and phone access: install guide. Every variable: configuration.
