Pixelfin

Pixelfin is a lightweight web app and generator script that inspects artwork for items in a Jellyfin library and produces clean, actionable HTML galleries or ZIP bundles. It queries a Jellyfin server using an API key, enumerates available image types per item, and flags missing or low-resolution assets for easy review.

Key Features

• Interactive web UI to connect to a Jellyfin server by API key and select a library
• Generates timestamped HTML galleries summarizing present, missing, and low-resolution images
• Summary table for quick navigation to items with missing or low-resolution artwork
• Clickable gallery images with lightbox viewer and left/right column layout for common image types
• Export options: embedded HTML (base64-encoded images) or custom ZIP archives with filename overrides
• Options to choose which image types to include, set minimum resolution thresholds, and pick color themes (light/dark)
• Background generation process that saves outputs to a local output directory and persists settings to a small data file
• Runs as a simple Python/Flask app or inside Docker using a provided Dockerfile and compose example

Use Cases

• Audit and identify missing or low-resolution artwork across a Jellyfin media library
• Export and reorganize media artwork as ZIP archives with custom filenames for sharing or backup
• Produce portable embedded HTML galleries for offline review or archival purposes

Limitations and Considerations

• Error handling is minimal and behavior may vary with different Jellyfin versions and setups
• Performance can be slow for very large libraries since generation is I/O and network bound
• Official testing reported only on a specific Jellyfin release and on library types: Shows, Movies, Music, and Music Videos
• Certain client-side quirks may appear when opening embedded HTML files directly from the filesystem; placing them inside the instance output directory yields the best experience

Pixelfin is practical for owners of Jellyfin instances who need a fast way to audit and export artwork. It prioritizes functionality and simplicity and is suitable for experimentation or inclusion in automation workflows.