Suzumushilocal terminal audio

Install

A short path
to the first song.

Suzumushi supports 64-bit GNU/Linux. Each archive is checksummed before publication. The AUR package uses that same release.

Arch Linux

Install from AUR

recommended

The package provides the canonical suzumushi command and the relative suzu symlink.

Command

yay -S suzumushi-bin
Open the AUR package ↗

GNU/Linux x86-64

Install the archive

Download the archive and checksum. Install only after verification reports OK.

Download

curl -fLO \ 'https://github.com/nuggocto/suzumushi/releases/download/v1.0.0/{SHA256SUMS,suzumushi-v1.0.0-x86_64-unknown-linux-gnu.tar.xz}'

Verify, then install

Check the archive before it enters the path.

The expected archive SHA-256 for v1.0.0 is:

abdea92340a22e6d526d4b0da131c9cb50054d7c12e64af355f294ac8de51581

Command

sha256sum --check --ignore-missing SHA256SUMS tar -xf suzumushi-v1.0.0-x86_64-unknown-linux-gnu.tar.xz cd suzumushi-v1.0.0-x86_64-unknown-linux-gnu sudo install -Dm755 suzumushi /usr/local/bin/suzumushi sudo ln -s suzumushi /usr/local/bin/suzu

First run

Give the library a home

Initialize a root, add audio below audio/library/, then open the player. Root discovery stays explicit: --root, then SUZUMUSHI_ROOT, then an existing local ./suzumushi/audio.

Command

suzumushi init ./suzumushi # Add audio below ./suzumushi/audio/library/ suzumushi --root ./suzumushi

Build from source

You need Rust 1.95 or newer and the ALSA development package for your distribution.

  • Arch Linux: alsa-lib
  • Debian or Ubuntu: libasound2-dev
  • Fedora: alsa-lib-devel

Command

git clone https://github.com/nuggocto/suzumushi.git cd suzumushi cargo install --path . --locked

Audio support

The verified formats are MP3 with MPEG Layer III, FLAC, signed 16-bit PCM WAV, and Ogg with Vorbis. Mono and stereo audio from 8 kHz through 192 kHz is supported when the default device accepts the source rate.

AAC, M4A, Opus, multichannel audio, and automatic resampling are not current support claims.