Kyoo
A self-hosted video server for movies, series and anime that sorts messy folders on its own, with web, Android, Android TV and Chromecast clients.
Kyoo at a glance
What is Kyoo?
Kyoo is a media server for video that positions itself against Plex and Jellyfin. It needs no folder layout or manual metadata fixes: badly named files and odd anime titles are expected to scan correctly, and a failed match counts as a bug. Everything is built in rather than added through plugins. It transcodes on the fly with adaptive bitrate, shows preview thumbnails on the seek bar, detects intros and credits by audio fingerprinting, and renders PGS and ASS subtitles with embedded fonts. Login works through any OIDC provider. Version 5 rewrote most of the code into separate services backed by PostgreSQL.
Good fit if
- Your downloads folder is a mess and you do not want to rename anything.
- You watch a lot of anime with styled subtitles.
- You run Kubernetes and want an official Helm chart.
Before you adopt it
Kyoo is GPL-3.0 with no paid parts in the repository. One developer writes nearly all commits, which the README itself states, so features land at one person's pace; watch-list sync and offline downloads have not returned in v5 yet. Installation uses Docker Compose with about ten services, including PostgreSQL and a proxy, or the Helm chart. The interface counts 19 languages, with translations handled on Weblate.
Drafted with AI from the project's README and repository data, then checked against that data on 7 November 2026. Report a correction
How to run Kyoo yourself
One-click install
Not listed in the app catalogs of Umbrel, YunoHost, TrueNAS, Unraid, CasaOS, Runtipi, Proxmox VE Helper-Scripts and Coolify.
Ways to install
- Docker files
- Dockerfile or compose file in the repository
- Compose file
- docker-compose.yml: 10 services (proxy, postgres)
- Setup effort
- 4 of 5, judged from the compose file
- Kubernetes
- Helm chart in the repository
- Desktop and mobile
- Builds for Android in GitHub releases
- Interface languages
- 19 languages, including English, German, French, Spanish, Portuguese, Dutch, Polish, Russian, Ukrainian and Turkish
Show all 19
Arabic, Catalan, Chinese, Dutch, English, French, Galician, German, Japanese, Korean, Malayalam, Polish, Portuguese, Romanian, Russian, Spanish, Tamil, Turkish, Ukrainian
Install instructions: kyoo.zoriya.dev or the README on GitHub.
Kyoo health: is it still maintained?
72 of 100, actively developed
Read from GitHub on 12 November 2026. How the score works
Kyoo security
Security advisories are the vulnerabilities the maintainers disclosed on GitHub, with the versions that fix them; many advisories can mean careful disclosure as much as weak code.
Latest advisories
- GET /video/streams requires only core.play, letting any account read which user is watching which file in real time, with their user id, session id and playbackNo fixed version listed
- OIDC login token can be redirected to an attacker-controlled URL
- Transcoder serves uncataloged files from the media directory
Advisories read from GitHub on 12 November 2026.
Kyoo license: is it open source?
Kyoo uses GPL-3.0, an open-source license approved by the OSI.
- August 2019First published on GitHub.
- TodayGPL-3.0.
Kyoo for developers
Written in
- TypeScript 64%
- Go 21%
- Python 11%
- Hurl 1%
- PLpgSQL 1%
- Other 2%
Getting involved
Language shares are GitHub’s count of the code in the repository.
Alternatives to Kyoo
- SeerrOpen-source media request and discovery manager for Jellyfin, Plex, and Emby. 84 health · MIT · 13.2k stars
- OwncastTake control over your live stream video by running it yourself. Streaming + chat out of the box. 75 health · MIT · 11.7k stars
- OmbiWant a Movie or TV Show on Plex/Emby/Jellyfin? Use Ombi! 60 health · GPL-2.0 · 4.1k stars
- JellyfinThe Free Software Media System - Server Backend & API 85 health · GPL-2.0 · 59.3k stars
- Beetsmusic library manager and MusicBrainz tagger 83 health · MIT · 15.9k stars
Questions about Kyoo
Is Kyoo open source?
Yes. Kyoo is published under GPL-3.0, an OSI-approved open-source license.
Is Kyoo still maintained?
Its health score is 72 of 100 (actively developed). It had 362 commits in the last 90 days, the latest on 11 November 2026, and its latest release came out on 1 November 2026.
How do I run Kyoo?
You can run it with Docker, on Kubernetes with the Helm chart in the repository and as an app for Android. The README on GitHub has the exact steps.
What is Kyoo written in?
Kyoo is written mainly in TypeScript (64% of the code), with Go (21%) and Python (11%), by GitHub’s count of the repository.
What languages is Kyoo available in?
The repository has interface translations for 19 languages, including English, German, French, Spanish, Portuguese, Dutch, Polish and Russian.
What are the alternatives to Kyoo?
Close alternatives in the Media servers & streaming category include Seerr, Owncast, Ombi.