PosterPilot

PosterPilot は、メディアライブラリ （Plex、Jellyfin、または Emby — 一度に 1 つがアクティブ）を閲覧し、複数のプロバイダーをまたいでアートワークのカバーを 見つけ、選んだカバーをメディアサーバーに適用するセルフホスト型ウェブアプリです — その API を通じて直接、 かつ／または Kometa/PMM 互換の YAML をエクスポートすることで適用できます。これは Mac または Unraid サーバー上で単一の Docker コンテナとして動作します。

ガイド付きの初回インストールウィザードが、言語の選択から、サーバー、TMDB キー、 プロバイダーの接続、ライブラリの選択、そして最初の同期まで、順を追って案内します — そして Plex の場合は PIN ログインと接続検出も含まれているため、トークンや URL を探し回る必要は ありません。

機能

ライブラリを同期

映画と番組のライブラリを同期し、各タイトルを TMDB id に解決することで、アートワークプロバイダーに 正確に問い合わせできるようにします。

カバーを見つける

有効なプロバイダー — MediUX、Fanart.tv、TMDB、ThePosterDB — をまたいで展開し、ポスターと背景の 候補をプロバイダーとセットごとにグループ化して比較します。セット全体を使うことも、複数の プロバイダーをまたいでピースを組み合わせることも、貼り付けた URL やアップロードしたファイルから カスタムセットを組み立てることもできます。

カバーを適用

選んだカバーを、メディアサーバーの API 経由（フィールドをアップロードしてロックし、即座に反映）で、 かつ／または、次回の実行時に Kometa インスタンスが取り込む Kometa YAML エクスポート経由で適用します。

ローカライズを維持

UI は英語、スペイン語、簡体字中国語、日本語、ブラジルポルトガル語で提供され、キーごとに英語へ フォールバックします — Weblate を通じて管理されています。

ライブラリ全体にわたる処理は、Server-Sent Events によるライブ進捗付きのバックグラウンドジョブとして 実行され、進捗はダッシュボードに直接表示されます。きめ細かい アクティビティ ログ（設定 → アクティビティ）とローテーションするファイルログがすべての操作イベントを記録し、「新着情報」 モーダルを備えた更新チェッカーが新しいリリースを通知します。

次に進む場所

インストール 公式の GHCR イメージを使って、Mac または Unraid 上で Docker Compose により PosterPilot を実行します。

設定 メディアサーバーを接続し、TMDB キーを設定し、アートワークプロバイダーを有効にして、環境変数の完全なリファレンスを学びます。

使い方 ライブラリを同期し、カバーを見つけて適用し、カスタムセットを作成し、ライブラリウォールをフィルタします。

貢献 プロジェクトをローカルでセットアップし、変更を提出する前に品質ゲートを実行します。

技術スタック

• Bun 上の SvelteKit（TypeScript）、adapter-node でビルド
• ライブラリキャッシュ、候補、履歴、ジョブ、設定のための SQLite + Drizzle ORM（libsql）
• Tailwind CSS v4、ダークで画像中心の UI
• ライブ進捗のための Server-Sent Events を備えたインプロセスジョブキュー

PosterPilot は MIT License の下でリリースされています。