GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GBSPLAY (1)

NAME

gbsplay - Gameboy sound player

CONTENTS

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.

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

/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://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.
Search for    or go to Top of page |  Section 1 |  Main Index


Tobias Diedrich GBSPLAY (1) 0.0.8

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.