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…
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).
Client Credentials
Username
The username Jellyfin clients use to connect to this proxy.
Password
Leave blank to keep the current password.
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.
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.
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.
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
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.
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.
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.
Sort Name
Strip Leading Articles
Comma-separated. Titles beginning with these words sort by the remainder. Leave empty to disable.
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.
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.
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.
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.
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.
Performance
Default Page Size
Max Page Size
Stash Timeout (seconds)
Stash Retries
Logging
Log Level
Log Directory
Max Log File Size (MB)
Log Backup Count
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.
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.
Log Viewer
DEBUG
INFO
WARNING
ERROR
Loading…