A terminal music player for Linux

Keep your music close.

Browse your local library, build a queue, and return to your saved playback position. No account required.

Free and open source · v1.1.5 · GNU/Linux x86-64

Browse, queue, and play from your keyboard.

Your library on the left, playback in the middle, and the queue on the right. Suzu follows the music.

Suzumushi playing Mani - Bang Bang, with the folder library on the left, Suzu and the audio spectrum in the middle, and the queue on the rightOpen full-size screenshot ↗

The essentials for everyday listening.

Find a track, build a queue

Search by artist, title, or filename. Add a track or a whole playlist, then reorder the queue from your keyboard.

Pick up where you stopped

Your queue, current track, and playback position are saved. Reopen the player and press play when you're ready.

Use your media keys

Play, pause, and skip from the terminal or your desktop's media controls. Both control the same player.

Keep your library local

Audio and playlists live in your Suzumushi folders. No account, streaming service, or cloud library required.

Your first listen.

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 →
  1. Create your library

    suzumushi init ./suzumushi
  2. Add your audio

    Copy audio files or folders into ./suzumushi/audio/library/.

  3. Open the player

    suzumushi --root ./suzumushi

    Select a track in Library and press Enter to add it and start listening.

Ready to listen?

Install from the AUR on Arch Linux, use the flake on NixOS, or download the x86-64 GNU/Linux archive.

MP3 · FLAC · 16-bit PCM WAV · Ogg Vorbis