Skip to content

Library

TheMRX13 edited this page Jun 12, 2026 · 3 revisions

Library

🌐 English · Deutsch

The library (/library) shows all downloaded series and movies from the download path and all custom paths — grouped by title, season and episode, including file sizes.

Screenshot: library

Automatic refresh

  • On startup the library is fully scanned once and cached in the DB.
  • A file watcher (watchdog) monitors all library paths and automatically rescans only the affected folder on changes.
  • A manual refresh can be triggered from the UI at any time.
  • With language separation enabled, language folders are displayed separately.

File management (admin only)

Action Description
Rename Rename series folders and files according to the naming template
Move Move titles between library paths — with progress display (copied bytes / total)
Delete Delete episodes, seasons or entire titles
Media info Technical details via ffprobe: codec, resolution, audio/subtitle tracks, duration, bitrate

In-browser player (live transcode)

Every file can be played directly in the browser:

  1. When playback starts, the app probes the file via ffprobe and starts an HLS transcode session (FFmpeg).
  2. The best available H.264 encoder is chosen automatically — hardware (NVENC, VAAPI, VideoToolbox) before software (libx264). The Encoding page shows the detection and lets you reset it.
  3. The player supports seeking (the session restarts at the requested position).
  4. Progress saving: the playback position is stored per file — playback resumes at the last position ("continue watching").

For security, only files inside the configured library paths can be streamed; stream URLs are token-based and restricted to the app's own origin.

Upscaling from the library

Individual episodes, seasons or entire titles can be sent to the upscale queue straight from the library (Anime4K Upscaling).

External API

The library inventory is also available via the external REST API (/api/v1/library, /api/v1/library/series, /api/v1/library/movies) — see API Reference.

Clone this wiki locally