Skip to content

DKCRecomp/snes-trace-converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SNES Assembly Extractor

This tool converts Mesen emulator txt log traces, into structured asm files.

It handles code repetitions and SPC700 audio code.

This was developed using Mesen, but I don't guarantee if it works for other emulators. Contact me if it does.

It should work for any SNES game.

Important

No rom, game assets, nor extracted code in this repository.

Example result

Using a log named DKC1_USA1_2.txt :

Overview Bank_00.asm
result-overview result-bank

How to use it ?

Before using it, you will need to get trace logs.

bash run.sh

This will reads all .txt from traces/, delete double code, and generate .asm files in result/{FILE_NAME}.

Note

This process can be long depending on the trace files size.

How to get game code trace ?

1. Launch Trace Logger

On the toolbar at the top, select Trace Logger :

toolbar

Make sure you got these exact settings for better compatibility :

trace-logger-settings

3. Log to a .txt file

Select Log to file... :

log-to-file

Save it as a .txt file in this-project/traces :

place-traces

4. Start trace log creation

Press play button on the upper left to start trace creation :

trace-log-run

Warning

Trace logging can quickly generate VERY large .txt file, a file from a 20min session can take up to ~60 Go ! Make sure you got large free space.

About

Tool to convert Mesen trace logs into organized assembly code.

Resources

License

Stars

Watchers

Forks

Contributors