XMMS-SID - SIDPlay input plugin for X MultiMedia System (XMMS)
==============================================================
(C) Copyright 2003-2004 Matti 'ccr/TNSP' Hämäläinen

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 Commodore 64 "SID tunes", which are music
from old Commodore computer programs like games, demos, etc.

For the actual playing, XMMS-SID supports numerous emulator
engines, including the excellent libSIDPlay v1 and v2.


Requirements and installation
=============================
See file "INSTALL" for information about what XMMS-SID requires,
where to get those required packages and how to install.


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 for most part, here are few tips:

* XSIDPLAY-compatible song-length database is a file that contains
  lengths for most songs in High Voltage SID Collection (HVSC). I
  highly recommend that you download the database and configure
  XMMS-SID to use it. The SLDB is available at
  http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/sldb.html

* SIDPlay2-emulation is heavier, 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 you need some really powerful
  hardware to run it smoothly.

* 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.

IRC      : #xmms-sid at irc.freenode.net (see http://www.freenode.net/)

E-mail   : ccr@tnsp.org

Homepage : http://www.tnsp.org/xmms-sid.php