


                         ___  ___ ____________  
                         \  \/  //      ____  \ 
                          >    <|  Y Y  \ |_>  >
                         /__/\   __|_|  /  ___/ 
                              \_/     \/|_|    
                E x t e n d e d   M o d u l e   P l a y e r

			     Version 2.2.0


OVERVIEW

This is the Extended Module Player, a module player for Unix-like systems
that runs on Linux with ALSA and OSS, Free/Open/NetBSD, AIX, OS/2, HP-UX,
MacOS X, SunOS, QNX and Solaris. Xmp plays over 70 mainstream and obscure
module formats from Amiga, Atari, Acorn, Apple IIgs and PC.

Many compressed module formats are supported, including popular Unix, DOS
and Amiga file packers such as gzip, bzip2, SQSH, Powerpack, etc. Certain
module-specific compressed formats such as MO3 are handled transparently.


SUPPORTED FORMATS

xmp 2.2 tries to  accurately  emulate Protracker, Fast Tracker II, Scream
Tracker 3 and Impulse Tracker event handling algorithms to play M.K., XM,
S3M and IT modules. By default, Sound/Noise/Protracker modules are played
in  Protracker 3.15 style  and  multichannel mutations in Fast Tracker II
style -- see doc/README.trackers for details. Multifile formats must have
all files in the same directory (ALM, Protracker songs, Startrekker AM).

The current version recognizes the following module formats:

  Type  Rating	Tracker/packer		Recognized variants

  Protracker and variants:

  CHN	****+	Fast/Taketracker	xCHN, xxCH
  EXO	*** 	Startrekker/ADSC	FLT4/8, EXO4/8 (AM unsupported)
  M15	****	Soundtracker		2.2, UST
  MOD	****+	Sound/Noise/Protracker	M.K., M!K!, M&K!, N.T., CD81
  WOW	****+	Mod's Grave		M.K.

  Amiga packed formats:

  AC1D  ****+	AC1D Packer		-
  CRB	****+	Heatseeker		mc1.0
  DI	****+	Digital Illusions	-
  FC-M	****+	FC-M Packer		1.0
  IMS	***	Images Music System	?
  KSM	****+	Kefrens Sound Machine	-
  MP	****+	Module Protector	-
  NP	****+	NoisePacker		1.0, 2.0, 3.0
  TP    ****	The Player		6.0a
  PM	***	Power Music		-
  PP10	****+	Pha Packer		-
  PROM	***	Promizer		0.1, 1.0c, 1.8a, 2.0, 4.0
  PRU	****+	ProRunner		1.0, 2.0
  STIM	****+	Slamtilt		-
  UNIC	***	Unic Tracker		1.0, 2.0
  WN	****+	Wanton Packer		-
  XANN	****+	XANN Packer		-
  ZEN	****+	Zen Packer		-

  Other Amiga formats:

  DIGI	***	DIGI Booster		1.4, 1.5, 1.6, 1.7
  EMOD  ****	Quadra Composer		0001
  KRIS	****+	ChipTracker		KRIS
  MODL	****+	Protracker 3.59		PTDT
  MED	**	MED 2.10/3.00	 	MED3, MED4
  MED	**	MED 3.00/OctaMED	MMD0, MMD1, MMD2, MMD3
  MTN	****	ST 2.6, Ice Tracker	MTN, IT10
  OKTA	***	Oktalyzer		-
  SFX	***	SoundFX			1.3, 2.0?

  Atari formats:

  CDx1	****+	Octalyser		CD61, CD81
  DTM	***	Digital Tracker		1.9
  FA0x	****+	Digital Tracker		FA04, FA06, FA08
  FLX	****	Flextrax		M.K., xCHN (no dsp effects)
  GTK	**	Graoumf Tracker		GTK1, GTK4
  MGT	**	Megatracker		1.1
  TCB	***	TCB Tracker		'AN COOL.'

  Acorn formats:

  MUSX	***	Archimedes Tracker	V1.0+++
  DSYM  ***	Digital Symphony	0
  DTT	**	Desktop Tracker		-

  IIgs formats:

  MTP	**	SoundSmith/Megatracker	SONGOK, IAN92a

  PC formats:

  669	***	Composer 669/UNIS 669	if, JN
  ALM   ****+	Aley Keptr		1.0, 1.1, 1.2
  AMF	**+	DSMI (DMP)		1.0, 1.1, 1.2, 1.3, 1.4
  DMF	**	X-Tracker		7, 8
  FAR	***	Farandole Composer	1.0
  FNK	**	Funktracker		?
  IMF	*** 	Imago Orpheus		1.0
  IT	****-	Impulse Tracker		1.00, 2.00, 2.14, 2.15
  LIQ	***	Liquid Tracker		0.0, 1.0
  MDL	***	Digitrakker		0.0, 1.0, 1.1
  MTM	****+	Multitracker		1.0
  PSM	*** 	Epic Megagames MASI	epic, sinaria
  PSM	*** 	Protracker Studio	0.01, 1.00
  PTM	***	Poly Tracker		2.03
  RTM	**	Real Tracker		1.00
  S3M	**** 	Scream Tracker 3	3.00, 3.01+
  STM	****+	Scream Tracker 2	!Scream!, BMOD2STM
  STX	****+	ST Music Interface Kit	1.0, 1.1
  ULT	***	Ultra Tracker		V0001, V0002, V0003, V0004
  XM	**** 	Fast Tracker II		1.02, 1.03, 1.04

  YM3812 (Adlib) formats:

  AMD	***	Amusic Adlib Tracker	-
  RAD	***	Reality Adlib Tracker	-
  HSC	**	NEO soft/HSC-Tracker	1.5
  S3M	**** 	Scream Tracker 3	3.00, 3.01+

