Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gbsplay(1)		     Gameboy sound player		    gbsplay(1)

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, lit-
	      tle 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 sec-
	      onds.

       -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.

       -H filter
	      Set output high-pass type	 to  filter.   Valid  values  are  dmg
	      (Gameboy Classic), cgb (Gameboy Color) and off (no filter).  De-
	      fault value is dmg.

       -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 compila-
	      tion options.  Select list to view a list	of all available  out-
	      put 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 mul-
	      tiple 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	speci-
	      fied  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
       /usr/local/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://gb-
       splay.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.

Tobias Diedrich			    unknown			    gbsplay(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | PARAMETERS | KEYBOARD CONTROL | FILES | SEE ALSO | BUG REPORTS | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gbsplay&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help