삼성 Tizen TV에 Jellyfin 설치하기 — 단계별 완전 가이드

삼성 Tizen TV에 Jellyfin 설치하기

Samsung Smart TV Tizen OS Jellyfin NAS 홈미디어서버

왜 Jellyfin인가?

삼성 스마트 TV는 Tizen OS를 기반으로 운영됩니다. Tizen은 삼성이 2012년부터 독자 개발한 리눅스 기반 OS로, 스마트TV·웨어러블·IoT 기기에 폭넓게 사용됩니다. 그러나 구글 Play Store를 지원하지 않기 때문에 설치 가능한 앱이 Samsung Smart Hub 앱스토어로 제한됩니다.

NAS(네트워크 결합 스토리지)에 저장된 영상을 TV에서 재생하려면 다음과 같은 선택지가 있습니다:

방법	장점	단점
DLNA	별도 앱 불필요, 기본 내장	외부 자막(.srt 등) 미지원, 코덱 제한
DS Video (Synology)	자막·트랜스코딩 지원	Synology NAS 전용, 타 NAS 사용 불가
Plex	다양한 기기 지원, 안정적	고급 기능은 유료(Plex Pass), 서버 필요
Jellyfin	완전 무료·오픈소스, 트랜스코딩·자막 지원	Tizen 공식 앱스토어 미등록, 수동 설치 필요

💡 Jellyfin이란?
Jellyfin은 Emby의 오픈소스 포크(fork)로 2018년에 시작된 완전 무료 미디어 서버 소프트웨어입니다. 서버 소프트웨어를 PC·NAS·라즈베리파이 등에 설치하고, 클라이언트 앱으로 접근하는 구조입니다. 트랜스코딩(실시간 포맷 변환), 다국어 자막, 메타데이터 자동 수집 등을 지원합니다.

---

설치 전 준비사항

• 삼성 스마트 TV (Tizen OS 탑재 모델 — 2017년 이후 대부분의 삼성 스마트 TV)
• TV와 같은 네트워크(Wi-Fi 또는 유선)에 연결된 Windows·Linux·Mac PC
• Jellyfin 서버가 이미 설치된 NAS 또는 PC
• Tizen Studio (삼성 개발 IDE)

⚠️ 주의: TV와 PC는 반드시 동일한 로컬 네트워크에 있어야 합니다. 개발자 모드 활성화 후 재부팅하면 설정이 초기화될 수 있으므로 설치 완료 후 개발자 모드를 끄는 것을 권장합니다.

---

빠른 설치 (Docker 원클릭)

Docker가 설치된 환경이라면 아래 명령어 한 줄로 전 과정을 자동화할 수 있습니다:

docker run --rm ghcr.io/georift/install-jellyfin-tizen \
  <TV의 IP 주소> \
  "Jellyfin-TrueHD" \
  "https://github.com/jeppevinkel/jellyfin-tizen-builds/releases/download/..."

이 컨테이너는 Tizen 개발 도구(sdb)를 포함하고 있어 별도 Tizen Studio 설치 없이도 동작합니다. 단, TV 개발자 모드 활성화는 사전에 직접 해야 합니다.

---

수동 설치 단계별 가이드

1

TV 개발자 모드 활성화

1. 리모컨으로 Apps(앱) 메뉴 진입
2. 리모컨 숫자 키패드로 12345 입력 → OK 버튼
3. 개발자 모드 팝업이 뜨면 ON으로 전환
4. PC의 IP 주소 입력 후 OK (보안상 1개 IP만 등록 가능)
5. TV 재부팅

▲ Apps 메뉴에서 12345 입력하면 숨겨진 개발자 모드 팝업이 나타남

▲ Developer mode: On으로 전환 후 Host PC IP 입력

▲ 재부팅 후 Apps 화면 좌상단에 Apps(DEVELOP MODE) 표시 확인

📌 개발자 모드는 삼성이 서드파티 앱 사이드로딩을 위해 제공하는 기능입니다. 이 모드를 통해 TV가 Tizen SDB(Smart Development Bridge, Android의 ADB와 유사) 포트(26101)를 열고 외부 PC의 연결을 허용합니다.

2

Tizen Studio 설치

