Skip to content
dtDhruvPublic

About

A terminal YouTube Music player inspired by kew.

Topics

Resources

Contributing

Stars

114 stars

Watchers

1 watching

Forks

Repository files navigation

ytkew

YouTube Music on the terminal!

ci security licence

ytkew playing a queue: cover art, spectrum visualizer and the up-next list

ytkew plays music from your YouTube Music account without a browser.

Requirements

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.

Install

cargo install ytkew
ytkew --install-desktop-entry     # launcher entry and icon

Or from source, which does both in one step:

git clone https://github.com/dtDhruv/ytkew && cd ytkew && make install

Documentation

The documentation is on the site:

Features

  • 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.

Contributing

Bug reports, patches, themes and terminal-compatibility notes are all welcome. See CONTRIBUTING.md.

Licence

GPL-3.0-or-later.

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.

Credits

About

A terminal YouTube Music player inspired by kew.

Topics

Resources

Contributing

Stars

114 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages