Kyoo
자체 호스팅 비디오 미디어 서버로, 영화/TV 시리즈/애니메이션에 특화되어 있으며 폴더 구조를 정리할 필요가 없고, 동적 트랜스코딩, 오프닝/엔딩 감지, 애니메이션 파일명 파싱을 지원하는 유지 관리 부담이 적은 Jellyfin/Plex 대안입니다.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
파일을 던져 넣기만 하면 재생되고, 애니메이션 깨진 파일명을 자동으로 인식하는 자체 구축 미디어 라이브러리
주요 기능
- 동적 트랜스코딩: 자동 화질 조정, 즉시 탐색, 대기 불필요
- 비디오 미리보기 썸네일: 진행 바에 마우스를 올리면 비디오 클립 확인
- 오프닝/엔딩 자동 감지: 오디오 지문 또는 챕터 제목 기반
- 강력한 자막: PGS/VODSUB/SSA/ASS 지원, 내장 폰트 사용
- 애니메이션 파일명 파싱: 아무리 엉망인 이름도 정확히 인식
할 수 없는 것
- •⚠️ 현재 Web 클라이언트만 사용 가능하며, Android 클라이언트는 아직 완성되지 않음(v5 재작성 중), iOS/tvOS는 계획 없음,⚠️ 음악, 전자책, 게임 등 비디오 이외의 콘텐츠는 지원하지 않음,⚠️ 플러그인 시스템이 없으며, 기능 확장은 전적으로 내장 개발에 의존하므로 새 기능은 업데이트를 기다려야 함,⚠️ 실시간 자막 미리보기는 일부 브라우저에서 성능이 저하될 수 있음(SSA/ASS 애니메이션 효과)
사용 사례
- 개인/가정용 미디어 라이브러리: 영화, 드라마, 애니메이션을 원스톱으로 관리
- NAS/서버 배포: Docker 또는 Kubernetes와 함께 사용하여 모든 플랫폼에서 액세스 구현
- 해외 드라마/애니메이션 애호가: 다양한 명명 규칙의 미디어 파일 자동 인식
상세 설명
Kyoo는 영화, TV 시리즈, 애니메이션에 특화된 셀프 호스팅 비디오 미디어 서버입니다. Jellyfin이나 Plex와 달리 파일 이름을 수동으로 변경하거나 특정 폴더 구조를 따를 필요가 없습니다. 다운로드 디렉터리를 그대로 넘겨주면 바로 작동합니다. 내장 기능으로는 동적 트랜스코딩(자동 화질, 즉시 탐색 지원), 비디오 미리보기 썸네일, 오디오 핑거프린팅을 통한 오프닝/엔딩 감지, 향상된 자막 지원(PGS/VODSUB/SSA/ASS, 내장 폰트 지원), 강력한 애니메이션 파일 이름 파싱('[Some-Stuffs] Jojo...' 같은 엉망인 파일 이름도 손쉽게 처리)이 포함됩니다. Kyoo에는 플러그인 시스템이 없으며 모든 기능이 내장되어 있습니다. OIDC 인증(Google, Discord, Authelia)을 지원하며 Kubernetes 배포를 위한 공식 Helm Chart를 제공합니다. 현재는 Web 클라이언트(React-Native/Expo)만 제공되며 Android 클라이언트는 개발 중입니다. iOS/tvOS는 하드웨어 및 연간 비용 문제로 당분간 계획이 없습니다. 번역은 커뮤니티가 Weblate를 통해 기여합니다.
문제 해결 & FAQ (2)
문제 해결통합 GPU가 있을 때 Kyoo 트랜스코더가 전용 NVIDIA GPU를 사용하지 않는 문제를 해결하는 방법
**transcoder-nvidia** 서비스를 docker-compose.yml에서 수정하여 장치 ID를 지정해 전용 GPU를 명시적으로 대상으로 삼으세요. capabilities: [gpu]를 다음으로 대체하세요:
devices:
- driver: nvidia
device_ids: ['0']
capabilities: [gpu]또는 Docker 런타임이 CDI를 지원하는 경우 다음을 사용하세요:
deploy:
resources:
reservations:
devices:
- driver: cdi
device_ids:
- nvidia.com/gpu=all이 문제는 Kyoo v4.7.0에 존재했으며 master 브랜치에서 수정되었습니다.
문제 해결Kyoo에서 direct playback(pristine mode) 중에 다른 오디오 트랙을 선택할 수 없는 이유는 무엇인가요?
Kyoo v4.7에서는 트랙 선택이 직접 재생이 아닌 HLS 재생을 필요로 하기 때문에 오디오 트랙이 'Unavailable in pristine'으로 표시됩니다. 해결 방법: 품질 설정을 Pristine에서 Auto(또는 특정 해상도)로 변경하여 HLS 모드를 강제로 전환한 다음, 오디오 트랙 메뉴를 열어 다른 트랙을 선택하세요. 참고: v4.7에서는 이 전환에 버그가 있어 메뉴가 표시되더라도 실제로 트랙 변경이 적용되지 않을 수 있습니다. 다른 오디오 트랙을 선택하면 스낵바 알림과 함께 플레이어가 pristine에서 HLS로 자동 전환되도록 수정될 예정입니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
1단계: 공식 설치 가이드(INSTALLING.md)에 따라 Docker 또는 Helm을 사용하여 배포
2단계: 미디어 디렉터리를 Kyoo 컨테이너에 매핑(특정 구조 불필요)
3단계: 시작 후 웹 브라우저를 통해 접속하여 사용자 및 OIDC 로그인 구성(선택 사항)
- 1단계: 공식 설치 가이드(INSTALLING.md)에 따라 Docker 또는 Helm을 사용하여 배포
- 2단계: 미디어 디렉터리를 Kyoo 컨테이너에 매핑(특정 구조 불필요)
- 3단계: 시작 후 웹 브라우저를 통해 접속하여 사용자 및 OIDC 로그인 구성(선택 사항)
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
실행 중인 컨테이너/Helm release를 중지 및 삭제하고 데이터 볼륨을 제거합니다(구성과 데이터베이스 백업에 주의하세요). Docker Compose를 사용하는 경우 `docker compose down -v`를 실행하여 모든 리소스를 정리하세요.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs