Česky
ScreamTracker 3 to ModTracker 3 convertor

   This program converts standard ScreamTracker 3 (S3M) trackers into my own format called ModTracker 3 (MD3). This special format is requiered by my AVR S3M-player. It is very similar to original ProTracker (MOD) but it has all advantages of S3M like compressed patterns, default panning, higher count of longer samples, ...
   Convertor consist of two separated programs. First one "s3m2md3.exe" is main conversion utility and second one "S3M_convertor.exe" is GUI for it that allows you to convert multiple files at once.
   As usually it was made in BDS2006 Turbo C++ in Windows XP, so I have no idea what it'll do newer versions but there is nothing specific so it should be ok.


1 - Settings

   Usually there is no need for setup but if you decide to change max instruments count from default 48 to something else in main S3M-player source code than you'll have to change this parameter also in "config.ini". It is "maxinstr" value in [CONVERTOR] section.

This is how it's look like


2 - s3m2md3.exe

   This utility reads specified S3M file and if it has supported format than it generates output file in MD3 format. It supports only standard samples in 8/16-bit singed/unsigned format with sampling rates above 1024Hz. If conversion fails than it should print reason. Usually it's to high count of instruments so it's good idea to open your S3M in MPtracker and make "cleanup" operation that deletes uneccessary patterns, instruments, etc. MPtrakcer also allows you to convert other formats in S3M but of course it can't convert trackers that uses MIDI type instruments properly.
   Usage of this utility is simple:

spell_mod_builder.exe [-maxinstr N] source_path.s3m [dest_path.md3]

   Optional parameter "-maxinstr" specifies max supported instruments count in range 1 to 128 (default N=48). Value should be equal to value set in main S3M-player source code.
   "source_path.s3m" is path to source S3M file. MD3 result is stored to "dest_path.md3" path or to the same folder if last parameter is not defined.


3 - S3M convertor

   This program is GUI for main conversion utility. At first you have to fill list of S3M files you want to convert. Than you have to set folder to store MD3 results. Then just press "Start conversion". If everything is ok, source files list is automatically cleared. If it fails to convert some files from list then they should stay in list and you can display error messages returned by main conversion utility to identify reason.


4 - Licence

   It's freeware so you are free to use and redistribute it but only with all included files together (especially with this help) without any modifications!
   Since it's freeware you are using this at you own risk! Any possible dammage caused by this SW is your problem.
   If you don't agree with theese terms don't use this SW.


5 - Contact

   In case of some problems with this SW you can contact me at s.maslan@seznam.cz. Additional informations and new versions could be find here: http://www.elektronika.kvalitne.cz/ATMEL/S3Mplayer/S3Mplayer.html.



(c) 2011, Stanislav Mašláň - All rights reserved.