Velvarr
ReleasesSee the changelog on GitHub

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

Example request

Requested by a household member

  1. Pendingwaits for a decision
  2. Approvedadministrator or moderator
  3. ProcessingWhisparr downloads it
  4. In libraryJellyfin has the file
Status: In library Watch in Jellyfin
The statuses that a request shows in Velvarr. Artwork is blurred on this page.

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.

  1. Browse

    Movies, scenes, performers, and studios in one grid, with filters that the URL keeps.

    TPDB and StashDB
  2. Request

    A member sends one request. Each account can hold up to 500 requests that wait for a decision.

    Velvarr
  3. Approve

    An administrator or moderator decides. An account with the auto-approve grant skips the wait.

    Velvarr, then Whisparr V3
  4. Watch

    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
  1. Open http://127.0.0.1:6699.
  2. Enter VELVARR_SETUP_SECRET from .env.local to create the owner account.
  3. 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.