What is it?
===========

S3MRip is a nifty little CLI program that will extract the samples from a
Scream Tracker ]I[ module and save them as IFF 8SVX samples anywhere you
wish.

I wrote this to handle S3Ms specifically, because MEDs and MODs are already
handled by so many Amiga music programs.

pros:
+ saves samples under a user-defined prefix
+ handles the LOOP information correctly
+ uses happy 8SVX format, which is usable by many happy Amiga music programs

cons:
- handles 8-bit S3M samples only.  Does not handle adlib-type samples.
- only handles one file at a time with no wildcard support
- some S3Ms are discombobulated.  I only found documentation on the official
  S3M 3.20 format, so S3MRip misses some of the samples in non-standard S3Ms.
  It gives a "premature EOF" error.  If this happens to you, and you know the
  non-standard S3M's format, please contact me at the address below.

future features:
+ handling of discombobulated S3M files
+ optional preservation of original sample names
+ automatic fine-tuning using Splinear Interpolation
  (S3M samples have a fine-tune parameter)
+ batch file processing with wildcard support
+ handling of adlib-type samples (lots of work, don't hold your breath ;)


Usage
=====

From a Shell, type:

S3MRip S3Mname filebase

where "S3Mname" is the name of the S3M module, and "filebase" is the prefix
you want the samples saved under.


Examples
========

S3MRip MyMusic.s3m ram:MySample.

would extract the samples from "MyMusic.s3m" and save them as "MySample.1",
"MySample.2", "MySample.3", "MySample.4" ... in the ram: device.


S3MRip MoreMusic.s3m df0:MoreSam

would extract the samples from "MoreMusic.s3m" and save them as "MoreSam1",
"MoreSam2", "MoreSam3", "MoreSam4" ... in the df0: device.


That should be clear enough.  You should now be able to rip off the samples
from your favorite S3M songs!  I won't go into the ethics of ripping other
people's samples, though.  That kind of discussion is better suited to music
newsgroups.  Happy ripping!


Author contact
==============

S3MRip is written by GLYPH (Graham Fyffe)

S3MRip is freeware.  You can use it anywhere you like, and pass it around as
much as you like, as long as you include this doc file.

Mail me with any bugs / questions / comments / suggestions.

E-Mail:
y82s1@unb.ca

Home Page URL:
http://www.geocities.com/CollegePark/9315/graham.htm