Tunarr - 내 서버의 미디어에서 라이브 TV 채널을 만들고 구성하기

• Plex와 Jellyfin 미디어 서버를 기반으로 실시간 TV 채널을 생성하고 구성할 수 있는 오픈소스 플랫폼
• 웹 UI에서 채널, 편성표, 광고, 설정을 구성할 수 있음
• 생성된 채널은 Plex, Jellyfin, Emby에 HDHomeRun 에뮬레이터로 추가하거나 M3U 파일을 IPTV 앱에서 재생 가능함
• 기존의 dizqueTV를 현대화하고 성능과 안정성을 개선한 완전한 리브랜딩 버전임
• 브라우저 스트리밍, 고급 필터링, 다양한 트랜스코딩 옵션 등의 기능이 추가됨

Tunarr 개요

• Tunarr는 Plex 또는 Jellyfin 서버에 저장된 미디어를 기반으로 사용자 정의 실시간 TV 채널을 만들 수 있는 시스템임
• Plex, Jellyfin, Emby에서 HDHomerun 에뮬레이션을 사용하거나 M3U IPTV URL을 이용해 다양한 IPTV 앱에서 시청 가능함
• 이전 오픈소스 프로젝트인 dizqueTV의 후속으로 성능 개선, 버그 수정, UI 재설계, 새로운 기능 추가를 목표로 함

주요 목표

• 백엔드와 프론트엔드 스택의 현대화
• 기존 사용자에 대한 마이그레이션 지원
• 안정성과 성능 개선 (Node보다 빠른 Bun 1.2.0 기반 개발)
• 웹 UI의 개선 및 미려한 디자인 적용
• 신규 기능 대거 추가

주요 기능

• Jellyfin 라이브러리 지원 (신규)
• 브라우저에서 직접 채널 스트리밍 가능 (신규)
• 스트리밍 파이프라인 전체 리팩토링으로 성능과 안정성 개선 (신규)
• 향상된 편성 옵션 제공 (신규)
• 다크 모드 지원 (신규)
• 콘텐츠 검색을 위한 고급 필터링 및 정렬 기능 제공 (신규)
• 자동 백업 기능으로 설정 및 채널 보호 (신규)
• 채널별 개별 트랜스코딩 설정 지원 (신규)
• 시간/랜덤 슬롯 편성 UI 개선 (신규)
• HDHomeRun 에뮬레이션 및 IPTV 채널 리스트 제공으로 Plex, xTeVe, Threadfin 등과 연동 가능
• 채널별 로고, 광고, 프리롤, 뮤직비디오 등 삽입 가능
• 웹 기반 TV 가이드에서 채널 라인업 확인 가능
• 하드웨어 가속 트랜스코딩 지원: Nvidia, VAAPI, QuickSync, macOS VideoToolbox
• 자막 기능은 현재 비활성화 중, 안정성을 위해 제거됨. 복구 예정 (#462 이슈에서 추적 중)

현재 한계

• Plex에서 HDHR 사용하려면 Plex Pass 필요
• Plex 서버의 콘텐츠 변경을 자동 감지하지 않음. 수동으로 프로그램을 제거 후 다시 추가해야 반영됨
• Plex 서버의 IP나 포트가 바뀌면 수동으로 서버 설정을 변경해야 함
• 위 기능들은 현재 개발 진행 중 (#15 이슈에서 진행 상황 확인 가능)

기술

• 서버는 Bun 런타임 기반으로 동작함
• 웹 : vite를 사용하여 웹 개발 및 번들링 진행

라이선스

• 원본 dizqueTV는 zlib 라이선스로 배포되며, Tunarr 역시 동일한 라이선스를 유지함