IPTV Tunerr

HDHomeRun 튜너 에뮬레이션 및 라이브 TV 스트리밍

IPTV Tunerr는 IPTV 채널을 HDHomeRun 호환 네트워크 튜너로 인덱싱하여 미디어 서버의 내장된 라이브 TV 기능을 그대로 사용할 수 있게 합니다. M3U 플레이리스트 또는 Xtream player_api에서 채널을 가져오고, 공급업체 호스트 간 장애 조치, Cloudflare 감지, 클라이언트별 코덱 적응(예: Plex Web) 등의 정책을 자동으로 적용합니다.

EPG(전자 프로그램 가이드) 데이터 관리 및 병합

XMLTV 형식의 가이드 데이터를 제공하며, 공급업체 EPG, 외부 XMLTV 소스, 선택적 짧은 EPG 폴백, 그리고 내장된 플레이스홀더 데이터를 자동으로 우선순위에 따라 병합합니다. 채널 ID(tvg-id)를 할당하거나 수정하고, guide-health 및 epg-doctor 명령을 통해 가이드 커버리지 상태를 분석하고 문제를 해결할 수 있습니다.

멀티 프로바이더 지원 및 장애 조치

하나의 구독에 대해 여러 공급업체 호스트를 동시에 사용하여 CDN 장애 시 자동으로 다른 호스트로 전환할 수 있습니다. 또한 별도의 공급업체 구독에서 채널을 병합하고, 중복 채널을 제거하며, 세션 공유 및 동시 스트리밍 제한을 관리합니다.

채널 인텔리전스 및 분석

채널별 건강도 보고서를 생성하여 가이드 신뢰도, 스트림 복원력, 백업 스트림 깊이 등을 평가합니다. 채널 리더보드를 통해 최적의 채널과 개선이 필요한 채널을 명확히 파악할 수 있으며, 각 채널에 고유한 DNA ID를 할당하여 안정적인 식별자를 제공합니다.

자동 조종 메모리(Autopilot Memory)

성공적인 재생 결정을 기억하여 동일한 채널과 클라이언트 클래스 조합에서 나중에 재사용할 수 있습니다. 이는 매번 동일한 결정을 재발견하는 과정을 줄여줍니다.

가이드 하이라이트 및 캐치업 캡슐

병합된 가이드를 ‘현재 방영 중’, ‘곧 시작’, ‘현재 스포츠’, ‘곧 시작하는 영화’ 등 즉시 유용한 형태로 재구성합니다. 또한 프로그램 블록을 미디어 서버에서 인제스트 가능한 라이브러리 항목(.strm + .nfo)으로 변환하여 Near-Live 캐치업 라이브러리를 자동으로 생성할 수 있습니다.

다운로드 및 설치 방법

IPTV Tunerr는 Docker, Go 바이너리 등 다양한 방법으로 설치할 수 있습니다.

• Docker를 사용한 빠른 시작: Docker Hub 또는 GHCR에서 이미지를 가져올 수 있습니다. docker pull keefshape/iptvtunerr:latest 또는 docker pull ghcr.io/snapetech/iptvtunerr:latest 명령을 사용합니다.
• 바이너리 빌드: GitHub Releases에서 운영 체제에 맞는 바이너리를 다운로드하거나, 소스 코드를 직접 빌드할 수 있습니다. 빌드 명령은 go build -o iptv-tunerr ./cmd/iptv-tunerr입니다.

기본 사용법 및 설정

가장 간단한 첫 실행 경로는 최소 설정 파일과 설정 의료진(setup-doctor) 명령을 사용하는 것입니다.

1. 최소 설정 파일 복사 및 편집: cp .env.minimal.example .env 명령으로 .env 파일을 만들고, 파일을 편집하여 공급업체 URL, 사용자 이름, 비밀번호 및 기본 URL을 설정합니다.
2. 설정 검증: iptv-tunerr setup-doctor 명령을 실행하여 설정이 준비되었는지 확인합니다.
3. 탐색 및 실행: iptv-tunerr probe 명령으로 공급업체를 탐색한 후, iptv-tunerr run -mode=easy 명령으로 프로그램을 시작합니다. 기본적으로 포트 5004에서 튜너 서버가 시작됩니다.
4. 미디어 서버 연결: Plex, Emby, Jellyfin의 라이브 TV 설정에서 HDHomeRun 튜너로 장치 URL(http://<this-host>:5004)과 가이드 URL(http://<this-host>:5004/guide.xml)을 입력하여 연결합니다.

이런 경우에 유용합니다

• IPTV 공급업체를 사용하지만 채널 재생이 불안정하거나 가이드 데이터가 부족하여 Plex, Emby, Jellyfin의 라이브 TV 기능을 원활하게 사용하고 싶을 때.
• 여러 IPTV 공급업체를 구독하고 있고, 이를 하나의 통합된 채널 라인업과 가이드로 관리하고 싶을 때.
• 공급업체 호스트 장애나 클라이언트별 코덱 문제로 인한 스트리밍 중단을 자동으로 처리하고 싶을 때.
• IPTV 채널을 기반으로 자체 브랜딩이 된 가상 채널이나 Near-Live 캐치업 라이브러리를 만들고 싶을 때.

지원 환경 및 시스템 요구사항

Linux, macOS, Windows에서 amd64 및 arm64 아키텍처를 지원합니다. Linux armv7 및 Windows arm64도 부분적으로 지원됩니다. Docker 이미지는 linux/amd64, linux/arm64, linux/arm/v7 멀티 아키텍처를 지원합니다.

최신 버전 및 업데이트

최신 릴리스는 GitHub Releases 페이지에서 확인할 수 있습니다. 버전 태그는 v* 형식을 따릅니다.