drift/README.md
2026-10-11 17:56:25 +02:00

2.6 KiB

Drift

Stars License

A music streaming client using Vim keybinds built in Rust.

Stream your favourite music from YouTube Music — all in one client, in your terminal.


Drift showcase

Features

  • YouTube Music streaming - search and play tracks straight from YouTube Music, with no account or login
  • Vim-style keybinds - move with j/k, jump with gg/ge, use counts like 5j, and open the command line with :
  • Song context menu - press G on any song for quick actions: play, queue, add to playlist, show artist, and song info
  • Command palette - a redesigned : prompt with the full command set (:search, :seek, :vol, :import, and more)
  • Audio visualizer - a live visualizer in the bottom-left corner while music plays
  • Playlists & queue - save, load, and reorder playlists, or import any YouTube / YouTube Music playlist by URL
  • Artist browsing - press ga to jump to an artist's songs
  • Session restore - your queue and playback position come back the next time you launch

Installation

Arch Linux (AUR)

yay -S driftmusic-git

Any AUR helper works (paru -S driftmusic-git), or build it by hand:

git clone https://aur.archlinux.org/driftmusic-git.git
cd driftmusic-git
makepkg -si

mpv and yt-dlp are installed automatically.

Other distros

Install the dependencies:

  • mpv — audio playback
  • yt-dlp — YouTube stream extraction
  • Rust (build only)

Then build from source:

git clone https://github.com/socatlolmeow/drift.git
cd drift
cargo build --release
sudo cp target/release/drift /usr/local/bin/

Or install directly with cargo:

cargo install --path .

This installs drift to ~/.cargo/bin/, which is on your $PATH if you installed Rust via rustup.

Star History

Star History Chart


License

Drift is FOSS, released under the GNU General Public License version 3 or later.