nothing2obvi/pixelfin

これは何？

主な機能

• 01メディア項目ごと、ライブラリごとに、アートワークの欠落やサイズ範囲外を検出します。
• 02検索、アップロード、削除、Backdropの並べ替えなど、アプリ内で画像を編集できます。
• 03アートワークをZIPにエクスポートし、ドライランでの確認と並べて表示する比較を行ってから復元できます。
• 04概要表とJellyfinへのリンクを含む、自己完結型のHTMLギャラリーを生成します。
• 05Series、Movies、Music、Music Videos、Collectionsの各ライブラリに対応しています。
• 06Pythonでローカル実行するか、amd64およびarm64向けDockerで実行できます。

ユースケース

• 大規模なJellyfinライブラリから、解像度の低いポスターやBackdropの欠落を見つける。
• Jellyfinサーバーの再構築や移行の前に、アートワークをバックアップする。
• サーバー移行後、まずドライランで確認してからZIP内のアートワークを復元する。
• アートワークを目視で確認し、ライブラリ全体の統一感を整える。

クイックスタート

1. 1

   requirements.txt から Python の依存関係をインストールします

   pip install -r requirements.txt
2. 2

   Pixelfin を起動します

   python app.py
3. 3

   ブラウザーで Web アプリを開きます

使う前に知っておきたいこと

• !ライセンスが指定されていないため、利用権が不明確です。
• !セキュリティを考慮して作られていないため、ローカル環境または信頼できるプライベートネットワーク内でのみ実行してください。
• !稼働中の Jellyfin サーバーと Jellyfin API キーが必要です。
• !作者は、堅牢化された本番用アプリではなく、ローカルツールとして説明しています。

収録されている特集

トピック

よくある質問

pixelfin とは？

Jellyfinのアートワークを監査し、画像の欠落やサイズ不適合を検出・編集して、ZIPにバックアップできるローカルWebアプリです。 Pixelfinは、Jellyfinライブラリ内のアートワークを確認するためのローカルWebアプリです。メディア項目ごとに、Primary、Backdrop、Logo、ClearArt、Banner、Thumbなどの画像タイプを一覧表とビジュアルギャラリーで確認できます。画像が欠落している場合や、最小解像度を下回っている場合、任意で設定できる最大解像度を超えている場合はフラグが付くため、差し替えが必要なアートワークを見つけられます。

pixelfin は無料で使えますか？ライセンスは？

pixelfin にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。

pixelfin は今もメンテナンスされていますか？

活発にメンテナンス中。pixelfin の最終コミットは 2026年10月23日 です。

pixelfin は何に使えますか？

大規模なJellyfinライブラリから、解像度の低いポスターやBackdropの欠落を見つける。 Jellyfinサーバーの再構築や移行の前に、アートワークをバックアップする。 サーバー移行後、まずドライランで確認してからZIP内のアートワークを復元する。 アートワークを目視で確認し、ライブラリ全体の統一感を整える。

pixelfin のインストール方法は？

requirements.txt から Python の依存関係をインストールします: pip install -r requirements.txt Pixelfin を起動します: python app.py ブラウザーで Web アプリを開きます

pixelfin はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/nothing2obvi/pixelfin