⚠
Dashboard
At-a-glance health check and activity monitor
Proxy Status
—
Uptime: —
Stash Connection
—
 
Active Streams
0
In the last 5 min
Library Size
—
Scenes
Active Streams
Updates every 5s
No active streams.
Library Stats
Refreshes every 60s
Scenes
—
Performers
—
Studios
—
Groups
—
Tags
—
Proxy Usage
Streams Today
—
Total Streams
—
Auth Success
—
Auth Failed
—
Top Played
No plays recorded yet.
⚠ Config file is not writable. can't be saved to, so SERVER_ID and ACCESS_TOKEN will regenerate on every restart — clients (Infuse, Swiftfin, SenPlayer) will need to re-add the server each time.
Fix: ensure the proxy process can write to that file. If running in Docker, mount a writable volume for the config directory.
⚠ Config file is not surviving restarts. is writable, but the marker we wrote on the previous boot is gone — the file got wiped between restarts. Settings, SERVER_ID, and ACCESS_TOKEN will keep resetting until this is fixed.
Most likely cause: /config is mounted as an anonymous Docker volume, or the volume isn't actually mounted (so writes land in the container's ephemeral layer and vanish on restart). Check your docker run -v / docker-compose volume mapping.
ℹ Config migrated from v1 to v2. Your original config is backed up at stash_jellyfin_proxy.conf.v1.bak. Review your new settings in Libraries, Players, Playback, and Search tabs.
Recent Logs
View All Logs
Loading…
Connection
Stash server connection and client credentials
Stash Server
Stash URL
Full URL including port. Use host.docker.internal if Stash is on the Docker host.
API Key
From Stash → Settings → Security → API Key. Required for images to load. Leave blank to keep the current value.
GraphQL Path
Advanced: override for reverse-proxy setups.
Request Timeout (seconds)
Retry Attempts
Verify TLS Certificate
Disable for self-signed certificates.
Runs a live probe against the values above (no save required).
Restart required
Client Credentials
Username
The username Jellyfin clients use to connect to this proxy.
Password
Leave blank to keep the current password.
Restart required
Libraries
Tag groups, genre mapping, series detection
Tag Groups
Tag Groups
Comma-separated list of Stash tags to expose as top-level library folders. Each tag becomes a movies library.
Favorite Tag
Stash tag name used for scene favorites. Toggling favorite in a client adds/removes this tag.
Show Tags Library
Expose a Tags folder with tag-based navigation.
Show All Tags Subfolder
Include an "All Tags" subfolder (can be large). Only meaningful if Tags Library is enabled.
Restart required
Genre Configuration
Genre Mode
Genre Parent Tag
Create this tag in Stash and attach your genre tags as direct children. Only one level deep — no nesting.
Top N Count
Number of tags (by scene count, descending) to use as genres. No Stash-side setup required.
Restart required
Playlists
Playlist Parent Tag
Stash tag whose direct children represent Jellyfin playlists. Each child tag becomes one playlist; the scenes carrying that child tag are its items. Created on first playlist creation. Leave blank to disable.
Live
Series Detection
Series Tag
Apply this tag to a Studio in Stash to expose it as a TV Series. Scenes get Season/Episode navigation from title parsing.
Episode Pattern List
One regex per line. Each must capture two groups: (season, episode). First match wins. No match → Season 0, auto-numbered.
Test a Scene Title
Mixed
Players
Per-client rendering profiles and live User-Agent feed
Connected Players
Last 7 days · auto-refresh 30s
Loading…
Player Profiles
Loading…
How to use
To add a new client: connect it to the proxy, wait for it to appear in Connected Players, copy its User-Agent string, click + Add Profile, paste the string into User-Agent Match, and configure rendering options.
Playback
Image formatting, sort defaults, Home-tab hero
Poster Images
Portrait Crop Anchor
Where to anchor the crop when generating a 2:3 portrait from a 16:9 screenshot. Applies only when a player's poster format is portrait.
Per-client poster format (portrait vs landscape) is configured in the Players tab.
Restart required
Sort Defaults
Library Type Default Sort
Scenes
Studios
Performers
Groups
Tag Groups
Saved Filters
This sort is applied when the client sends no sort preference.
Live
Sort Name
Strip Leading Articles
Comma-separated. Titles beginning with these words sort by the remainder. Leave empty to disable.
Live
Home Tab Hero Image
Hero Image Source
Source pool for the cinematic header image on clients' Home tab.
Minimum Rating
Scenes with a Stash rating at or above this threshold are eligible. Only applies when "Top Rated" is selected.
Restart required
Search
Search scope and filter-panel behavior
Search Scope
Include Scenes
Scenes appear in search results.
Include Performers
Performers appear in search results as People (Swiftfin) or Collections (other clients).
Include Studios
Studios appear in search results as Collections.
Include Groups
Groups appear in search results as Collections.
Live
Filter Panel
Maximum Tags in Filter
Maximum number of genre and tag options shown in the client filter panel. Tags are ordered by scene count, most-used first. Applies to both Genres and Tags dimensions.
Multi-Select Filter Logic
When multiple genres are selected in the filter panel: AND = scene must have all selected tags; OR = scene must have any. Standard Jellyfin behavior is OR — AND is a proxy-specific enhancement.
Walk Tag Hierarchy
When filtering by a tag, also include scenes tagged with any of its descendants in Stash.
Live
Genre Hierarchy
Genre definitions (configured in Libraries → Genre Configuration) are flat — only direct children of your genre parent tag are used as genres. Walk Tag Hierarchy applies at search/filter query time only: when a user selects a genre in the filter panel, scenes tagged with that genre's descendants in Stash are included in results.
System
Server identity, performance, logging, security, server control
Server Identity
Server Name
Display name shown in client server lists.
Server ID
Auto-generated UUID used by clients to identify this server. Changing this invalidates all paired clients.
Restart required
Performance
Default Page Size
Max Page Size
Stash Timeout (seconds)
Stash Retries
Restart required
Logging
Log Level
Log Directory
Max Log File Size (MB)
Log Backup Count
Mixed
Security
Require Auth for Config UI
Prompt for the client password before allowing config changes.
IP Ban Threshold
Failed auth attempts before an IP is banned.
Ban Window (minutes)
Banned IPs
Comma-separated list. Edit to unban an IP. Saved immediately.
Live
Server Control
Restart Proxy
Restart the proxy process. Active streams will be interrupted.
Clear Cache
Flush image cache, library-card artwork, genre allow-list, and in-memory TTL caches.
Download Config
Download the current config file as a text backup.
Logs
Proxy log stream, filterable by level and text
Log Viewer
DEBUG
INFO
WARNING
ERROR
Loading…