OpenSource-Hub
K

Kyoo

2.4k stars·Video & Audio Download·SHA-256 checksum verified

A self-hosted media server for movies, series & anime, designed to require minimal maintenance – no manual folder structure or metadata edits needed. Alternative to Jellyfin/Plex.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Drop files, Kyoo handles messy names and folders – a true set-and-forget media server.

Core Features

  • Dynamic transcoding with auto quality and instant seek
  • Video preview thumbnails on hover
  • Intro/credit detection via audio fingerprinting or chapter titles
  • Enhanced subtitle support (PGS/VODSUB/SSA/ASS) with embedded fonts
  • Anime name parsing for messy filenames like `[Some-Stuffs] Jojo...`

What It Can't Do

  • ⚠️ Only web client currently available; Android client is a work-in-progress (v5 rewrite); iOS/tvOS not planned,⚠️ No music, e-books, or games support – video only,⚠️ No plugin system; feature additions depend on core development releases,⚠️ SSA/ASS subtitles with animations may cause performance issues in some browsers

Use Cases

  • Personal media library for movies, TV shows and anime
  • Home server / NAS deployment with Docker or Kubernetes
  • Anime fans who have files with unconventional naming schemes

Detailed Introduction

Kyoo is a self-hosted media server laser-focused on video content (movies, TV series, anime). Unlike Jellyfin or Plex, it doesn't require you to rename files or follow a strict folder structure – just point it at your download directory and it works. Built-in features include dynamic transcoding with auto quality, instant seek, video preview thumbnails, intro/credit detection via audio fingerprinting, enhanced subtitle support (PGS/VODSUB/SSA/ASS with embedded fonts), and advanced anime name parsing for messy filenames. Kyoo has no plugin system; everything is bundled. It supports OIDC authentication (Google, Discord, Authelia) and can be deployed to Kubernetes via an official Helm chart. Currently the only client is web (React-Native/Expo); Android is in development. iOS/tvOS are not planned due to hardware and developer fee costs. Translations are community-driven via Weblate.

Troubleshooting & FAQ (1)

Troubleshooting
How to fix Kyoo transcoder not using dedicated NVIDIA GPU when an integrated GPU is present?

Modify the **transcoder-nvidia** service in your docker-compose.yml to explicitly target your dedicated GPU by specifying its device ID. Replace capabilities: [gpu] with:

devices:
  - driver: nvidia
    device_ids: ['0']
    capabilities: [gpu]

Alternatively, if your Docker runtime supports CDI, use:
deploy:
  resources:
    reservations:
      devices:
        - driver: cdi
          device_ids:
            - nvidia.com/gpu=all

This issue was present in Kyoo v4.7.0 and has been fixed in the master branch.

GitHub Issue #641

Tags

media-serverself-hostedjellyfin-alternativeplex-alternativeanimetranscodingkubernetesoidcvideo-streaming

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Deploy via Docker or Helm per INSTALLING.md

4

Step 2: Mount your media directory (no special structure required)

5

Step 3: Launch, access via web browser, configure OIDC if desired

Install Guide
  1. Step 1: Deploy via Docker or Helm per INSTALLING.md
  2. Step 2: Mount your media directory (no special structure required)
  3. Step 3: Launch, access via web browser, configure OIDC if desired
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Stop and remove the container/Helm release, delete data volumes if needed (backup config & DB first). For Docker Compose: `docker compose down -v`.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseCustom (likely AGPL-3.0 or similar open-source)
Last Updated2026-06-27 11:55:17
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects