xmp


NAME

xmp - extended module player


SYNOPSIS

xmp [-8ADhiLlmnorVvx] [ -d device] [ -M ch] [ -p pan] [ -S ch] [ -s pos] modules


DESCRIPTION

xmp is a module player originally designed to play Fasttracker II extended modules. The current version recognizes Fasttracker II modules (XM), 1 to 32 channel Protracker modules (MOD) and variants (including Mod's Grave WOW modules), Scream Tracker 3 modules (S3M), Scream Tracker 2 modules (STM), Composer 669 and UNIS669 modules (669), Poly Tracker modules (PTM), Oktalyzer modules (OKT) and Multitracker modules (MTM). Currently supported output devices are the Gravis Ultrasound (or SoftOSS) and the Sound Blaster AWE-32. Software mixer support is NOT implemented in this version.


OPTIONS

-8
Convert 16-bit samples to 8-bit (to save memory in the sound device).

-A
Use Amiga (exponential) period mode. This is the default mode.

-D
Dump the pattern data to stdout (for debugging).

-d device
Uses the specified device for output overriding autodetection. Use this option if you have more than one output device in your system (e.g. force softmix in a GUS). If -d is not used, xmp will use the first available device for output. Devices are probed in the order shown in the device list.

-h
Show a short summary of command-line options.

-i
Ignore 0xff (end of module marker) when playing S3M files. Not very useful unless you're playing music from the Unreal demo.

-L
Use linear period mode, according to the XM specs (period = 7680 - note<<6 - finetune>>1).

-l
Enable module looping.

-M ch
Mute the specified channel.

-m
Force mono output.

-n
Force NTSC (60 Hz) timing for MOD files. Default is PAL (50 Hz).

-p num
Set the percentual panning amplitude. The default value is 75%.

-r
Reverse left/right stereo output channels.

-S ch
Play only the specified channel (solo).

-s pos
Start playing the module from the position pos.

-V
Print version information.

-v
Verbose mode (incremental).


SIGNALS

If xmp receives SIGABRT, it will abort the currently playing module and start the next module specified in the command line. If SIGUSR1 is received, xmp will reload the currently playing module.


CAVEATS

See the file README.formats in the distribution package for a complete list of restrictions for each supported module format.


BUGS

See the file README.bugs in the distribution package for a detailedlist of bugs in the current release.


AUTHOR

xmp was written by C Matsuoka <claudio@cpgei.cefetpr.br> and H Carraro Jr (no current email address). AWE/awedrv support added by Takashi Iwai <iwai@dragon.mm.t.u-tokyo.ac.jp>.


DISCLAIMER

This is a free product with no warranty of any kind. Use it at your own risk.