XMMS-SID - SIDPlay input plugin for X MultiMedia System (XMMS)
==============================================================
(C) Copyright 2002-2003 Matti 'ccr/TNSP' Hämäläinen
    (versions from v0.5 up to current)

(C) Copyright 1999 Willem Monsuwe
    (versions up to v0.4)

"XMMS-SID Theme"-song (SIDtune)
    by Peter 'Brite-Lite' Halin of Dekadence
    (C) Copyright 2002 Dekadence
    <http://www.dekadence64.org/>

MD5 Algorithm code for song-length database handling
    by L. Peter Deutsch <ghost@aladdin.com>
    (C) Copyright 1999 Aladdin Enterprises. All rights reserved.


Short Introduction
==================
XMMS-SID is a plugin for XMMS (X MultiMedia System) which provides
support for playing the so-called "SID tunes", which are music
from old Commodore computer programs like games, demos, etc.

For the actual playing, XMMS-SID uses the excellent libsidplay (1|2)
SID-chip/6502 emulator engine that emulates 6510 CPU and 6581/8580
Sound Interface Device (SID) chip.

If you are not familiar with the term "SID tune" or "SID" concept
at all, please read the longer introduction in the FAQ!


Usage
=====
Using the plugin is quite simple: if you are familiar with XMMS and
SIDPlay, then you already know how to use XMMS-SID. Configuration
should be self-explanatory, here are few tips:

* SIDPlay2-emulation is harder, but more accurate. So you need to have
  more CPU-power for it.

* Oversampling is available with SIDPlay2-emulation, it can further
  enchange the audio quality, but requires even more power.

* Filter-settings can be usually left as they are, unless you know
  what you're doing.

* If the plugin doesn't recognize your SID-tunes, try checking the
  'Determine filetype by contents' option in the XMMS-SID config window.
  This is horrendously slow if you're reading a 10000-tune playlist,
  though.

* For those who don't know it: Autopanning and stereo are not native to
  the original SID chip on C64&all, but are extra options implemented in
  libsidplay. So if you think that the tune does not sound as it sounds
  on the real C64 (or other SID using machine), use the Mono setting.

* The "kb/s rate" box is actually the play rate in Hz, so you can
  see if it's an NTSC or PAL song (if you haven't set the Force Speed
  option).

Also see FAQ for more tips, notes and such.



Contacting and where to get new versions
========================================
New releases of this plugin should be available at TNSP's WWW-
homepages, see below for address. Bug-reports, suggestions,
patches, etc. should be sent to ccr.

ccr's e-mail: ccr@tnsp.org

XMMS-SID's homepage: http://www.tnsp.org/xmms-sid.php

TNSP's WWW  : http://www.tnsp.org/
TNSP e-mail : tnsp@tnsp.org