Jellyfin

Jellyfin 연동은 Macro Deck을 하나 이상의 Jellyfin 미디어 서버에 연결하고 그 서버의 세션, 즉 로그인하여 재생 중인 Jellyfin 앱, 브라우저, TV와 함께 동작합니다. Jellyfin 플러그인은 필요 없습니다. API 키로 로그인하면 Macro Deck이 서버의 모든 세션을 보고 제어할 수 있으며, 사용자 이름과 비밀번호로 로그인하면 그 계정이 제어할 수 있는 세션으로 제한됩니다.

할 수 있는 일

• 재생, 일시 정지, 정지, 건너뛰기, 특정 위치로 탐색, 지정한 초만큼 앞뒤로 이동.
• 클라이언트의 볼륨 설정, 음소거와 음소거 해제, 셔플과 반복 설정.
• 미디어 재생으로 서버에서 영화, 에피소드, 곡, 앨범을 검색해 기기에서 시작.
• Jellyfin 클라이언트에 제목이 있는 메시지 표시.
• 음악 플레이어 위젯에 재생 중인 내용을, Jellyfin 세션 위젯에 서버의 재생 상황을 표시.
• 재생이 시작, 일시 정지, 재개, 중지될 때, 항목이 바뀔 때, 클라이언트가 연결될 때 자동화 시작.

활용 예:

• 거실 TV용 Toggle Play/Pause 버튼과, 마지막 10초를 다시 보는 그 옆의 뒤로 탐색 버튼.
• TV에 대한 재생 시작됨 자동화로 {{ event.itemType }}이 Movie이면 조명을 어둡게 하고, 재생 중지됨 자동화로 다시 밝게 하기.
• 메시지 표시로 TV에 "저녁 준비됐어요"를 띄우는 버튼.

서버와 기기

추가한 각 서버는 플레이어를 고르는 곳마다 두 가지 형태로 나타납니다. 서버 이름은 가장 최근에 무언가를 재생한 세션을 따라갑니다. 서버 · 기기(예: Home · Living Room TV)는 항상 그 기기를 대상으로 하며, 기기가 꺼져 있는 동안에는 연결되지 않음으로 표시됩니다. Macro Deck은 마지막으로 본 뒤 30일 동안 기기를 기억합니다.

Macro Deck은 Jellyfin 10.11 이상에서 WebSocket을 통해 서버를 실시간으로 따라갑니다. 서버가 실시간 업데이트를 보내지 않으면 대신 2초마다 세션을 요청합니다. 서버가 사라지면 Macro Deck은 백그라운드에서 계속 다시 시도하며, 몇 번 실패하면 연동 아래 Jellyfin 페이지에 알립니다. 모든 Jellyfin 클라이언트가 모든 명령을 지원하지는 않으며, 클라이언트가 수행할 수 없는 명령은 메시지와 함께 실패합니다.