nothing2obvi/pixelfin

What is it?

Key features

• 01Flags missing and out-of-range artwork per media item and per library.
• 02Edits images inside the app, including search, upload, delete and backdrop reordering.
• 03Exports artwork to ZIP and restores it with dry-run review and side-by-side comparison.
• 04Generates self-contained HTML galleries with a summary table and links back to Jellyfin.
• 05Supports Series, Movies, Music, Music Videos and Collections libraries.
• 06Runs locally with Python or through Docker on amd64 and arm64.

Use cases

• Finding low-resolution or missing posters and backdrops across a large Jellyfin library.
• Backing up artwork before rebuilding or migrating a Jellyfin server.
• Restoring artwork from a ZIP after a server move, with a dry run first.
• Curating consistent artwork across a library by reviewing it visually.

Quick start

1. 1

   Install the Python dependencies from requirements.txt

   pip install -r requirements.txt
2. 2

   Start Pixelfin

   python app.py
3. 3

   Open the web app in your browser

Things to know

• !No license is specified, so usage rights are unclear.
• !It is not built with security in mind and should only run locally or on a trusted private network.
• !It requires a running Jellyfin server and a Jellyfin API key.
• !The author describes it as a local tool, not a hardened production app.

In collections

Topics

FAQ

What is pixelfin?

A local web app for auditing Jellyfin artwork, flagging missing or wrongly sized images, editing them, and backing them up to ZIP. Pixelfin is a local web app for reviewing the artwork in Jellyfin libraries. It shows a summary table and visual galleries for each media item, covering image types such as Primary, Backdrop, Logo, ClearArt, Banner and Thumb. Missing images are flagged, and so are images below a minimum resolution or above an optional maximum, so you can spot artwork that needs replacing.

Is pixelfin free to use? What license does it have?

pixelfin has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.

Is pixelfin still maintained?

Actively maintained. The last commit to pixelfin was on Oct 23, 2026.

What can I use pixelfin for?

Finding low-resolution or missing posters and backdrops across a large Jellyfin library. Backing up artwork before rebuilding or migrating a Jellyfin server. Restoring artwork from a ZIP after a server move, with a dry run first. Curating consistent artwork across a library by reviewing it visually.

How do I install pixelfin?

Install the Python dependencies from requirements.txt: pip install -r requirements.txt Start Pixelfin: python app.py Open the web app in your browser

Where can I get pixelfin?

The source code and installation instructions are on GitHub: https://github.com/nothing2obvi/pixelfin