nothing2obvi/pixelfin

这是什么？

核心功能

• 01按媒体条目和媒体库标记缺失或分辨率不符的封面图。
• 02在应用内编辑图片，支持搜索、上传、删除和调整 Backdrop 顺序。
• 03将封面导出为 ZIP，恢复前可预演并查看前后对比。
• 04生成独立的 HTML 画廊，包含汇总表并可跳转回 Jellyfin。
• 05支持电视剧、电影、音乐、音乐视频和合集类型的媒体库。
• 06可用 Python 本地运行，也可通过 Docker 部署（支持 amd64 和 arm64）。

适用场景

• 在大型 Jellyfin 媒体库中找出分辨率过低或缺失的海报和背景图。
• 在重建或迁移 Jellyfin 服务器之前备份封面图。
• 服务器迁移后从 ZIP 恢复封面，并先做预演确认。
• 通过可视化浏览统一整个媒体库的封面风格。

快速上手

1. 1

   从 requirements.txt 安装 Python 依赖

   pip install -r requirements.txt
2. 2

   启动 Pixelfin

   python app.py
3. 3

   在浏览器中打开网页应用

使用前须知

• !未指定许可证，因此使用权限不明确。
• !它在设计时未考虑安全性，只应在本地或可信的私有网络中运行。
• !需要运行中的 Jellyfin 服务器和 Jellyfin API 密钥。
• !作者将其描述为本地工具，而非经过强化的生产级应用。

收录于专题

标签

常见问题

pixelfin 是什么？

一款本地 Web 工具，用于检查 Jellyfin 媒体库的封面图，发现缺失或分辨率不合适的图片，并支持编辑与 ZIP 备份。 Pixelfin 是一个本地 Web 应用，用于检查 Jellyfin 媒体库中的封面图。它为每个媒体条目生成汇总表和图片画廊，覆盖 Primary、Backdrop、Logo、ClearArt、Banner、Thumb 等图片类型，并标出缺失的图片，以及低于最低分辨率或超过可选最高分辨率的图片。

pixelfin 可以免费使用吗？用的什么许可证？

pixelfin 没有声明许可证。代码虽然公开，但没有许可证就没有明确的使用授权，正式使用前建议先联系作者。

pixelfin 还在维护吗？

活跃维护中。pixelfin 最近一次提交是在 2026年10月23日。

pixelfin 适合用来做什么？

在大型 Jellyfin 媒体库中找出分辨率过低或缺失的海报和背景图。 在重建或迁移 Jellyfin 服务器之前备份封面图。 服务器迁移后从 ZIP 恢复封面，并先做预演确认。 通过可视化浏览统一整个媒体库的封面风格。

pixelfin 怎么安装和运行？

从 requirements.txt 安装 Python 依赖: pip install -r requirements.txt 启动 Pixelfin: python app.py 在浏览器中打开网页应用

在哪里获取 pixelfin？

源代码和安装说明在 GitHub 上：https://github.com/nothing2obvi/pixelfin