Kagi

A lightweight, fast, and zero-bullshit music player built in Rust. No web garbage, no Electron bloat—just pure, native SPEEEEEDDDD.

Features ⚡

• 🦀 Written in Rust
• 🧠 Low Memory & CPU Usage – <75MB RAM, <2% CPU.
• 🚀 Blazing Fast – 200+ tracks load in under 3 sec thanks to bincode (tested on a 5+yo HDD).
• 📂 Local Folder Playback
• 🎨 Themeing with Hot-Reload
• 🔄 Saves Playback State – Pickup right where you left off.
• 🔍 Fuzzy Search – Powered by Nucleo (sometimes derps, working on it).

Coming Soon™

• 🎧 Crossfade between tracks
• 📥 Download playlists from YouTube
• 📝 Lyrics support
• 📜 Custom playlists without needing folders
• ⚡ More optimizations, less jank

Getting Started 🛠️

1. Install Rust

If you don’t already have Rust installed:

curl https://sh.rustup.rs -sSf | sh

Or use your package manager if you’re fancy:

sudo pacman -S rust # Arch
sudo apt install rustc cargo # Debian

2. Clone & Build

git clone https://github.com/anantnrg/kagi
cd kagi
cargo build --release

3. Run It

./target/release/kagi

License

Kagi is licensed under the GNU GPL v3 License. See LICENSE for details.

Contributing

Refer to CONTRIBUTING.md