삼성 개발자 포털에서 OS에 맞는 버전을 내려받습니다:

OS	파일명
Windows (64bit)	web-ide_Tizen_Studio_4.6_windows-64.exe
Linux (Ubuntu 64bit)	web-cli_Tizen_Studio_4.6_ubuntu-64.bin
macOS	web-ide_Tizen_Studio_4.6_macos-64.dmg

설치 후 Package Manager에서 TV Extensions 패키지를 추가 설치합니다. sdb.exe(Windows) 또는 sdb(Linux/Mac) 명령어가 활성화됩니다.

💡 SDB란? Smart Development Bridge의 약자로, Android의 ADB(Android Debug Bridge)에 대응하는 Tizen 전용 디버그 도구입니다. 앱 설치·디버깅·파일 전송 등을 CLI로 처리합니다.

3

TV 연결 확인

터미널(또는 명령 프롬프트)에서 다음 명령어로 TV에 연결합니다:

# TV IP로 연결 (기본 포트: 26101)
sdb connect 192.168.0.66

# 연결된 디바이스 목록 확인
sdb devices

성공 시 아래와 같이 디바이스 목록에 TV가 표시됩니다:

List of devices attached
192.168.0.66:26101      device      UE55TU7000

⚠️ 연결이 안 될 경우: TV와 PC가 같은 서브넷인지 확인하고, TV 방화벽 설정이나 공유기의 AP 격리(AP Isolation) 기능이 활성화되어 있는지 점검하세요.

4

Jellyfin 앱(.wgt) 설치

Tizen 앱의 배포 형식은 .wgt (Web Application Archive)입니다. HTML5·CSS·JavaScript로 만들어진 웹앱을 패키징한 포맷입니다.

사전 빌드된 파일은 GitHub에서 다운로드:

# 예시: GitHub Releases에서 최신 .wgt 다운로드 후 설치
sdb install Jellyfin.wgt

직접 소스에서 빌드하려면 Node.js와 Tizen SDK CLI가 추가로 필요합니다.

▲ '다운받은 앱' 목록에 Jellyfin 아이콘이 나타나면 설치 성공

📦 TrueHD 빌드 vs 일반 빌드
Jellyfin-TrueHD 빌드는 Dolby TrueHD·Atmos 오디오 패스스루를 지원하는 버전입니다. 일반 빌드보다 용량이 크지만, AV리시버를 통해 고음질 오디오를 출력하려면 이 버전을 사용하세요.

5

앱 실행 및 서버 연결

설치가 완료되면 TV 앱 목록에 Jellyfin이 나타납니다. 실행 후:

1. Jellyfin 서버 주소 입력 (예: http://192.168.0.100:8096)
2. 계정 ID / 비밀번호 입력
3. 라이브러리(영화·TV쇼·음악 등) 선택 후 재생

💡 서버 주소는 로컬 IP 대신 도메인(예: jellyfin.local)을 사용하면 IP가 바뀌어도 재설정할 필요가 없습니다. NAS의 mDNS·Bonjour 설정을 활용하세요.

---

자주 묻는 질문 (FAQ)

TV를 재부팅하면 앱이 사라지나요?

일반적으로는 유지됩니다. 다만 Tizen OS 펌웨어 업데이트 후 개발자 모드 서명 앱이 초기화되는 경우가 있어, 이때는 재설치가 필요합니다.

지원되는 TV 모델은?

Tizen 4.0 이상을 탑재한 2018년 이후 삼성 스마트 TV에서 대부분 동작합니다. 구형 모델(Tizen 2.x·3.x)은 일부 기능이 제한될 수 있습니다.

앱스토어를 통해 설치할 수 없나요?

현재 Jellyfin은 삼성 Smart Hub 앱스토어에 공식 등록되어 있지 않습니다. 커뮤니티 기여로 등록 절차가 진행 중이지만 아직 미완료 상태입니다.

---

참고 자료

• https://github.com/Georift/install-jellyfin-tizen — Docker 자동 설치 스크립트
• https://github.com/jeppevinkel/jellyfin-tizen-builds/tags — 사전 빌드된 .wgt 파일 릴리즈
• https://jellyfin.org — Jellyfin 공식 홈페이지
• Samsung Developer — Tizen Studio 설치 가이드