ytkew plays music from your YouTube Music account without a browser.
mpv 0.30+ and yt-dlp on PATH, and a truecolor terminal — ytkew refuses
to start without the first two. Per-platform commands are on the
site. Search, radio and
lyrics work signed out; only your own library needs credentials.
Linux and macOS. On macOS the spectrum visualizer and media keys are unavailable since they need PipeWire and D-Bus, but everything else works the same. Windows is not supported yet.
Tip
An outdated yt-dlp is the most common reason a working ytkew stops playing.
Keep it current with yt-dlp -U.
cargo install ytkew
ytkew --install-desktop-entry # launcher entry and iconOr from source, which does both in one step:
git clone https://github.com/dtDhruv/ytkew && cd ytkew && make installThe documentation is on the site:
- Full-resolution cover art: kitty graphics, sixel, or truecolor half-blocks.
- Gapless playback. The next track is resolved and buffered while the current one plays, so transitions never stall.
- Spectrum visualizer, from a real FFT over the audio output.
- Colours taken from the album art, ten built-in themes, or write your own.
- A library that browses like a file manager, one column per level.
- Search across songs, videos, albums, artists and playlists.
- A queue that behaves like YouTube Music's: a one-off track played mid-playlist slots in next instead of throwing the playlist away.
- Optional vim keybindings.
- MPRIS: media keys, and a now-playing panel entry with artwork.
- Mouse support throughout.
- Lyrics, radio, liking tracks, shuffle and repeat.
Bug reports, patches, themes and terminal-compatibility notes are all welcome. See CONTRIBUTING.md.
ytkew is not affiliated with, endorsed by, or connected to YouTube or Google. It talks to an unofficial API that can change at any time.