Plays on its own
Spotify plays through librespot, and cloofy is a Spotify Connect device. It controls your other devices too, and follows them live. YouTube Music plays through mpv, with no gap between songs.
What's new in 0.5: YouTube Music
Spotify and YouTube Music in your terminal.
Plays on its own, with Home, Spotify's DJ, synced lyrics, real cover art and a mouse that works everywhere.
curl -fsSL https://cloofy.app/install.sh | bashFor macOS and Linux, also with Homebrew, mise and on Arch Linux. MIT licensed.
Recorded from cloofy demo, which needs no account and plays nothing, so you can try it in your own terminal first.
Features
It looks and works like the desktop client you know: your Home feed, your library in a sidebar, cover art, synced lyrics, and on Spotify the DJ talking between tracks.
Spotify, YouTube Music or both
Install one, or both side by side: S or the switch in the top bar shows the other's Home, library and pages, as you left them.
YouTube Music without an account
Home, search, every page, lyrics and song radios work signed out. Sign in with your browser for your library and likes.
Home and the DJ
Your shelves and mixes, and on Spotify Made For You and the DJ with its voice between tracks. Ask the DJ for something, as in Spotify's apps.
The queue
See what plays next: the songs you queued, then the rest of the playlist or album. Skip ahead to any of them, or take a queued song out again.
Cover art
Real images in terminals that show pictures through the Kitty, Sixel or iTerm2 protocol, and block art everywhere else.
Mouse and keyboard
Click, hover, scroll, drag the seek and volume bars, right-click for actions. Every action also has a key, and Ctrl K finds the rest.
Instant
The last page, list and track are back the moment it starts, and the controls answer before Spotify does.
At home on macOS and Linux
Media keys and the system's media controls. cloofy pauses before the computer sleeps, reconnects when it wakes, and moves less when the system asks for less motion.
Now playing, with lyrics in time
z opens the track in full: a large cover, and lyrics that follow the song line by line.
Every page you know
Playlists and albums with the playing song marked, artist pages with popular tracks and play counts, search with covers, and your whole library as a grid.
A key for everything, or a click
Ctrl K opens a command palette for every action and playlist, ? lists all keys, and the hint bar at the bottom shows what works on the current page. All of it works with the mouse too.
All shortcuts →
Spotify and YouTube Music
Install one, or both. Each comes as a build of its own, so a YouTube Music install carries no Spotify code, and the other way around.
Spotify
- Plays through librespot, as a Spotify Connect device you can pick from your phone
- Controls your other devices too, and follows them live
- The DJ with its voice between tracks, and you can ask it for something
- Made For You, podcasts and crossfade
- Needs Spotify Premium, and a free developer app of your own that the installer sets up with you
YouTube Music
- Plays through mpv, with the streams from yt-dlp, and no gap between songs
- Home, search, every page, lyrics and song radios work without an account
- Signed in with your browser, your playlists, albums, artists and liked songs
- With several Google accounts in the browser, you pick one by its address
- When a playlist or album ends, the radio of its last song follows
At home on Omarchy
On Omarchy, cloofy takes its colors from the theme and follows it when you switch, without a restart. cloofy omarchy install adds the rest:
- A widget in the bar next to the clock, with the song, a small equalizer and a card with the controls
- Music in the Omarchy menu, and cloofy with its icon in the launcher
- Super+Shift+M opens cloofy instead of Spotify, if you say yes
- Song notifications from the desktop, with the cover
$ cloofy omarchy status
cloofy for Omarchy
✓ Bar widget cloofy.nowplaying, in the bar
✓ Theme follows everforest
✓ Menu Music in the Omarchy menu
✓ Launcher cloofy in the app launcher
✓ Super+Shift+M opens cloofyInstall
The installer first asks what you listen to: Spotify, YouTube Music, or both. Then it checks your system, puts the latest release in ~/.local/bin, and walks you through the setup.
curl -fsSL https://cloofy.app/install.sh | bashPackage managers have the same three builds:
brew install parda21/cloofy/cloofy-ytmusicThe install guide has the installer's options, building from source and uninstalling.
FAQ
Does Spotify work with a free account?
No. Outside its own apps, Spotify streams only to Premium accounts.
Do I need YouTube Premium?
No. YouTube Music plays without any account, and signing in only adds your library and likes.
Why do I need my own Spotify app?
Spotify gives its Web API, which cloofy reads your library and searches through, only to registered apps. Apps in development mode are limited to a handful of users, so one shared app couldn't serve everyone. Yours is free and only yours, and the installer sets it up with you.
Is signing in to YouTube Music with my browser's cookies safe?
cloofy keeps only youtube.com's cookies, in a file only you can read or in the macOS Keychain, and sends them only to music.youtube.com. Streams, covers and lyrics load without them. cloofy logout ytmusic deletes them.
What does cloofy send where?
Requests to Spotify and YouTube Music, for the services you use, and to LRCLIB for lyrics they don't have. cloofy also asks GitHub for new releases. Nothing else: no telemetry, no server of its own.