지원
적용 대상: NAS Player (tvOS · App Store 이름 Easy NAS Player TV) 버전: 1.0
이 앱에 대하여
NAS Player 는 Apple TV 에서 내 NAS · 파일 서버의 사진과 동영상을 보고 재생하는 앱입니다. iPhone · iPad 용 Easy NAS Photo Viewer 의 Apple TV 판이며, 업로드 · 다운로드 기능은 없습니다 — 파일을 Apple TV 로 내려받거나 NAS 로 올리지 않고, 서버에 있는 그대로 보여 주고 재생합니다.
- 무료 · 광고 없음 · 인앱 구입 없음
- 연결할 수 있는 서버: Synology NAS(DSM), SMB 공유 폴더(Windows · macOS · NAS), SFTP 서버
- 사진: 전체 화면 보기 · 리모컨 좌우로 이전/다음 · 확인 버튼 메뉴(확대 · 축소 · 회전) · 슬라이드쇼
- 사진 보관함(1.1): 이 Apple TV 의 사진 보관함 · 앨범 · 공유 앨범을 같은 화면 · 슬라이드쇼로(읽기만)
- 동영상: 재생 엔진 선택 · 자동 이어보기 · 다음 파일 자동 재생 · 자막(srt · smi · vtt) 자동 탐색과 스타일
- 폴더 탐색: 썸네일 · 목록 보기, 정렬, 열 수. 서버의 파일 관리(새 폴더 · 이름 변경 · 삭제 · 이동, Synology 에서는 압축 · 압축 풀기)
iPhone 판(Easy NAS Photo Viewer)과는 별개의 앱이라 설정과 자격 증명을 공유하지 않습니다.
요구 사항
- Apple TV(tvOS 17.0 이상)
- 본인 소유의 Synology NAS(DSM 7.x 권장), SMB 공유 폴더 또는 SFTP 서버
- Apple TV 와 서버가 같은 네트워크에 있거나, 서버를 밖에서 접속할 수 있게 열어 둔 상태
NAS 연결하기
설정 → NAS 프로필 에서 프로필을 추가합니다. 프로필은 여러 개 등록해 전환할 수 있습니다. 글자 입력은 tvOS 키보드로 하며, 같은 Apple 계정의 iPhone 이 가까이 있으면 iPhone 키보드로 입력할 수도 있습니다.
Synology NAS
- 서버 종류:
Synology - 주소: 같은 네트워크면 LAN IP(예:
192.168.1.10), 밖에서는 DDNS 주소 또는 QuickConnect ID - 포트 · HTTPS: DSM 기본값은 HTTP
5000/ HTTPS5001. 바꿨다면 그 번호 - 계정 · 비밀번호: DSM 계정
- 2단계 인증: 계정에 2FA 가 켜져 있으면 2단계 인증 사용을 켜고, 접속할 때 OTP 를 입력합니다. 이 기기를 30일간 신뢰를 고르면 그동안 OTP 없이 로그인하고, OTP 자동 생성 시드(Base32)를 넣어 두면 앱이 코드를 계산합니다.
- 연결 테스트로 확인합니다.
HTTPS 로 자체 서명 인증서를 쓰는 NAS 는 첫 접속 때 인증서 신뢰 확인이 뜹니다. 수락하면 그 인증서의 지문을 저장해 다음 접속에 대조합니다.
SMB 공유 폴더
- 서버 종류:
SMB - 주소(예:
192.168.1.20) · 공유 이름 · 필요하면 도메인 - 계정 · 비밀번호(사용자명을 비우면 guest 로 연결)
SFTP 서버
- 서버 종류:
SFTP - 주소 · 포트(기본 22) · 시작 경로
- 인증: 비밀번호 또는 OpenSSH 개인 키(Ed25519 · RSA, 암호 문구 지원)
- 첫 접속 때 서버의 호스트 키 지문이 뜹니다. 확인하고 신뢰하면 연결되고, 이후 서버 키가 바뀌면 연결을 막습니다.
접속이 안 될 때
- 주소와 포트를 다시 확인합니다.
- 방화벽 — DSM 제어판 → 보안 → 방화벽(또는 서버의 방화벽)에서 해당 포트가 막혀 있지 않은지 확인합니다.
- 로컬 네트워크 권한 — 사설 IP(
192.168.x등)에 처음 연결할 때 tvOS 가 한 번 묻습니다. 거부했다면 Apple TV 설정의 개인정보 보호 항목 → 로컬 네트워크에서 NAS Player 를 켜야 LAN 의 서버에 닿습니다. 앱은 기기를 자동으로 탐색하거나 스캔하지 않고, 사용자가 입력한 주소로만 연결합니다. - 인증서가 계속 거부되면 프로필을 지우고 다시 만들어 신뢰 확인을 새로 받습니다(서버 인증서를 새로 발급하면 지문이 바뀝니다).
자주 묻는 질문
Q. 동영상이 재생되지 않습니다
Synology NAS 의 동영상은 설정 → 동영상 → 기본 재생 방식에서 엔진을 바꿔 보세요.
- 내장 VLC (VLCKit) — 기본값. MKV · AVI · WMV 등 거의 모든 형식과 자막
- 직접 재생 (AVPlayer) — Apple 기본 재생기. MP4 · MOV · H.264 · HEVC
- Video Station (HLS) — NAS 의 Video Station 이 변환해 스트리밍합니다. 해당 패키지가 설치돼 있어야 합니다.
- 고화질 (mpv) — 저해상도 영상을 TV 에 맞게 키우는 GPU 업스케일링 · 디밴딩 · 선명화
매번 고르려면 재생 시 선택 시트 표시를 켭니다. SMB · SFTP 서버의 동영상은 내장 VLC 로 재생합니다.
Synology 동영상 재생에는 NAS 의 HTTP 포트(DSM 기본 5000)가 열려 있어야 합니다. 재생 엔진은 앱이 저장한 자체 서명 인증서 신뢰를 함께 쓰지 못해 HTTP 로 연결합니다. HTTPS 만 열어 두었다면 DSM 제어판에서 HTTP 를 켜 주세요.
Q. 자막이 안 나옵니다
동영상과 같은 폴더에 같은 이름의 .srt · .smi · .vtt 파일이 있어야 자동으로 붙습니다(예: movie.mkv 에는 movie.srt 또는 movie.ko.srt).
인코딩(UTF-8 · CP949 · EUC-KR 등)은 자동으로 판별하고, 글자 크기 · 색 · 외곽선 · 배경은 설정 → 동영상 → 자막 기본 스타일에서 바꿉니다.
Q. 영상이 중간부터 시작합니다
자동 이어보기입니다. 처음부터 보려면 재생이 시작될 때 잠깐 뜨는 「처음부터」를 고르세요. 기록을 모두 지우려면 설정 → 데이터 → 이어보기 기록 지우기.
Q. 파일을 Apple TV 로 내려받거나 NAS 로 올릴 수 있나요?
아니요. 이 앱에는 업로드 · 다운로드 기능이 없습니다. 사진과 동영상은 서버에서 읽어 바로 보여 주고 재생합니다. 썸네일과 이미지는 메모리에만 잠시 두며, 앱을 종료하면 사라집니다.
Q. 설정이 다른 Apple TV 와 동기화되나요?
1.0 에서는 동기화되지 않습니다. 설정은 Apple TV 마다 따로 정합니다(일부 설정값이 iCloud Key-Value 저장소에 기록되지만 다른 기기로 불러오지는 않습니다 — 개인정보 처리방침 4절).
NAS 주소 · 계정 · 비밀번호는 동기화되지 않습니다 — 이 기기의 Keychain 에만(ThisDeviceOnly) 저장되므로 새 기기에서는 다시 입력합니다.
Q. 화면이 항상 밝게/어둡게 나옵니다
설정 → 외관 에서 시스템 · 라이트 · 다크 중에 고릅니다.
Q. 문제가 생겼습니다. 무엇을 보내면 되나요?
설정 → 진단 → 진단 로그 에서 최근 동작 기록을 볼 수 있습니다. Apple TV 에는 공유 기능이 없어 로그를 내보낼 수는 없습니다 — 오류가 보이는 화면을 사진으로 찍어 보내 주시면 됩니다. 로그는 자동으로 전송되지 않습니다.
Q. 이 앱은 Synology 가 만든 앱인가요?
아닙니다. 이 앱은 Synology Inc. 가 만들거나 보증한 앱이 아닌 독립 개발 앱입니다.
Synology · DSM · QuickConnect · Video Station 은 Synology Inc. 의 상표이며, 이 앱이 어느 기기와 동작하는지를 말하기 위해서만 씁니다.
오픈소스 / Open source (LGPL)
이 앱은 동영상 재생에 LGPL 오픈소스 라이브러리를 씁니다.
- MPVKit(mpv · FFmpeg · libplacebo 등, LGPL-2.1+ / LGPL-3.0+) — 「고화질 (mpv)」 재생. 앱 실행 파일에 정적으로 링크됩니다.
- TVVLCKit(VLC, LGPL v2.1 이상) — 「내장 VLC」 재생
- AMSMB2(libsmb2 포함, LGPL v2.1 이상) — SMB 연결
수정한 LGPL 라이브러리로 이 앱을 다시 링크하는 데 필요한 자료(앱 오브젝트 파일 · 링크 명령 · 방법)와 구성 요소별 판 · 소스 위치를 빌드마다 아래 공개 저장소에 올립니다.
재링크 자료 · 소스 요청: https://github.com/yjinchoi/nasplayer-relink
서면 제의: NAS Player 의 각 빌드를 마지막으로 배포한 날로부터 최소 3년 동안, 요청하는 누구에게나 그 빌드에 쓰인 LGPL 라이브러리의 완전한 대응 소스 코드와 재링크 자료를 배포에 드는 실비를 넘지 않는 비용(내려받기 링크는 무료)으로 제공합니다. 요청은 위 저장소의 GitHub 이슈로 해 주세요(빌드 번호를 적어 주세요).
라이선스 전문과 구성 요소별 고지는 앱 안의 설정 → 정보 → 오픈소스 라이선스에도 있습니다.
문의 · 버그 신고
보고할 때 아래를 함께 주시면 훨씬 빨리 해결됩니다.
- 앱 버전(설정 → 정보 → 버전)
- tvOS 버전, Apple TV 모델
- 서버 종류(Synology DSM 버전 · SMB · SFTP)
- 재현 절차 — 무엇을 눌렀고 무엇이 일어났는지
1인 개발 프로젝트입니다. 지원은 최선을 다해(best-effort) 제공되며 응답 시간은 상황에 따라 다를 수 있습니다.
Synology · DSM · QuickConnect · Video Station 은 Synology Inc. 의 상표입니다. 이 앱은 Synology Inc. 가 만들거나 보증한 앱이 아니며 Synology Inc. 와 제휴 관계가 없습니다.