benben 命令

常用示例

说明

benben is a fast and efficient command-line audio player and audio converter for Linux and other Unix-like systems with an oldschool-inspired terminal interface. It is written almost entirely in Common Lisp and is designed for users who organize their music in folders and prefer terminal-based tools over graphical interfaces. benben supports a wide range of audio formats including MP3, Ogg Vorbis, Opus, FLAC, WavPack, WAV, QOA, Sun Au, General MIDI, MUS, Commodore 64 SID, Doom WAD files, and all module/tracker formats supported by libxmp. It has extensive VGM (Video Game Music) format support with chip emulation for over 30 sound chips including YM2612, YM2151, YM2610, NES APU, HuC6280, QSound, and Sega MultiPCM, powered by the SatouSynth library. The player provides multiple audio output backends (ALSA, libout123, libao) and supports TCP audio streaming. Built-in audio effects include soft clipping with configurable oversampling, a parametric equalizer with arbitrary band count, stereo enhancement, reverb (mverb and zita types with presets), and a DC offset filter. It supports ReplayGain/RVA for volume normalization. The rendering mode can convert audio files to WAV or Au format in parallel using multiple CPU cores, with options for normalization, configurable bit depth, and floating-point output. XSPF and JSPF playlists are supported, along with ListenBrainz scrobbling and Matrix protocol integration for now-playing updates. The multi-threaded UI is built on S-Lang and features customizable themes, banner animations, a VU meter, and full keyboard controls. A minimal headless UI is also available for resource-constrained systems or remote control via the companion remote-benben tool over UNIX domain sockets. SID files support song selection syntax using the @ notation (e.g., file.sid@1-3). benben is command-line only with no file browser by design; users specify files, directories, or playlists as arguments.

参数

-h, --help

Display help information and exit

-v, --version

Show brief version details and exit

--long-version

Display verbose version information and exit

--scan-only

Scan files only, then terminate

--recurse

Search subdirectories recursively

--no-recurse

Disable recursive subdirectory searching

--dump-config

Generate a fresh configuration and output to stdout

--basedir _path_

Load configuration and themes from an alternate directory

--remote

Enable UNIX domain socket for remote control

--remote-socket _path_

Specify alternate socket location for remote control

--list-themes

Display all available themes

-T _name_, --theme _name_

Use the specified theme

--ui _type_

Select user interface: original or minimal

-L, --no-listenbrainz

Disable ListenBrainz submission

-d _driver_, --driver _driver_

Select audio driver (alsa, out123, ao, any)

--alsa-device _name_

Use a specific ALSA device (default: default)

--volume _x_

Set output volume from 0.0 to 3.0 (default: 1.0)

-S _hz_, --sample-rate _hz_

Set output sample rate in Hz from 8000 to 48000 (default: 44100)

--replay-gain _mode_

Set ReplayGain mode: disabled, mix, or album

--resampler _mode_

Set resampler mode

-e, --no-eq

Start with equalizer disabled

-c, --soft-clipping

Start with soft clipping enabled

-C, --no-soft-clipping

Start with soft clipping disabled

--soft-clipping-oversampling _n_

Oversampling amount when soft clipping is enabled (default: 1)