pixelfin

v1.0.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 12d Media Servers

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

images jellyfin

ReleasePort's take

Light signal

editorial:auto 11d

Pixelfin v1.0.0 now serves the new local web app by default at `/`, while the classic UI remains accessible at `/classic`. State storage has shifted to `data/fresh.db` with continued support for existing formats.

Why it matters: The route change redirects all traffic to the new UI; operators must update clients or reverse‑proxy configs accordingly. New state file location requires preserving legacy `history.json`, HTML, ZIP exports, and folders during migration.

Summary

AI summary

Pixelfin defaults to the new local web app while preserving classic UI at /classic.

Changes in this release

Type	Severity	Summary	CVE
Breaking	Medium	Breaks default app route; Pixelfin v1.0.0 becomes the default at `/` while classic interface remains temporarily at `/classic`. Breaks default app route; Pixelfin v1.0.0 becomes the default at `/` while classic interface remains temporarily at `/classic`. Source: llm_adapter@2026-05-23 Confidence: high	—
Feature
Feature	Medium	Adds major UI upgrade, local server-backed web app, cached scan state, dynamic library views with Jellyfin thumbnails, per-item updates, full and compact layouts, summary tables, season poster review, HTML gallery generation, ZIP export/restore enhancements, multi-server support, Docker image support for linux/amd64 and linux/arm64. Adds major UI upgrade, local server-backed web app, cached scan state, dynamic library views with Jellyfin thumbnails, per-item updates, full and compact layouts, summary tables, season poster review, HTML gallery generation, ZIP export/restore enhancements, multi-server support, Docker image support for linux/amd64 and linux/arm64. Source: llm_adapter@2026-05-23 Confidence: low	—
Feature	Medium	Adds Docker image support for `linux/amd64` and `linux/arm64` with tags `ghcr.io/nothing2obvi/pixelfin:v1.0.0` and `latest`. Adds Docker image support for `linux/amd64` and `linux/arm64` with tags `ghcr.io/nothing2obvi/pixelfin:v1.0.0` and `latest`. Source: llm_adapter@2026-05-23 Confidence: low	—
Feature	Medium	Adds major UI upgrade, local server-backed web app, cached scan state for faster repeat review. Adds major UI upgrade, local server-backed web app, cached scan state for faster repeat review. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Introduces dynamic library views with Jellyfin library thumbnails. Introduces dynamic library views with Jellyfin library thumbnails. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Provides library and global settings for image types, thresholds, ZIP filenames, layout, servers, Auto ZIPs, and JellyTag-Plus. Provides library and global settings for image types, thresholds, ZIP filenames, layout, servers, Auto ZIPs, and JellyTag-Plus. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Enables per-item updates, individual library scans, and all-library scans. Enables per-item updates, individual library scans, and all-library scans. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Offers full and compact artwork layouts with summary tables for missing/low-resolution artwork. Offers full and compact artwork layouts with summary tables for missing/low-resolution artwork. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Adds season poster review for series libraries. Adds season poster review for series libraries. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Generates HTML gallery for portable reports. Generates HTML gallery for portable reports. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Enhances ZIP export with internal storage under `output/<Library>/` and restore features including dry-run, match scores, manual matching, image-type controls, and side-by-side comparisons. Enhances ZIP export with internal storage under `output/<Library>/` and restore features including dry-run, match scores, manual matching, image-type controls, and side-by-side comparisons. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Feature	Medium	Supports multiple Jellyfin servers. Supports multiple Jellyfin servers. Source: granite4.1:30b@2026-05-23-audit Confidence: low	—
Refactor	Medium	Changes state storage to `data/fresh.db` while preserving existing `data/history.json`, HTML files, ZIP exports, and output folders. Changes state storage to `data/fresh.db` while preserving existing `data/history.json`, HTML files, ZIP exports, and output folders. Source: llm_adapter@2026-05-23 Confidence: low	—

Full changelog

Pixelfin v1.0.0

Pixelfin v1.0.0 is the big local web app release. The old static-report workflow is preserved as v0.35.8, and the new Pixelfin experience is now the default on main.

Highlights

Major UI upgrade.
Local server-backed web app.
Cached scan state for faster repeat review.
Dynamic library views with Jellyfin library thumbnails.
Library and global settings for image types, thresholds, ZIP filenames, layout, servers, Auto ZIPs, and JellyTag-Plus.
Per-item updates, library scans, and all-library scans.
Full and Compact artwork layouts.
Summary table and task views for missing and low-resolution artwork.
Season poster review for series libraries.
HTML gallery generation for portable reports.
ZIP export, with downloaded ZIPs also saved internally under output/<Library>/.
ZIP restore with dry-run, match scores, manual matching, image-type include controls, and side-by-side comparisons.
Support for multiple Jellyfin servers.
Docker image support for linux/amd64 and linux/arm64.

Breaking Changes and Migration Notes

Pixelfin v1.0.0 is now the default app at /.
The old classic interface is still available at /classic for now.
v1.0.0 stores its new server, library, scan, and settings state in data/fresh.db.
Existing v0.35.8 files are not deleted. Old data/history.json, generated HTML files, ZIP exports, and output/<Library>/ folders remain in place.
Existing exports can still be downloaded or used, but v1.0.0 has its own settings and cached scan state.
After artwork changes in Jellyfin, use Update, Refresh, Scan, or Scan All Libraries before expecting Pixelfin to reflect those changes.

Docker Images

Multi-architecture images are published for:

linux/amd64
linux/arm64

Tags:

ghcr.io/nothing2obvi/pixelfin:v1.0.0
ghcr.io/nothing2obvi/pixelfin:latest

Breaking Changes

Pixelfin v1.0.0 is now the default app served at `/` (classic UI moved to `/classic`).
State storage changed from `data/history.json` and related files to a new SQLite database file `data/fresh.db`.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track pixelfin

Get notified when new releases ship.

About pixelfin

Pixelfin: Jellyfin Image Inspector

All releases →

Related context

Related tools

Earlier breaking changes

v0.35.8 Development Docker compose container now runs on host port 2180