Files
Manage the source library
Browse watched roots, inspect linked entities, upload, create folders, rename, move, rescan, exclude, and delete from one focused file manager.
Manages
- Movies
- Series
- Videos
- Comics
- Manga
- eBooks
- Galleries
- Images
- Audio
- People
- Studios
- Tags
- Collections
- Plugins
- Files
Documentation
Where to start
Pick the section that matches what you are trying to do.
01 · Run itSet up your media library
Install with Docker, mount your media directories, run a scan, and start browsing. Library organization, settings, and operations live here.
Quick start→02 · Extend itBuild a metadata pluginWrite providers in TypeScript or Python to identify videos, books, people, audio, and more. Stash-compatible scraper packages can be adapted.
Build plugins→03 · Understand itExplore the architectureSvelte, the .NET worker, Postgres, and the shared packages. How code moves from the UI all the way to the database and job queue.
Architecture→What it does
What Prismedia manages
Built for a single trusted user on a private network. All processing happens locally — no internet access required, no external services.
Streaming
On-demand HLS
Videos transcode to HLS via ffmpeg as they are needed. Cached renditions are served directly from the app — no separate media server, no manual format conversion.
Audio
Your music collection, organized
Albums, tracks, cover art, waveforms, people and studio linking. The same metadata pipeline as every other media type, with shuffle and a built-in player.
Metadata
Reviewable identification
A durable Identify queue lets you run providers, compare proposals, choose artwork, walk child records, and accept only what belongs in your library.
Jobs
Background jobs you can see
Scan, probe, thumbnail, sprite, waveform, HLS, subtitle, and import jobs run in the background. The Jobs dashboard mirrors every queue in real time — so you always know what the system is doing.
Reading
Comics, EPUBs, and PDFs
Comic archives, EPUBs, and PDFs are first-class entities with a built-in reader — paged and webtoon comics, reflowable EPUBs, and a full PDF reader with search, zoom, and resume.
Jellyfin
Play in Infuse and Manet
An experimental Jellyfin-compatible API lets clients like Infuse and Manet sign in and stream your video and audio, with per-profile NSFW filtering and two-way resume sync.
Library
Collections are simple groupings
Create manual, dynamic, or hybrid collections as organizational views over movies, series, galleries, images, books, and audio tracks.
Deploy
One Docker image
PostgreSQL, ffmpeg, the web server, and the worker ship as a single image. Mount /data and /media, expose port 8008, and you are running. Nothing else required.
The interface
Prism Noir Luxe: controlled radii, brass on signal, glass when it floats.
The whole UI follows one design language. Read the Design Language doc for the full spec.
A dashboard built like an instrument panel.
Every media type at a glance — recent activity, library totals, scan state, and job status. Dense, dark, and purposeful.
Rich video playback, start to finish.
HLS adaptive streaming, trickplay frame strip, multi-language subtitles with a dockable transcript panel, and inline metadata editing — all in one page.
Files and catalog views stay connected.
Move between watched folders, linked entities, scan exclusions, and catalog metadata without leaving the app.
Mobile is first-class, not a fallback.
Browse, search, read, and play from any phone on your network. Every view is designed for touch before it scales up to desktop.
Run it on your own hardware
Mount your media, expose one port, and you are running. No cloud accounts and no external dependencies.
docker pull ghcr.io/pauljoda/prismedia:latest