msxplug player
for linux (and compatible) environment
======================================

This software is command-line music player of mgs/kss
based on MSXPlug (okazaki@angel.ne.jp).


REQUIREMENTS
============

* Linux (and other POSIX compliant environment)
* Sound device and appropriate drivers (supported OSS / ALSA / ESD)
* optional: some MSX sound driver (mgsdrv.com and else)


SUPPORTED FORMATS
=================
* kss (natively: no additional driver required)
* mgs (requires mgsdrv.com)
* other formats (please refer original msxplug archive)


INSTALL
=======

Just type 'make' and copy executable 'msxplugplay' into
appropriate path. If compilation failed, please try to fix.

To support additional MSX sound drivers (MGS, OPX, etc...),
please place appropriate drivers onto a path and specify it by
environment variable: MSXPLUGPLAY_DRIVERS_PATH.


USAGE
=====

$ msxplugplay (options) <file>

file would be a music file (*.mgs, etc) or music archive (.kss).

In playing (filenmame).kss, if (filename).m3u or (filename).pls is
exist in same folder of kss file, msxplugplay will try to parse 
these playlist file and play each musics listed in the playlist.

Options will be listed by specifying '-h'.


HINTS
=====

* To play kss file with m3u / pls file, just specify kss file name
  as <file>. msxplugplay can read and play with them.

* Under Zaurus folder, sample Makefile and executable for Linux Zaurus
  will be available (only tested in SL-C760 / SL-C1000).

* Under Symbin folder, tiny GUI player of msxplugplay (and sources)
  are avaiable.
  Please refer readme in the folder for further descriptions.

* freeverb support is available. Please try '-b' option to use.
  This freeverb is modified to run without FPU support, you can enjoy
  msxplugplay with reverb in linux-arm environment.

* In playing multiple song, to go next song, just press Ctrl-C.
  To terminate listening, doubly press Ctrl-C in short time.

* Please reduce the volume of your headphone / speaker if you listen
  music in public space.

* To run no-FPU environment, sources of MSXPlug were heavily modified.
  If you want to listen original-quality of MSXPlug, please refer
  original sources.


LICENSES
========
All sources are under auther's copyrights. Please refer each sources.


CREDITS
=======

MSXPlug:
        okazaki@angel.ne.jp
        please refer readme.txt of original archive for
        further descriptions
        http://dsa.sakura.ne.jp/index.php?MSXplug

ym2413.c: (from MAME project)
        Copyright (C) 2002 Jarek Burczynski

freeverb: 
        Written by Jezar at Dreampoint, June 2000
        http://www.dreampoint.co.uk
        This code is public domain

other codes:
        Daisuke Nagano <breeze.nagano@nifty.com>
        http://homepage3.nifty.com/StudioBreeze/