Ratings:

  *****	Perfect replaying
  ****	Accurate replaying
  ***	Fair quality, shouldn't hurt your ears
  **	Poor quality, lots of errors, bad or unimplemented effects
  *	Broken or nonfunctional loader

Format descriptions of packed modules sent by Sylvain "Asle" Chipaux. PTM
specs and info by Kilian Hekhuis.  AMF specs by Miod Vallat. Soundtracker
format details by Michael Schwendt and Sylvain Chipaux.


SUPPORTED PACKERS

The following compressed formats are recognized, some of them need helpers
to be installed on the system:

  Format	Helper		Native environment

  bz2		bzip2		Linux, Unix
  gz		gzip		Linux, Unix
  lha		lha		Amiga, DOS
  lzma		lzma		Linux, Unix
  MO3		unmo3		DOS?
  rar		unrar		DOS
  Z		compress	Unix
  zip		unzip		DOS
  zoo		zoo		Amiga?
  ArcFS		built-in	Acorn
  arc		built-in	Acorn, DOS
  MMCMP		built-in	DOS?
  PowerPack	built-in	Amiga
  !Spark	built-in	Acorn
  SQSH		built-in	Amiga


FRONT-ENDS

xmp can be used stand-alone, as a plugin for BMP or Audacious or as a back
end for GQmpeg, xhippo and others. Get them in the following URLs:

  BeepMP:    http://beepmp.sourceforge.net
  Audacious: http://audacious-media-player.org
  GQmpeg:    http://gqmpeg.sourceforge.net
  xhippo:    http://freshmeat.net/projects/gnuxhippo/homepage/

WARNING: When using the XMMS plugin, it's advisable to disable the mikmod
plugin (otherwise XMMS may get confused and eventually crash).


OUTPUT DRIVERS

xmp can play through a number of different output drivers.  Currently the
follwing devices are supported:

  Name		Description

  aix		AIX audio library (not tested, possibly broken)
  alsa		Advanced Linux Sound Architecture (ALSA) PCM
  arts		aRts (KDE sound server)
  beos		BeOS BSoundPlayer (not tested)
  bsd		BSD generic audio device
  dart		OS/2 Direct Audio Real Time (DART)
  esd		Enlightened Sound Daemon
  file		File/stdout output
  hpux		HP-UX audio device
  irix		IRIX audio library
  netbsd	NetBSD audio device
  nas		Network Audio System (NAS)
  openbsd	OpenBSD audio device
  oss_mix	Open Sound System (OSS) PCM
  oss_seq	Open Sound System (OSS) sequencer
  osx		MacOS X CoreAudio
  qnx		QNX audio device
  solaris	Solaris audio device (linear and ulaw)
  win32		Win32 sound (experimental, unstable)
  xmms		XMMS sound drivers (using the XMMS plugin)
  wav		WAV file writer
  win32		Windows WinMM


INTERACTIVE COMMANDS

The following single key commands can be used during the playback.  Click
on the volume bars in xxmp to mute channels. (Please read the manual page
for description of the command line arguments recognized by xmp.)

	'q' 		=>	quit the player
	'f'		=>	jump to next pattern
	'b'		=>	jump to previous pattern
	'n'		=>	jump to next module
	'p'		=>	jump to previous module
	SPACE		=>	pause
	'1' to '0'	=>	mute/unmute channels 1 to 10
	'!'		=>	unmute all channels
	'm' (xxmp)	=>	cycle through display modes


LICENSE

Extended Module Player (C)1996-2007 Claudio Matsuoka, Hipolito Carraro Jr
AWE-specific portions of oss_seq.c Copyright (C) 1996,1997 Takashi Iwai
ulaw encoding function Copyright (C) 1989 Rich Gopstein and Harris Corp
XPK-SQSH decruncher Copyright (C) 1997 Bert Jahn
ProWizard-PC decruncher Copyright (C) 1998 Sylvain Chipaux
IT sample decompression routine Copyright (C) 1998 Tammo Hinrichs
MMCMP and IT lowpass filter routines Copyright (C) 1998 Olivier Lapicque
OS/2-specific portions and DART driver Copyright (C) 1999 Kevin Langman
FFT routine Copyright (C) 1996-1999 Takuya Ooura
Portions of NAS driver Copyright (C) 1999 Martin Denn
LZW and Arc depacking Copyright (C) 2001-2006 Russell Marks

This program is free software;  you can redistribute it  and/or modify it
under  the terms of  the GNU General Public License  as published  by the
Free Software Foundation;  either  version 2 of the License, or  (at your
option) any later version. This program is distributed  in the  hope that
it  will  be useful, but WITHOUT ANY WARRANTY;  without even the  implied
warranty of  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You  should  have received a copy of the GNU General Public License along
with this program;  if not, write to the  Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
