SONIC is a vibes-based CLI music player to join alongside your other terminal tabs
Supports YouTube, Mixcloud, and Soundcloud as of now.
One-liner (macOS / Linux — installs prereqs automatically):
curl -fsSL https://raw.githubusercontent.com/sethmills21/sonic/main/install.sh | bashnpm
npm install -g sonic-cli
sonic "lofi"Hackable
brew install yt-dlp mpv # macOS prereqs
git clone https://github.com/sethmills21/sonic.git
cd sonic && npm install
npm startVerify setup
sonic doctorsonic # open the picker
sonic "deep house" # search and play
sonic --soundcloud "liquid dnb" # search SoundCloud
sonic --mixcloud "techno mix" # search Mixcloud
sonic doctor # check setup
sonic --help # full help| Key | Picker | Playback |
|---|---|---|
Enter |
Play selected | — |
Space |
— | Pause / resume |
/ |
Search | Search (stops playback) |
j k / arrows |
Move through lists | — |
Tab / Left Right |
Switch tabs | — |
n / p |
— | Next / previous track |
f |
Open favorites | Favorite track |
r |
Open recents | — |
[ ] |
— | Seek -/+ 10s |
- + |
— | Volume down / up |
m |
Cycle source | — |
v |
— | Cycle visualizer |
t / T |
Next / prev theme | Next / prev theme |
d |
Toggle dark/light | Toggle dark/light |
o |
— | Open in browser |
b |
— | Back to picker |
q |
Quit | Quit |
macOS media keys work via Control Center.
Six built-in themes with dark and light variants: Neon Night, Sunset Cassette, Ice Glass, Ember Void, Midnight Tokyo, Terminal Green. Press t to cycle, d to toggle mode.
Five modes: Bars, Tape, Wave, Rain, Flame. Press v during playback.
YouTube, SoundCloud, and Mixcloud. All use mpv for playback and require no auth. Press m to cycle.
Node.js 20+ · yt-dlp · mpv · macOS or Linux
See CONTRIBUTING.md and SECURITY.md.
MIT
Cooked up by Seth Miller and Claude Code
Not claiming this is some groundbreaking piece of tech — just solving my own problem and had a lot of fun building it. Open to ideas, feel free to fork.