Jellyfin

Jellyfin 連携は Macro Deck を 1 つ以上の Jellyfin メディアサーバーに接続し、そこにあるセッション、つまりサインインして再生している Jellyfin のアプリ、ブラウザ、テレビを操作します。Jellyfin のプラグインは必要ありません。サインインには API キーを使います。API キーなら、Macro Deck はサーバー上のすべてのセッションを確認して操作できます。ユーザー名とパスワードでサインインすることもでき、その場合はそのアカウントが操作できるセッションに限られます。

できること

• 再生、一時停止、停止、スキップ、指定位置へのシーク、指定した秒数の早送りと巻き戻し。
• クライアントの音量設定、ミュートとミュート解除、シャッフルとリピートの設定。
• メディアを再生 で、サーバー上の映画、エピソード、曲、アルバムを検索してデバイスで再生する。
• Jellyfin クライアントに見出し付きのメッセージを表示する。
• ミュージックプレーヤー ウィジェットに再生中の内容を、Jellyfin セッション ウィジェットにサーバーの再生状況を表示する。
• 再生の開始、一時停止、再開、停止、項目の変更、クライアントの接続をきっかけにオートメーションを開始する。

設定例:

• リビングのテレビ用の Toggle Play/Pause ボタンと、その横に置いた、直前の 10 秒を繰り返す 巻き戻し ボタン。
• テレビの 再生を開始 で {{ event.itemType }} が Movie のときに照明を暗くするオートメーションと、再生を停止 で照明を明るく戻す 2 つ目のオートメーション。
• メッセージを表示 でテレビに「夕食ができました」と表示するボタン。

サーバーとデバイス

追加した各サーバーは、プレーヤーを選ぶ場所に 2 つの形で表示されます。サーバー名の方は、直近に何かを再生したセッションを対象にします。Server · Device (例: Home · Living Room TV) は常にそのデバイスを対象にし、デバイスの電源が切れている間は未接続と表示されます。Macro Deck は、最後に見かけてから 30 日間デバイスを記憶します。

Jellyfin 10.11 以降では、Macro Deck は WebSocket でサーバーの状態をライブで追跡します。サーバーがライブ更新を送らない場合は、代わりに 2 秒ごとにセッションを問い合わせます。サーバーに接続できなくなると、Macro Deck はバックグラウンドで再試行を続け、何度か失敗すると 連携 の Jellyfin のページに報告します。すべての Jellyfin クライアントがすべてのコマンドに対応しているわけではありません。クライアントが実行できないコマンドは、メッセージを表示して失敗します。