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.