DOKK / manpages / debian 10 / gbsplay / gbsplay.1.en
gbsplay(1) Gameboy sound player gbsplay(1)

gbsplay - Gameboy sound player

gbsplay [options] gbs-file [start-subsong [stop-subsong] ]

gbsplay emulates the sound hardware of the Nintendo Gameboy. It is able to play the sounds from a Gameboy module dump (.GBS format) over /dev/dsp.

Set endian to endian. Valid values are b, l and n for big, little and native endian respectively.
Set fadeout time to subsong-gap seconds. Instead of cutting of the subsong hard, do a soft fadeout. Default value is 3 seconds.
Set subsong gap to subsong-gap seconds. Before playing the next subsong after the subsong timeout, play subsong-gap seconds of silence. Default value is 2 seconds.
Display short help and exit.
Enable loop mode. When the last subsong is played, playback starts again with the first subsong. Default is no loop.
Select sound output plugin plugin. Default depends on compilation options. Select list to view a list of all available output plugins.
Be quieter, reduce verbosity. Can be applied multiple times. Default verbosity is 3.
Set the samplerate to samplerate Hz. Default value is 44100Hz.
Set the refresh delay to refresh-delay milliseconds. Default value is 33 milliseconds. Larger values will lower CPU usage, but things as subsong changes, fadeouts, reactions to keypresses and the on-screen display will be delayed.
Set subsong timeout to subsong-timeout seconds. When a subsong has been played for the given time, the player will skip to the next subsong. A timeout of 0 seconds disables automatic subsong changes. Default value is 120 seconds.
Set silence timeout to silence-timeout seconds. When a subsong contains silence for the given time, the player will skip to the next subsong. Default value is 2 seconds.
Increase verbosity, print more information. Can be applied multiple times. Default verbosity is 3.
Display version number and exit.
Play subsongs in shuffle mode. Every subsong will be played once in random order.
Play subsongs in random mode. Like shuffle mode, but a subsong can be played multiple times.
Mute channel 1 on start.
Mute channel 2 on start.
Mute channel 3 on start.
Mute channel 4 on start.

The sound file to play. Must be in uncompressed .GBS format.
The subsong from the sound file to play. If not specified, the default song will be played (unless in shuffle or random mode). An out-of-bounds number will be clipped to the possible range of subsongs.
gbsplay stops when this subsong has been played. If not specified or out-of-bound, gbsplay will stop after playing the last subsong.

gbsplay supports basic keyboard control. The following commands are recognized:

Skip to the previous subsong.
Skip to the next subsong.
Quit gbsplay.
Toggle play/pause.
Mute/unmute channel 1.
Mute/unmute channel 2.
Mute/unmute channel 3.
Mute/unmute channel 4.

Default location of the global configuration file.
User configuration file.

gbsinfo(1), gbsplayrc(5)

If you encounter bugs, please report them via or write to <>.

gbsplay was written by Tobias Diedrich <> (with contributions from others, see README).

gbsplay is licensed under GNU GPL.

0.0.93 Tobias Diedrich