Suzumushi is a terminal music player for Linux. Browse your local library, build a queue, and return to your saved playback position. No account required.
/
Suzumushi Help
$ suzumushi --root ./suzumushi
Suzumushi saved your queue and position. Press Enter to open it again.
A browser replica of the real player. Click it and use your keyboard: Space resumes, / searches, q quits. Esc leaves the demo. Real screenshot ↗
Your library on the left, playback in the middle, and the queue on the right. Suzu dances in a night meadow that grows with the music.
Search by artist, title, or filename. Add a track or a whole playlist, then reorder the queue from your keyboard.
Your queue, current track, and playback position are saved. Reopen the player and press play when you're ready.
Play, pause, and skip from the terminal or your desktop's media controls. Both control the same player.
Audio and playlists live in your Suzumushi folders. No account, streaming service, or cloud library required.
After installation, create a Suzumushi folder and add your audio to its library. Suzumushi reads that library; it doesn't automatically scan your Music folder.
Read the setup instructions
suzumushi init ./suzumushiCopy audio files or folders into ./suzumushi/audio/library/
suzumushi --root ./suzumushiSelect a track in Library and press Enter to add it and start listening.
Install from the AUR on Arch Linux, use the flake on NixOS, or download the x86-64 GNU/Linux archive.
