ORGestrate v0.3.0
--

- Background Infos -
This is my very first music related peice of software ever. In fact, I'm not even familiar with most musical terms ;) Anyways, release 0.3. This one has that GUI i've been talking about, and its themable - But there is no theme selector and you STILL have to drag and drop or put an ORG file as the first parameter because there is no playlist system nor an open button.

So, for the next release: XML Meta data (Already filled out some of the XML for it, see orgfiles/meta.xml) and playlist support, and a more complete GUI.

The motives were mainly because nobody else had done anything like it before. I'd love to see the original code in all but 
 1. I suck and probably couldn't get it (Additionally I can't speak Japanese. Yet. So I can't really speak for myself, to Pixel.)
 2. Its not portable to other platforms (Well I can do ports but writing from scratch may be better in this case.)
 3. I can't redistribute it :P (I love sharing. I support Open Source and Freeware in general.)
 4. Its fun to do this kind of stuff! (Hacking/Programming FTW :D)

With this player, you should be able to expand upon the ORG format easily if needed. In addition, to make the code more useful, The internal ORG library should gain minipulation capabilities. Of course though, This will be after some MAJOR cleanup of the play code.

The player is released as Public Domain, making it completely possible to use in proprietory software modified without giving back source. Of course I'm only doing this for good measure - I could've used something more strict like GPLv2 (But then i'd have to settle without FMOD, the only multiplatform sound library who has enough features to work with this library. Except MikMod, but the quality was absolutely dreadful with MikMod's SFX stuff.) but with this others who do not want to give out source may use it in their software, whatever it does, and for those who don't like keeping track of the names to give credit for, you don't have to no matter what you do to the code or how you use it.

While you don't have to give credit, If you think its worth giving credit, I'd love for you to. Could be as simple as my 3 letter nickname. (See End ;) )


- Notes about ORG Samples -
Instrument Samples: Found as .wav files as resources, but since i couldn't decode them, i just ripped the raw data out using audacity.
Melody Samples: Found in a resource called "WAVE100", It happens to be one hundred 256 byte raw 16 bit Waves. There is a BASH Script included that will decode this block and encode the samples from the extracted resource file (Requirements: Unix style enviroment, GNU bash, FFMPEG, May or may not work on MacOSX.)


- Multi-Platform-Ability -
I don't have a MacOSX box up, so there is no real explicit Mac OSX support. FMOD supports Mac OSX, SDL/OpenGL should run on Mac OSX, and pretty much the rest of the program is just POSIX stuffs (Which gets ifdef'd to various platform dependent functions on Windows because its dumb ;) )

- Usage -
./linux-orgestrate.bin [file]
./linux-orgestrate-64.bin [file]
ORGestrate.exe [file]

Simply run it off a terminal and the first argument is the name of the ORG file. On Windows you may drag the org file onto ORGPlay.exe to play it, OR associate .org files to OrgPlay so you may double click the files.

If you do not have any ORG files, You must rip them from any ORG playing application (Windows versions for now). I'd start with Doukutsu Monogatari or Organya View, mainly because thats all I'm aware he made that used the ORG 02 File Format. To rip you simply use a resource editor to export the ORG resources out. XN Resource Editor is a good free one (that will run on Linux via Wine) that can do the job. I'd recommend any others though, I do not prefer any resource editor in specific. Most i've used are pretty good, but all of them have some limitations. Fortanatally, Most will rip ORG files, so you don't have to worry in most cases.


- Contact -
Email: nmnnotmyname@gmail.com
AIM:   notmyname06
MSN:   nmnnotmyname@gmail.com

If you wish, you can send improvements of the code to me. Please make sure your code is multiplatform - If you plan to make extra sound backends, I need to have modularized sound output backends first... (Of course, thats nothing i wouldn't except as a contribution, hint hint.)

- End ;) -
Enjoy. I hope. 

 ~nmn
