vibe-fi
arch~vibe "lofi"

vibe-fi

A fast, lightweight terminal music player. Stream YouTube music with live visualizers and synced lyrics.

Quick InstallGitHub
vibe-fi
vibe-fi terminal showcase
Linux & macOS~60 MB RAMYouTube StreamingLocal MusicSynced Lyrics6 Color ThemesFree & Open Source

Quick Install

One command · Ready in seconds
curl -fsSL https://raw.githubusercontent.com/Swadesh-c0de/vibe-fi-go/main/install.sh | bash

Pre-built binary for Linux & macOS. Auto-resolves libmpv.

inspect install.shFull guide

Key Features

Simple · Fast · Terminal-native

Play any song from YouTube

Search for any track or paste a link. Music streams directly in high audio quality without opening a browser or draining your battery.

Live audio visualizer

Watch your music dance with a smooth real-time spectrum visualizer that pulses to the beat across 3 clean layout modes.

Live scrolling lyrics

Follow along as each line lights up in time with the song. Lyrics load automatically and are saved for offline listening.

Play your offline music library

Browse and play songs from your music folder. Supports MP3, FLAC, WAV, M4A, OGG, and all popular audio formats.

Media keys & status bars

Control playback with your keyboard's media keys and display the current song in status bars like Waybar, Polybar, or Discord.

Runs in ~60 MB of RAM

Starts instantly and uses virtually zero background memory. Leave it playing all day while you code or browse without slowdowns.

Commands & Shortcuts

Quick terminal controls
/
Search

Search YouTube

Search for any song, artist, or genre and start listening immediately.

vibe "synthwave radio"
Direct Link

Play a YouTube URL

Paste any YouTube video, music track, or livestream link to play its audio.

vibe "https://youtu.be/5qap5aO4i9A"
Resume

Resume last session

Pick up right where you left off — restores your last song, queue, and volume.

vibe -r
alt: vibe --restore⎘
Folder

Play music folder

Browse and play all tracks in your local music folder. Works with all major formats.

vibe ~/Music
Audio File

Play a single file

Listen to any local audio file directly in your terminal.

vibe ~/Music/song.flac
Media Keys

Play or pause from desktop

Use your keyboard's media keys or window manager shortcuts to play and pause.

playerctl -p vibefi play-pause
Status Bar

Show current song in status bar

Display the current track and artist in desktop bars like Waybar, Polybar, or scripts.

playerctl -p vibefi metadata --format '{{artist}} - {{title}}'
Tools Check

Check helper tools

Check the status of playback tools and helper programs installed with vibe-fi.

vibe -b
alt: vibe --bottle⎘
Fast Start

Launch without checking updates

Skip the automatic update check on startup for the fastest possible launch.

vibe --no-update
Version

Check version

Displays the installed version of vibe-fi.

vibe -v
alt: vibe --version⎘

Keyboard Shortcuts

Home-row navigation · Zero mouse required

Playback Controls

5 keys
Play / Pause
Start or pause playback
Space
Next / Previous Song
Skip tracks forward or back
NB
Rewind / Fast-Forward
Jump 5 seconds back or ahead
←→
Volume Up / Down
Adjust volume in 5% steps
+-
Toggle Autoplay
Keep playing related songs
O

Search & Navigation

5 keys
Search YouTube
Search for songs or artists
S
Play Direct Link
Paste a YouTube link from clipboard
U
View Song Queue
See upcoming tracks
C
Help & Shortcuts
Open shortcuts cheat sheet
?F1
Quit Vibe-Fi
Exit player and restore terminal
Q

Visualizers & Lyrics

4 keys
Switch View Layout
Split view ↔ Full visualizer ↔ Full lyrics
V
Change Color Theme
Cycle Midnight, Nord, Matrix, Gruvbox...
T
Scroll Lyrics
Browse lyrics up and down
↑↓
Auto-Scroll Lock
Turn automatic lyric scrolling back on
Y

Local Music & Playlists

4 keys
Browse Local Music
Play MP3, FLAC, WAV, and more
L
Playlists Manager
Open and organize saved playlists
P
Add to Playlist
Save playing song to a playlist
A
Back / Close Menu
Return to main player screen
ESC

Press any shortcut to test live • View full keyboard bindings in docs →

Free & Open Source

Vibe-Fi is free software built for everyone. Check out the code, suggest features, report bugs, or add custom themes on GitHub.

MIT LicensePRs WelcomeLinux & macOSGo & Bubble Tea
Star on GitHubOpen an Issue / PR ↗