NAME¶
gbsplay - Gameboy sound player
SYNOPSIS¶
gbsplay [
options]
gbs-file [
start-subsong
[
stop-subsong] ]
DESCRIPTION¶
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.
OPTIONS¶
- -E endian
- Set endian to endian. Valid values are b,
l and n for big, little and native endian respectively.
- -f fadeout-time
- Set fadeout time to subsong-gap seconds. Instead of
cutting of the subsong hard, do a soft fadeout. Default value is 3
seconds.
- -g subsong-gap
- 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.
- -h
- Display short help and exit.
- -l
- Enable loop mode. When the last subsong is played, playback
starts again with the first subsong. Default is no loop.
- -o plugin
- Select sound output plugin plugin. Default depends
on compilation options. Select list to view a list of all available
output plugins.
- -q
- Be quieter, reduce verbosity. Can be applied multiple
times. Default verbosity is 3.
- -r samplerate
- Set the samplerate to samplerate Hz. Default value
is 44100Hz.
- -R refresh-delay
- 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.
- -t subsong-timeout
- 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.
- -T silence-timeout
- 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.
- -v
- Increase verbosity, print more information. Can be applied
multiple times. Default verbosity is 3.
- -V
- Display version number and exit.
- -z
- Play subsongs in shuffle mode. Every subsong will be played
once in random order.
- -Z
- Play subsongs in random mode. Like shuffle mode, but a
subsong can be played multiple times.
- -1
- Mute channel 1 on start.
- -2
- Mute channel 2 on start.
- -3
- Mute channel 3 on start.
- -4
- Mute channel 4 on start.
PARAMETERS¶
- gbs-file
- The sound file to play. Must be in uncompressed .GBS
format.
- start-subsong
- 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.
- stop-subsong
- gbsplay stops when this subsong has been played. If not
specified or out-of-bound, gbsplay will stop after playing the last
subsong.
KEYBOARD CONTROL¶
gbsplay supports basic keyboard control. The following commands are
recognized:
- p
- Skip to the previous subsong.
- n
- Skip to the next subsong.
- q or Esc
- Quit gbsplay.
- Space
- Toggle play/pause.
- 1
- Mute/unmute channel 1.
- 2
- Mute/unmute channel 2.
- 3
- Mute/unmute channel 3.
- 4
- Mute/unmute channel 4.
FILES¶
- /etc/gbsplayrc
- Default location of the global configuration file.
- ~/.gbsplayrc
- User configuration file.
SEE ALSO¶
gbsinfo(1),
gbsplayrc(5)
BUG REPORTS¶
If you encounter bugs, please report them via
http://gbsplay.berlios.de/
or write to <
gbsplay-dev@lists.berlios.de>.
AUTHOR¶
gbsplay was written by Tobias Diedrich <
ranma+gbsplay@tdiedrich.de> (with contributions from others, see
README).
COPYRIGHT¶
gbsplay is licensed under GNU GPL.