Man Linux: Main Page and Category List

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.