




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

			      Version 1.1.3



This is the Extended Module Player, a tracked module player for Unix. xmp
plays several  module formats including XM, S3M and MOD.  See the INSTALL
file for instructions for building and installing xmp.

The  latest  version is  available at http://www.merdre.net/~claudio/xmp.
Please send bug reports to claudio@pos.inf.ufpr.br. Patches, comments and
suggestions are welcome.

The current version recognizes the following module formats:

    xm (Fast Tracker II), mod (Noise/Fast/Protracker), s3m (Scream
    Tracker 3), stm (Scream Tracker 2), mtm (Multitracker), ptm (Poly
    Tracker), okt (Oktalyzer), far (Farandole Composer), wow (Mod's
    Grave), amd (Amusic Adlib Tracker), rad (Reality Adlib Tracker),
    669 (Composer 669), alm (Aley's modules), mod (Soundtracker 15
    instruments)

See docs/formats.txt for details  about the supported formats.  Currently
supported output devices are the OSS sequencer (for the Gravis Ultrasound
and AWE32 cards or SoftOSS) and the software mixer (for OSS, Sun audio or
to mix to a file).  The OSS sequencer can be used to play FM modules in a
OPL2 FM synthesizer (Adlib card for PCs).  Experimental support for HP-UX
on HP9000/700 is available in this package.

The software mixer included in the xmp package allows xmp to play through
the /dev/audio device  or  mix directly to a file.  The output is 8 or 16
bit,  signed  or unsigned linear samples, mono or stereo, interpolated or
not. Software mixing usually requires a lot of CPU power.

Other features: support for gzip/compress/zip/lha/bzip compressed modules
(zip and lha must be single file archives); random order playing; support
for 4 bit ADPCM encoded samples (used in MDZ files); interactive commands
to skip and return patterns and modules; channel muting.



			     C o m m a n d s	
			     ===============

The following single key commands can be used during the playback.  Click
on the volume bars in xxmp to mute channels.

		'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 '8'	=>	mute channels 1 to 8
		'!' to '*'	=>	unmute channels 1 to 8

The '!' to '*' keys are supposed to be SHIFT + '1' to '8'. That's true in
a standard US keyboard,  but  may be a clumsy choice of keys in a foreign
keyboard with the symbols  placed in different keys.  My keyboard has the
following layout, let me know if yours is different:

			  !  @  #  $  %  ^  &  *
			  1  2  3  4  5  6  7  8



                              L i c e n s e
			      =============

                           Extended Module Player
    Copyright (C) 1996-1998 Claudio Matsuoka and Hipolito Carraro Jr
 AWE-specific portions of oss_seq.c Copyright (C) 1996,1997 Takashi Iwai
-------------------------------------------------------------------------
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.


                        ADPCM encoder and decoder
          Copyright (C) 1992 by Stichting Mathematisch Centrum
            Amsterdam, The Netherlands. All Rights Reserved.
-------------------------------------------------------------------------
Permission to use,  copy,  modify,  and distribute this  software and its
documentation for any purpose and without fee is hereby granted, provided
that the above  copyright notice appear in all copies and  that both that
copyright notice and this permission notice appear in supporting documen-
tation,  and that the names of Stichting Mathematisch Centrum  or CWI not
be  used in advertising  or publicity  pertaining  to distribution of the
software without specific, written prior permission.

STICHTING  MATHEMATISCH  CENTRUM  DISCLAIMS ALL WARRANTIES WITH REGARD TO
THIS SOFTWARE,  INCLUDING ALL  IMPLIED WARRANTIES  OF MERCHANTABILITY AND
FITNESS,  IN NO EVENT SHALL STICHTING MATHEMATISCH  CENTRUM BE LIABLE FOR
ANY SPECIAL,  INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
RESULTING  FROM LOSS OF USE,  DATA OR PROFITS,  WHETHER  IN  AN ACTION OF
CONTRACT,  NEGLIGENCE  OR  OTHER  TORTIOUS ACTION,  ARISING OUT OF  OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.



                      A c k n o w l e d g m e n t s
                      =============================

We would like to  thank the following people that  directly or indirectly
contributed to make xmp a better product:

    Felix Brandt, Gustav Grefberg, Fredrik Huss and Magnus Hogdahl,
    Hannu Savolainen, Andrew G. Robinson, Daniel Marks and David Jeske,
    Carlos Hasan, Toru Egashira, Elisa Nascimento, Dieferson Araujo,
    Takashi Iwai, Antti Huovilainen, Michael Janson, Sergio Mori,
    Priit Jarv, Matthias Leonhardt, Kilian Hekhuis, Jaroslav Kysela,
    Aley Keptr, Arnaud Hasenfratz, Marcelo Malheiros, Russel Marks,
    Davi Lima, Bernardo Innocenti, Robinson Mioshi, Eric Bouquerel and
    all xmp users in the world.

    To Ronny Nordeide, Jogeir Liljedahl, Skaven, Purple Motion, Gustaf
    "Lizardking" Grefberg, Elwood, Markus "Captain" Kaarlonen, Kenny
    Chou, Bjorn "Dr. Awesome" Lynne, Chorus & Sid, Mick Rippon, Fabio
    Barzagli, Jester, Leviathan, Necros, Moby, Ryan Cramer, Soundmaster,
    The Zapper!, Chrylian, Jeronen Tel, Erik Stridell and all those we
    forgot to mention, our thanks for the hundreds of hours of the most
    enjoyable music that made our debugging sessions a real pleasure.

	
Claudio Matsuoka
Hipolito Carraro Jr
Wed Jan 28 20:09:56 EDT 1998
