GMOD(1)

NAME
gmod - play music modules

SYNOPSIS
gmod [-bcehlMnqrRsxz] [-m mixer] [-P pan-factor] [-v volume] [module...]

DESCRIPTION
This manual page documents gmod, a music module file player for Linux, with support for the Gravis Ultrasound card and AWE cards. Gmod is capable of playing 669, MOD, Multitracker (MTM), Scream Tracker III (S3M), Ultratracker (ULT), and FastTracker (XM) files.

Modules compressed with compress, gzip, lharc, or zip can be played by gmod, if gunzip, lharc, and/or zip are installed.

The modules will be played in the order specified on the command line. The following keys can be used while the module is playing, unless the -z option was specified (special keys -- arrows, etc -- only work if gmod was compiled with ncurses support):

b, left arrow
    Move backwards <numeric argument> positions.

f, right arrow
    Move forward <numeric argument> positions.

n, next page
    Next module.

p, previous page
    Previous module.

q   Quit.

+   Increase sequencer volume by <numeric argument>.

-   Decrease sequencer volume by <numeric argument>.

up arrow
    Scroll sample list up.

down arrow
    Scroll sample list down.

0..9
    Set numeric argument. For example, keying 1 0 will set the numeric argument to 10. The argument will remain in effect until a command which uses the argument is executed and a new argument is entered. For example, 10ff will advance 20 positions, and 10f5f will advance 15 positions.

In addition, gmod understands the following signals:

SIGTERM
    Quit.

SIGUSR1
    Previous module.

SIGUSR2
    Next module.

OPTIONS

-b  (MOD only) Disable BPM tempos. Specifying this option will cause gmod to treat all speed commands as changes to the number of ticks per note.

-c  Disable compression of modules in memory. Normally, modules are compressed in memory in order to use less space. Specifying this option will save some CPU time.

-e  Show empty samples. Use this option to display information about all samples in a module, even if some are empty. (Not supported for S3M modules). This option only works if gmod was compiled without ncurses support.

-h  Display help.

-l  Break infinite pattern loops in modules.

-m mixer
    Use mixer number mixer. Gmod will attempt to use /dev/mixer if this option is not specified. Specifying this option will cause gmod to use /dev/mixern, where n is the specified mixer. Valid values are 0 to 15.

-M  (MOD only) Check magic number. Do not play modules which do not have a magic number. Old 15 channel modules do not have magic numbers.

-n  (MOD only) Use NTSC sample timing. This option should be used with modules composed on NTSC (non-European) machines.

-P pan-factor
    Set the panning factor. Valid values are -100 to 100. Higher absolute values produce more panning. Negative values cause the left/right channels to be swapped. The default value is 100.

-q  Quiet mode. No text output will be produced.

-r  Infinitely repeat the current module.

-R  Randomize the play order of the modules.

-s  (MOD only) Ignore "speed 0" commands. Ordinarily, "speed 0" commands cause playing to stop. Use this option if a module seems to suddenly stop in the middle.

-v volume
    Set the volume to volume. Valid values are 0 to 255. The default value is 255.

-x  (MOD only) Extend octaves. Normally, the range of notes in modules is limited to what is specified by the standard. This option removes that restriction.

-z  Background mode. This option does not put gmod in the background; rather, it allows gmod to run in the background. The keys that can be normally used while a module is playing no longer work, and the display of the current position and pattern is disabled.

-5  (MOD only) Use 50 Hz clock frequency. Specifying this option will cause speed changes to be calculated using a 50 Hz frequency base. The default value is 60 Hz.

THE GMODRC FILE
The gmodrc file is used to determine settings to be used for particular modules. GMOD will first look for a file named .gmodrc in the user's home directory, and if it is not found, it will look for /usr/etc/gmodrc. The gmodrc settings are combined with the options given on the command line. The format of the file is:

filename(without path) option ...

For example, if mymodule.mod uses NTSC sample timing and speed 0 commands should be ignored, the following line could be entered in the gmodrc file:

mymodule.mod ntsc nospeed0

Spacing is not important, but case is significant. The module name must start at the leftmost position of the line. The length of the line is limited to 160 characters.

Valid options are (corresponding command-line options are in parenthesis): nobpm (-b), ntsc (-n), nospeed0 (-s), extend (-x), and 50hz (-5)

NOTES
This applies only if gmod is compiled without linear volume support: Setting the sequencer volume to anything greater than approximately 60 when gmod's volume (-v) is set to 255 will cause volume clipping. Lower gmod volumes will allow higher sequencer volumes before clipping occurs.

MOD files use various timing methods. Different methods and the corresponding options are listed below:

NTSC (60 Hz) CIA: -n

PAL (50 Hz) CIA: no options (default)

NTSC (60 Hz) Vblank: -bn

PAL (50 Hz) Vblank: -b5

DIAGNOSTICS
The exit codes are:

0   Normal termination.

50  Bad arguments.

51  An error occurred while attempting to access the sequencer.

52  An error occurred while attempting to load a module

53  No GUS card was found.

AUTHORS
Original source by Hannu Savolainen.

MultiTracker/Ultratracker loading by Robert Sanders.

Many other modifications have been performed by Andrew J. Robinson <arobinso@nyx.net>. Andrew is currently the maintainer of gmod. Please direct any comments, questions, bug reports, etc. to him. There is current a gmod WWW page available through http://www.nyx.net/~arobinso.

gmod is Copyright (C) 1996 by Andrew J. Robinson.