jASM: Java-built ASM emulator and debugger

Usage

This project uses Java 8, so be sure to download it.

To build it, just run make (you'll need to have Maven installed and the mvn binary in your path).

Run it with java -jar target/jASM-1.0-SNAPSHOT.jar -h to view the usage options. Be sure to take a look at the examples and the syntax documentation.

Running java -jar target/jASM-1.0-SNAPSHOT.jar -m interactive will start an interactive prompt where you will be able to enter your program.

Please note that these screenshots may be out of date, but they should give a good idea of the general look and features

To start the GUI, run it with the -m window option. Make sure to provide a valid asm source file. Running java -jar target/jASM-1.0-SNAPSHOT.jar -m window -a examples/loopdec.asm should show you the following:

Contributing

Interested in contributing? Check out the TODO and the coding style. Or, if you prefer it, jump ahead and read some of the example files.

Licensing

This software is distributed under the GPLv3 license. For more information, please check the License.

This software uses the Apache Commons CLI Library, distributed under the Apache License 2.0.

Graphical Interface Icons by Daniele De Santis distributed under the CC Attribution 4.0 license.

Additional Icon work by IconsMind.