지원

적용 대상: 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 로 올리지 않고, 서버에 있는 그대로 보여 주고 재생합니다.

iPhone 판(Easy NAS Photo Viewer)과는 별개의 앱이라 설정과 자격 증명을 공유하지 않습니다.


요구 사항


NAS 연결하기

설정 → NAS 프로필 에서 프로필을 추가합니다. 프로필은 여러 개 등록해 전환할 수 있습니다. 글자 입력은 tvOS 키보드로 하며, 같은 Apple 계정의 iPhone 이 가까이 있으면 iPhone 키보드로 입력할 수도 있습니다.

Synology NAS

  1. 서버 종류: Synology
  2. 주소: 같은 네트워크면 LAN IP(예: 192.168.1.10), 밖에서는 DDNS 주소 또는 QuickConnect ID
  3. 포트 · HTTPS: DSM 기본값은 HTTP 5000 / HTTPS 5001. 바꿨다면 그 번호
  4. 계정 · 비밀번호: DSM 계정
  5. 2단계 인증: 계정에 2FA 가 켜져 있으면 2단계 인증 사용을 켜고, 접속할 때 OTP 를 입력합니다. 이 기기를 30일간 신뢰를 고르면 그동안 OTP 없이 로그인하고, OTP 자동 생성 시드(Base32)를 넣어 두면 앱이 코드를 계산합니다.
  6. 연결 테스트로 확인합니다.

HTTPS 로 자체 서명 인증서를 쓰는 NAS 는 첫 접속 때 인증서 신뢰 확인이 뜹니다. 수락하면 그 인증서의 지문을 저장해 다음 접속에 대조합니다.

SMB 공유 폴더

  1. 서버 종류: SMB
  2. 주소(예: 192.168.1.20) · 공유 이름 · 필요하면 도메인
  3. 계정 · 비밀번호(사용자명을 비우면 guest 로 연결)

SFTP 서버

  1. 서버 종류: SFTP
  2. 주소 · 포트(기본 22) · 시작 경로
  3. 인증: 비밀번호 또는 OpenSSH 개인 키(Ed25519 · RSA, 암호 문구 지원)
  4. 첫 접속 때 서버의 호스트 키 지문이 뜹니다. 확인하고 신뢰하면 연결되고, 이후 서버 키가 바뀌면 연결을 막습니다.

접속이 안 될 때

  1. 주소와 포트를 다시 확인합니다.
  2. 방화벽 — DSM 제어판 → 보안 → 방화벽(또는 서버의 방화벽)에서 해당 포트가 막혀 있지 않은지 확인합니다.
  3. 로컬 네트워크 권한 — 사설 IP(192.168.x 등)에 처음 연결할 때 tvOS 가 한 번 묻습니다. 거부했다면 Apple TV 설정의 개인정보 보호 항목 → 로컬 네트워크에서 NAS Player 를 켜야 LAN 의 서버에 닿습니다. 앱은 기기를 자동으로 탐색하거나 스캔하지 않고, 사용자가 입력한 주소로만 연결합니다.
  4. 인증서가 계속 거부되면 프로필을 지우고 다시 만들어 신뢰 확인을 새로 받습니다(서버 인증서를 새로 발급하면 지문이 바뀝니다).

자주 묻는 질문

Q. 동영상이 재생되지 않습니다

Synology NAS 의 동영상은 설정 → 동영상 → 기본 재생 방식에서 엔진을 바꿔 보세요.

  1. 내장 VLC (VLCKit) — 기본값. MKV · AVI · WMV 등 거의 모든 형식과 자막
  2. 직접 재생 (AVPlayer) — Apple 기본 재생기. MP4 · MOV · H.264 · HEVC
  3. Video Station (HLS) — NAS 의 Video Station 이 변환해 스트리밍합니다. 해당 패키지가 설치돼 있어야 합니다.
  4. 고화질 (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 오픈소스 라이브러리를 씁니다.

수정한 LGPL 라이브러리로 이 앱을 다시 링크하는 데 필요한 자료(앱 오브젝트 파일 · 링크 명령 · 방법)와 구성 요소별 판 · 소스 위치를 빌드마다 아래 공개 저장소에 올립니다.

재링크 자료 · 소스 요청: https://github.com/yjinchoi/nasplayer-relink

서면 제의: NAS Player 의 각 빌드를 마지막으로 배포한 날로부터 최소 3년 동안, 요청하는 누구에게나 그 빌드에 쓰인 LGPL 라이브러리의 완전한 대응 소스 코드와 재링크 자료를 배포에 드는 실비를 넘지 않는 비용(내려받기 링크는 무료)으로 제공합니다. 요청은 위 저장소의 GitHub 이슈로 해 주세요(빌드 번호를 적어 주세요).

라이선스 전문과 구성 요소별 고지는 앱 안의 설정 → 정보 → 오픈소스 라이선스에도 있습니다.


문의 · 버그 신고

보고할 때 아래를 함께 주시면 훨씬 빨리 해결됩니다.


1인 개발 프로젝트입니다. 지원은 최선을 다해(best-effort) 제공되며 응답 시간은 상황에 따라 다를 수 있습니다.

Synology · DSM · QuickConnect · Video Station 은 Synology Inc. 의 상표입니다. 이 앱은 Synology Inc. 가 만들거나 보증한 앱이 아니며 Synology Inc. 와 제휴 관계가 없습니다.