AI notice: This app has been created with an LLM called Claude Code. If you're against the usage of LLMs or AI in any capacity, this app won't be for you. I hope you understand.

• Synced lyrics with word- and syllable-level timing, plus Unison community lyrics.
• Lyrics Composer for creating and editing your own.
• Crossfade and a built-in visualizer.
• Remote control from your phone.
• OBS overlay for streaming.
• Offline downloads, Discord Rich Presence, and Last.fm scrobbling.

I highly recommend to send a bug report in the new Discord-Server, because that's easier for me to access, track, sort and handle in contrast to GitHub's unstable platform. Starting August, I will stop actively checking issues on GitHub.

Grab the latest build from the Releases page:

Windows: download and run the *_x64-setup.exe installer from the latest release.

macOS (Apple Silicon): the build is unsigned, so install it with this command (it downloads the latest release and avoids Gatekeeper's quarantine):

curl -fsSL https://raw.githubusercontent.com/KiyoshiTheDevil/Kodama/master/install.sh | bash

Automatic Updates on macOS are currently not functional. Hopefully I can fix it in the near future.

No screenshot available... yet.

A Google account is not required to use the player, Premium isn't required either. Please be aware, that some content might be inaccessable due to Premium restrictions.

Hey! I made a dedicated Discord server for the App, where you can chat about the project and send in bugs and suggestions more directly

https://discord.gg/PzSsPF7KW

• Node.js v18+
• Rust (stable)
• Python 3.10+

# 1. Clone
git clone https://github.com/KiyoshiTheDevil/Kodama.git
cd Kodama

# 2. Frontend dependencies
npm install

# 3. Python backend dependencies
cd python-backend
pip install -r requirements.txt
cd ..

# 4. (Optional) Authenticate with your YouTube account
cd python-backend
python setup_auth.py
cd ..

npm run tauri dev

npm run tauri build

See CHANGELOG.md for a full version history.

Kodama is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). You are free to use, study, modify and redistribute it, provided derivative works remain under the same license and their source is made available.

The bundled lyrics Composer is a vendored component licensed under the AGPL-3.0 as well.

Kodama is an unofficial client and is not affiliated with or endorsed by YouTube or Google. It relies on the unofficial YouTube Music API and is provided for personal use, as-is and without warranty. Use at your own risk.