ᓚᘏᗢ
catunes

music in your terminal

A retro terminal music player with a real audio-reactive visualizer.

YouTube · radios · local files — no downloads. Free & open source.

ᓚᘏᗢ catunes♫ 12 · 22:30
♫ Tame Impala - The Less I Know The Better 🔀 🔁 ▶ PLAY
🎙 Tame Impala
▰▰▰▰▰▰▰▰▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱ 35% 1:48 / 5:03
🔊 ▰▰▰▰▰▰▰▰▱▱▱▱ 70%
♪ ♫
  ▄▀▄     ▄▀▄
 █  ▀▄▄▄▀  █
 █ ●     ● █
─█    ▄    █─
─█  ▀▀▀▀▀  █─
  ▀▄▄▄▄▄▄▄▀
▄▄█  █ █  █▄▄
  ▀▄▄▀ ▀▄▄▀
Listas
▶ Default
  ★ Favorites
  Radios
  Lo-fi
PLAYLIST · 12
  ★ Daft Punk - Around the World
▶ ★ Tame Impala - The Less I Know The Better
› Gorillaz - Feel Good Inc.
  ᓚᘏᗢ SomaFM — Groove Salad
  Bonobo - Kerala
↑↓ · ↵ play · space · n/p · v viz · e eq · / search · R radios · f filter · q quit
$ npm install -g catunescopy
Get it on npm ⭐ GitHub

features

🎧 Any source

YouTube, internet radios and local files. Pure streaming, no downloads.

📻 Radio directory

Search thousands of free stations by country, genre or name.

🎚️ 10-band EQ

A real graphic equalizer with presets, applied live.

📊 Live visualizer

Real FFT bars with smoothing and falling peaks — several modes.

🎨 Themes

Catppuccin, Dracula, Gruvbox, Nord, Tokyo Night & more.

🐱 Animated cat

A little cat that dances, sings and reacts to your music.

🌍 Multi-language

English & Spanish, clean keyboard-driven TUI.

🖥️ Cross-platform

macOS, Linux and Windows. One command.

controls

↑ ↓navigate
↵play
spacepause
← →seek
npnext / prev
/search YouTube
Rradios
eequalizer
ffilter
*favorite
vvisualizer
aadd
osettings
?help
qquit

command line

$ catunes # open the player
$ catunes play "<url>" # play a YouTube/radio/file
$ catunes add "<url>" # add to your playlist
$ catunes pause | next | vol +5 # control from any tab
$ catunes off # stop all playback
$ catunes doctor # check dependencies

install

$ npm install -g catunes
$ catunes

Requires mpv (audio engine). yt-dlp and ffmpeg are auto-downloaded on first use. Run catunes doctor to check your setup.