xmp-os4 2.5.0

Short:        Plays over 80 module formats (inc. MED)
Author:       Claudio Matsuoka, Hipolito Carraro Jr, AmigaOS 4.0 compile by Spot / Up Rough
Uploader:     Varthall / Up Rough <varti02 hotpop com>
Type:         mus/play
Version:      2.5.0
Architecture: ppc-amigaos >= 4.0.5

AmigaOS4 Notes:

Make sure you have the AUDIO: device installed.

Changes since last release:
Updated to the latest version, AmigaOS changes submitted to author.
/spot


Extended Module Player Version 2.5.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 80 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 including gzip, bzip2, SQSH, Powerpack, etc.


SUPPORTED FORMATS

Xmp tries to accurately emulate Protracker, FastTracker II, ScreamTracker
3 and Impulse Tracker event handling algorithms to play M.K., XM, S3M and
IT modules. By default, Noisetracker and 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 (Startrekker AM, Soundsmith, ALM, etc).

The current version recognizes the following module formats:

  Type  Rating Tracker/packer  Recognized variants

  Protracker and variants:

  CHN ****+ Fast/Taketracker xCHN, xxCH
  FLT ***  Startrekker/ADSC FLT4/8/M, EXO4/8
  ST **** 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
  FC-M ****+ FC-M Packer  1.0
  FCHS ****+ Fuchs Tracker  -
  IMS *** Images Music System ?
  KSM ****+ Kefrens Sound Machine -
  MP ****+ Module Protector -
  NP ****+ NoisePacker  1.0, 2.0, 3.0
  Pxx **** The Player  4.x, 6.0a
  TP *** Tracker Packer  3
  PM *** Power Music  -
  PHA *** Pha Packer  -
  PROM ****+ Promizer  0.1, 1.0c, 1.8a, 2.0, 4.0
  PRU ****+ ProRunner  1.0, 2.0
  UNIC ****+ Unic Tracker  1.0, 2.0
  WN ****+ Wanton Packer  -
  XANN ****+ XANN Packer  -
  ZEN ****+ Zen Packer  -

  Other Amiga tracker formats:

  DBM *** DigiBooster Pro  DBM0
  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
  OKT  *** Oktalyzer  -
  SFX *** SoundFX   1.3, 2.0?

  Atari tracker 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 tracker formats:

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

  IIgs tracker formats:

  MTP ** SoundSmith  SONGOK, IAN92a

  PC tracker formats:

  669 *** Composer 669/UNIS 669 if, JN
  ALM   ****+ Aley Keptr  1.0, 1.1, 1.2
  DMF ** X-Tracker  7, 8
  FAR ***  Farandole Composer 1.0
  FNK *** Funktracker  R0, R1, R2
  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
  PTM ***  Poly Tracker  2.03
  RTM *** Real Tracker  1.00
  S3M ****  Scream Tracker 3 3.00, 3.01+
  STM ****+ Scream Tracker 2 !Scream!, BMOD2STM
  ULT *** Ultra Tracker  V0001, V0002, V0003, V0004
  XM ****  Fast Tracker II  1.02, 1.03, 1.04

  PC packed formats:

  AMF *** DSMI (DMP)  1.0, 1.1, 1.2, 1.3, 1.4
  GDM   *** Generic Digital Music 1.0
  STX ****+ ST Music Interface Kit 1.0, 1.1

  Game formats:

  DI ****+ Digital Illusions -
  GMC ****+ Game Music Creator -
  PSM **** Epic Megagames MASI epic, sinaria
  PSM **** Protracker Studio 0.01, 1.00
  STIM ****+ Slamtilt  -
  UMX ****+ Epic Games Unreal/UT IT, S3M, MOD, XM

  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?
  oxm  oggdec  Windows
  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 as a stand-alone terminal-based (CLI) player, as a plugin
for XMMS, BMP, Winamp or Audacious,  or as a back end for  GQmpeg, xhippo
and others. Get the media players and front-ends in the following URLs:

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


OUTPUT DRIVERS

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

  Name  Description

  ahi  Amiga AHI audio output
  aix  AIX audio library (not tested, possibly broken)
  alsa  Advanced Linux Sound Architecture (ALSA) PCM
  alsa05 ALSA 0.5 / QNX Neutrino 6 sound system
  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 Neutrino 4 audio device
  solaris Solaris audio device (linear and ulaw)
  wav  WAV file writer
  win32  Win32 sound (experimental, unstable)


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

*** Not supported in the AmigaOS 4.0 version, wait for a TuneNet plugin ***

FEEDBACK

Send your comments and bug reports to xmp-devel()lists.sourceforge.net, or
directly to cmatsuoka()gmail.com.


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
Amiga AHI driver (C) 2007 Lorence Lombardo

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.