kitlith / rseq_rs

RSEQ assembler, disassembler, and midi converter

rseq_rs

TBH I still expect some breakage from the current code, so make sure to make a GitHub issue on crashes or things not working as expected.

I'm also putting more work into GotaSequenceCmd now, so you may want to use that instead of this.

Usage

Disassemble

disassemble input.brseq output.txt where input is a file in the BRSEQ format and output is where you wish its disassembly to be output.

Assemble

assemble input.txt output.brseq where input is an 'assembly' file in the format produced by disassembly, and output is where you wish the resulting BRSEQ to end up.

Invert

invert input.brseq output.brseq where input is a BRSEQ file and output is where you want to create a BRSEQ with 'inverted' notes. (for every note it does 0x7F - note_value)

This was created as a very simple test for producing songs that could be used to replace other songs before the assembler was created/finished.

Play

play input.brseq output.midi

This is essentially a reimplementation of rseq2midi using the same parsing code as the rest of these programs. YMMV, but last I checked it handled call and jump better than rseq2midi.

Credits

Atlas, for the BRSEQ documentation that was immensely useful for implementing this (https://pastebin.com/xgsKecv9) Ruben Nunez and Valley Bell, for making rseq2midi which play is based on and was also used as a form of documentation Adam Crossing, for making videos about Wii Music and inspiring me to look into this

rseq_rs's Issues

Tempo and Play (and possibly others) need a better way of executing the instructions

tempo goes through the instructions in physical order, which is an issue when the tempo instruction is only in a single track and it's not the first track. It would help if it took an approach closer to play, following control flow.

play follows control flow, but it goes through each track in turn instead of following strict temporal order, which would be preferred for accurate emulation of some aspects of rseq.

The end goal for this issue would be to produce a single player that could be used for both purposes, and possibly others in the future.

Actually make a release for tempo at some point

currently there's a build being distributed, but it's not present on github. this should be fixed.

no fucking idea what happend here (play.exe)

i dragged a brseq file into play.exe, it lagged the entire system and it caused the hard drive to spin out of control??
it took forever to shut off. What happend??

Play does not handle 0-length notes correctly. (should be handled as note-on/note-off events)

Some brseq files (stemming from from_midi based on GotaSequenceLib) appear to emit 'note-on/note-off' events in the form of 0 length notes instead of entire notes. play currently emits these as notes all on their own, instead of as note-on/note-off events.

thread 'main' panicked at 'not implemented: Currently, there is no way to handle an destination without a label', <::std::macros::panic macros>:5:6

title says it all. you probably won't read this, but i'm desperate to extract some midis from the check mii out channel and i don't know how to fix this error

Handle Missing Labels (+ label stripping tool?)

rseq_rs will currently break if an address is referenced that doesn't have a label to go with it.

Label stripping is an idea intended for space savings when you need to hex edit a brseq into a brsar, as an effortless way to gain a little bit of extra space for the song. For substantial space savings, though, people should still look into looping (and I should really look into writing a compression algorithm).

Play apparently tends to reorder the tracks compared to the original input, and some other converters to midi