Mirror for MARS source code (MIPS Assembler and Runtime Simulator)


browse log



You can also use your local clone with git send-email.

MARS Assembler

MARS is a lightweight interactive development environment (IDE) for programming in MIPS assembly language, intended for educational-level use with Patterson and Hennessy's Computer Organization and Design.

MARS has been jointly developed by Pete Sanderson (programming) and Ken Vollmar (details and paperwork).

Last update

Aug. 2014


You can download the latest version at the official website.

Purpose of this repo

This repo is a mirror of the source code of MARS Assembler. Though the source code is into the MARS.jar file at the download page, this is a mirror for people who wants to have the source code forked or that stuff.

I'm not going to accept any pull request. This source code is not maintained by me but the original developers. If you want to contribute to the project, you should talk with them [going here][8].

Documentation (included in the repo)

Go to the offical documentation.

Create an executable

In order to run or compile MARS v4.XX, MARS requires Java J2SE 1.5 (or later) SDK installed on your computer.


Execute CreateMarsJar.bat file to generate an executable.

GNU/Linux - Mac

Execute the CreateMarsJar.sh to generate an executable. If you can't due of permissions, do a chmod +x CreateMarsJar.sh (Thanks to [@aesptux][8] to be the tester in Mac).


Rename the jar file to Mars.jar for convenience.

Option A: Desktop

Save the jar file on the desktop. Run MARS by double-clicking the icon.

Option B: Shell using jar file

Save the jar file in some folder. Open a shell in that folder. . Run MARS with the DOS command java -jar Mars.jar.

Option C: shell using Java classes Save the jar file in some folder. Open a shell in that folder. Extract MARS files with the command jar -xf Mars.jar. Run MARS with the command java Mars.


MIT. Chech the LICENSE file. All the credits go to the original developers.