Windows
Not yet available
Pending release// releases
Get Kroma Player
Every version, what shipped in it, and how to run it. Read the status below before you go looking for a download button.
Release on hold
v1.0 is Built. The Release is Pending.
This project on release will be fully open source, and avaialble to all platforms. The delay is caused by discussion of the fair use of this tool. We want to hear from you. Join the Discord to stay current on the situation!
// binaries
Prebuilt downloads
These are the packages that will be published when v1.0 goes out. None of them are live yet.
macOS
Not yet available
Pending releaseLinux
Not yet available
Pending releaseRun it from source
This path works right now and is the same application the binaries will contain. You'll need Python 3.11 or newer.
# 1. Clone the repository
git clone https://github.com/KromaKobra/kroma-player.git
cd kroma-player
# 2. Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate # Windows
# source .venv/bin/activate # macOS / Linux
# 3. Install dependencies
pip install -r requirements.txt
# 4. Run it
python run.pyTwo programs to install separately
Neither ships with Kroma Player. The app runs without them — the features in the last column are what you lose. Settings → Dependencies shows whether each was found.
| Program | Needed for |
|---|---|
| ffmpeg | All audio conversion. Without it: no downloading, no importing
files that aren't already Opus, no MP3 export, no generated
instrumentals. Includes ffprobe, also required. |
| deno | The JavaScript engine yt-dlp uses to get past YouTube's player challenges. Without it: no downloading from YouTube. |
Just installed one and it still shows as Not found? On Windows, sign out and back in. PATH changes only reach programs started afterwards, and Explorer keeps the old PATH until it restarts. It's the most common cause by a distance.
// history
Version history
Every version, newest first. Each one opens its full changelog.
// while you wait
See what's coming
The roadmap is public and specific — every feature, fix and open question, with the date it was added.