Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
A terminal YouTube Music player, in the spirit of kew.
ytkew 1 queue 2 library 3 track 4 search not signed in 1/20 vol ▪▪▪▫▫ 60%
──────────────────────────────┘ └───────────────────────────────────────────────────────────
╭| now playing |─────────────────────────╮ ╭| up next |──────────────────────────────────────────────╮
│ ▀▀▀▀▀▀▀▀▀▀▀▀ │ │ Radiohead Creep (Acoustic) 4:19↑│
│ ▀▀▀▀▀▀▀▀▀▀▀▀ │ │ Radiohead Karma Police 4:22█│
│ ▀▀▀▀▀▀▀▀▀▀▀▀ │ │ Radiohead Let Down 5:00█│
│ ▀▀▀▀▀▀▀▀▀▀▀▀ │ │ Radiohead No Surprises 3:49█│
│ ▀▀▀▀▀▀▀▀▀▀▀▀ │ │ Kelly Clarkson Creep (Live) 4:09█│
│ ▀▀▀▀▀▀▀▀▀▀▀▀ │ │ Radiohead Fake Plastic Trees 4:51█│
│ │ │ Radiohead Everything In Its Right Place 4:12█│
│ Creep │ │ Scala & Kolacny B… Creep 4:54█│
│ Radiohead │ │ Radiohead Jigsaw Falling Into Place 4:09║│
│ Creep │ │ Scott Bradlee's P… Creep (feat. Haley Reinhart) 4:44║│
│ │ │ Radiohead Exit Music (For A Film) 4:28║│
│ │ │ Radiohead Street Spirit (Fade Out) 4:14║│
│ ▄▅▅▇▇▁ │ │ Radiohead Airbag 4:48║│
│ ▆▆▆██████▇▇ │ │ Radiohead You And Whose Army? 3:11║│
│ ███████████▇▅ │ │ Radiohead All I Need 3:49║│
│ ██████████████▅▃▄▃▃▁▂▅▁▃▆▅▁▂▁▂▁▂▁▂▂▁▂▂ │ │ Radiohead No Surprises 3:50║│
│ 0:13 ━━●━━━━━━━━━━━━━━━━━━━━━━━━━ 3:58 │ │ Stone Temple Pilo… Creep 5:33↓│
╰────────────────────────────────| 1/20 |╯ ╰─────────────────────────────────────────────────────────╯
space play · h/l skip · a/d seek · +/- vol · s shuffle · r repeat · m lyrics · esc menu F6 help
ytkew plays music from your YouTube Music account without a browser. It takes its interface and keybindings from kew, and hands playback to mpv, so a slow redraw can never stutter the audio.
Install
Or from source, which does both in one step:
&& &&
Documentation
Everything — installing, signing in, every key, themes, configuration and troubleshooting — lives on the site:
https://dtdhruv.github.io/ytkew
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.
Requirements
mpv and yt-dlp on PATH, and a truecolor terminal. PipeWire is needed for
the visualizer only. Search, radio and lyrics work signed out; only your own
library needs credentials.
[!TIP] A stale
yt-dlpis the most common reason a working ytkew stops playing. Keep it current withyt-dlp -U.
Linux and macOS. Windows is not supported yet.
Contributing
Bug reports, patches, themes and terminal-compatibility notes are all welcome. See CONTRIBUTING.md.
Licence
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
kew for the interface and keybindings · btop for the banner and the red · ytmapi-rs for the protocol layer · ratatui, mpv and yt-dlp for the rest.