TRMNL Servarr プラグイン

Tool
TRMNL Servarr プラグイン

TRMNL Servarr プラグイン

TRMNL用のServarrプラグイン。Sonarr/Radarr/Lidarr/Readarr/Prowlarrと連携してダウンロードキューの進行状況、今後のリリース（カレンダー）、最近追加されたメディア、ライブラリ統計、ヘルスステータスなどをE-inkダッシュボードに表示します。複数の表示モード（ダッシュボード、日/週/月のカレンダー）、レスポンシブレイアウト、アイコン表示や進捗バーに対応し、TRMNLデバイス上で視覚的に管理情報を確認できます。（約300字）

https://github.com/pythcon/trmnl-plugin-servarr

概要

TRMNL向けに設計された「trmnl-plugin-servarr」は、Sonarr／Radarr／Lidarr／Readarr／Prowlarrと連携して、E-inkベースのダッシュボード上にメディア管理情報を表示するプラグインです。ダウンロードキューの進捗バー、カレンダー形式の今後のリリース、最近追加されたアイテム、ジャンルや状態ごとのライブラリ統計、そして各アプリのヘルスステータスなどを見やすく整理して出力します。複数の表示モード（ダッシュボード、カレンダーの日／週／月表示）に対応し、TRMNLプラットフォームのテンプレート（Liquid）形式でカスタマイズ可能です。（約300字）

GitHub

リポジトリの統計情報

  • スター数: 4
  • フォーク数: 0
  • ウォッチャー数: 4
  • コミット数: 2
  • ファイル数: 7
  • メインの言語: Liquid

主な特徴

  • Servarr一式（Sonarr, Radarr, Lidarr, Readarr, Prowlarr）に対応
  • ダウンロードキューの進捗表示、カレンダー表示、ライブラリ統計の可視化
  • 複数表示モード（Dashboard / Calendar 日・週・月）とレスポンシブレイアウト
  • 軽量テンプレート（Liquid）でTRMNL向けに簡単カスタマイズ

技術的なポイント

このプラグインはTRMNLプラットフォーム向けにLiquidテンプレートで構築されており、フロント側の描画ロジックは主にテンプレートとアイコン／レイアウト定義で実装されています。collectorディレクトリにはServarr APIからデータを取得するためのスクリプト群が含まれている想定で、各アプリのエンドポイント（カレンダー、キュー、recent、system/statusなど）へHTTPリクエストを行い、JSONを受け取ってTRMNLのレンダリング用データに整形します。.trmnlp.ymlはプラグイン設定や表示モードの定義、APIキーやホスト情報の参照設定を扱うためのエントリポイントです。E-inkデバイス向けの制約（リフレッシュコスト、白黒・グレースケール描画、限られた解像度）を考慮し、進捗は細長いバー、アイコンはシンプルなモノクロSVG風の表現、テキストは読みやすいフォントサイズで統一されています。

エラーや接続不可時のフォールバック表示、サーバ監視（health status）による異常表示、及び取得頻度の調整（キャッシュやTTL）はE-inkの無駄な更新を防ぐため重要です。認証はServarrのAPIキー方式が一般的なので、プラグイン側はAPIキーを設定ファイルか環境変数で安全に取り扱うことを想定します。レスポンシブレイアウトはLiquidテンプレート内で条件分岐してウィジェットの表示／非表示や簡易レイアウト切替を行い、小型の表示領域でも有用な情報が見えるよう最適化されています。リポジトリ自体は小規模（ファイル7、コミット2）でシンプルな構成のため、カスタマイズや他のTRMNLプラグインとの共存が容易です。（約700字）

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • .trmnlp.yml: file
  • README.md: file
  • bin: dir
  • collector: dir

…他 2 ファイル

「bin」には実行可能スクリプトやインストール補助が入る想定、「collector」にはServarr各アプリからデータを取得するロジックが格納されています。.trmnlp.ymlでプラグインのメタや設定を定義し、Liquidテンプレートを編集することでダッシュボードの見た目や表示内容を変更できます。

まとめ

TRMNL環境でServarr群の状態をE-inkに最適化して可視化する小型で実用的なプラグインです。（約50字）

リポジトリ情報：

READMEの抜粋：

TRMNL Servarr Plugin

A TRMNL plugin for displaying data from Servarr applications (Sonarr, Radarr, Lidarr, Readarr, Prowlarr) on your TRMNL e-ink device.

Features

  • Monitor download queues with progress bars
  • View upcoming releases (calendar)
  • See recently added media
  • Library statistics with icons
  • Health status monitoring
  • Support for all Servarr apps (Sonarr, Radarr, Lidarr, Readarr, Prowlarr)
  • Multiple display modes (Dashboard, Calendar Daily/Weekly/Monthly)
  • Responsive layout…