Hi all,

just some little steps to convert your favorite Stepmania stepfiles .SM to Beat2x keyfiles .BXE:

1. Download oggenc2.exe and oggdec.exe from http://www.rarewares.org/ogg.php
2. Create a folder
3. Copy all Stepmania songsfolders you wish to convert in it
4. Extract the sm2bxe archive into the root of your folder (needed files are sm2bxe.vbs, convert_sm2bxe.cmd, oggenc2.exe, oggdec.exe)
5. Run convert_sm2bxe.cmd
6. All results of the conversion process will then be in a newly created subfolder called: ".\_converted"

An example result can be:
.\_converted\My favorite Song\Favorite_01BEGINNER.bxe
.\_converted\My favorite Song\Favorite_03EASY.bxe
.\_converted\My favorite Song\Favorite_06MEDIUM.bxe
.\_converted\My favorite Song\Favorite_09HARD.bxe
.\_converted\My favorite Song\Favorite_11CHALLENGE.bxe
.\_converted\My favorite Song\Favorite.nam					(this files includes the original name included in converted SM file)
.\_converted\My favorite Song\Favorite.ogg					
.\_converted\My favorite Song\Favorite.log					(If something went wrong while converting the song - you might find some usefull information in there.)

Some comments/hints:
- every Stepmania song folder needs to have at least 2 files in it: 1x SM-file, 1x OGG-file
- while the conversion process, ogg files will be reencoded to 128kbps at 44.1 KHz ogg files. The best format to use with Beat2x. 
	(e.g. Beat2x can not playback 48 KHz encoded ogg files in the right speed!)
	If you do not wish to reencode all ogg files, take a look inside "convert_sm2bxe.cmd" to disable reencoding.
- dwi stepfiles are NOT supported. To convert dwi stepfiles to bxe keyfiles, use dwi2bxe 1.3 freeware tool by furrtek 
	(can be obtained from http://archive.gp2x.de/cgi-bin/cfiles.cgi?0,0,0,0,15,1410)
- While building your own songlist.bxs files: Use an editor which can handle LF-only text files (unix formated). My personal favorite: http://www.crimsoneditor.com/ (you can switch to Unix format inside its menu at "Document/Fileformat/Unix format (LF only)"
- sm2bxes mainpart is a vbs script. To run this script, you need to have "Windows Scripting Host 5.7" installed & you need to own the rights to run those WSH scripts. 


If you find some bugs, ill be glad to get them from you :) Just send me a PM at forum.gp2x.de :)

Have fun!
	-Zwirch

### Version information:
### This README file is created for sm2bxe version Version 1.0
### Corresponding freeware archive package name is: sm2bxe_v1.0_20081026.rar