Jellyfin에 영화를 넣었는데 목록에 안 나오는 원인으로 공식 FAQ는 파일 권한과 폴더 구성을 꼽습니다. 공식 문서 기준으로 영화·드라마 폴더 구성, 파일 이름 규칙, 쓰면 안 되는 문자, 디스크 이미지 처리를 정리했습니다.
Jellyfin에 영화를 넣었는데 목록에 안 나오는 원인으로 공식 FAQ는 파일 권한과 폴더 구성을 꼽습니다. 공식 문서 기준으로 영화·드라마 폴더 구성, 파일 이름 규칙, 쓰면 안 되는 문자, 디스크 이미지 처리를 정리했습니다.
Jellyfin 미디어가 안 보이는 이유
Jellyfin 공식 FAQ는 미디어가 라이브러리에 안 나오는 원인을 대개 두 가지로 봅니다. 하나는 Jellyfin이 미디어 파일을 읽을 권한이 없는 경우이고, 다른 하나는 폴더와 파일 이름이 Jellyfin 스캐너가 알아보는 구성이 아닌 경우입니다. 설정 마법사에서 라이브러리 폴더를 고를 때 폴더가 목록에 안 보이는 것도 권한 문제일 수 있다고 공식 문서에 적혀 있습니다. 두 가지가 아니면 버그일 수 있으니 공식 포럼이나 채팅에 물어보라고 안내합니다.
Jellyfin 영화 폴더와 파일 이름
영화는 ‘영화’ 라이브러리 유형으로 추가하고 영화마다 폴더를 따로 만듭니다.
| 구분 | 내용 |
|---|---|
| 폴더 이름 | 영화 이름 (연도) [메타데이터 ID] |
| 연도·ID | 선택 사항 · 넣으면 인식이 정확해짐 |
| 파일 이름 | 폴더 이름과 같게 |
| 예시 | Jellyfin Documentary (2030).mkv |
| 같은 폴더에 둘 것 | 자막(.srt)·포스터·배경 이미지 |
| 지원 형식 | mp4·mkv 등, VIDEO_TS·BDMV 폴더 |
Jellyfin 드라마 시즌과 회차 이름
드라마는 ‘프로그램(Shows)’ 라이브러리 유형으로 추가합니다. 시리즈 폴더 아래에 시즌 폴더를 두고, 시즌 폴더 안에 회차 파일을 넣습니다. 시리즈 폴더 이름은 ‘시리즈 이름 (연도)’, 시즌 폴더는 ‘Season 01’, 회차 파일은 ‘시리즈 이름 S01E01.mkv’ 형식입니다. 특별편은 ‘Season 00’ 폴더에 넣습니다. 파일 하나에 두 회차가 들어 있으면 ‘S01E01-E02’처럼 적을 수 있지만 목록에는 한 항목으로 보여서, 공식 문서는 회차별로 나눈 파일을 권합니다.
Jellyfin 디스크 이미지와 금지 문자
ISO 같은 디스크 이미지 파일은 재생은 되지만 공식 지원 대상이 아닙니다. 공식 문서는 mkv로 다시 담거나 VIDEO_TS·BDMV 폴더로 풀어 두라고 권합니다. VIDEO_TS·BDMV 폴더는 여러 버전, 여러 부분, 외부 자막·음성 트랙을 지원하지 않습니다. 파일 이름에는 < > : ” / \ | ? * 문자를 쓰지 않습니다. Jellyfin이 예약해 둔 문자라서 넣으면 문제가 생긴다고 공식 문서에 적혀 있습니다.
Jellyfin을 시작하기 전에 먼저 알아 둘 것은 공식 서버가 없다는 점입니다. 내 PC나 서버에 직접 설치하고, 내가 가진 영상과 음악을 라이브러리로 추가해 다른 기기에서 봅니다. 설치 뒤 http://내부IP:8096 에 접속해 설정 마법사에서 관리자 계정과 라이브러리를 만들고, 자동 포트 매핑은 공식 권고대로 끕니다. 미디어가 안 보이면 파일 권한과 이름 규칙부터 확인합니다. 영화는 영화마다 폴더, 드라마는 Season 01과 S01E01 형식입니다. 집 밖에서 보려면 포트를 바로 열지 말고 리버스 프록시나 VPN을 쓰라고 공식 문서는 권합니다. 12.0으로 올릴 때는 데이터 폴더 전체를 백업하고, 올린 뒤 전체 라이브러리 스캔을 합니다.
