# mipsasm
[](https://github.com/imaandrew/mipsasm/actions)
[](https://crates.io/crates/mipsasm)
[](https://docs.rs/mipsasm)
A MIPS assembler targeting the Nintendo 64
## Getting Started
### Pre-Built Binaries
Pre-Built binaries can be found on the [releases page](https://github.com/imaandrew/mipsasm/releases)
### From Source
mipsasm can be installed using rust's package manager:
```cargo install mipsasm```
## Usage
CLI usage can be found by running `mipsasm --help`
```
mipsasm [OPTIONS] <MODE> <INPUT_FILE>
ARGS:
<MODE> Assemble or disassemble the input file [possible values: asm, disasm]
<INPUT_FILE> Use this file as input
OPTIONS:
-b <base addr> Use this address as the base address of the program [default: 0x80000000]
-h, --help Print help information
-o <output> Write output to this file
-s <syms> Import symbols from this file
-V, --version Print version information
```
API documentation can be found on [docs.rs](https://docs.rs/mipsasm)
## License
Licensed under either of
* Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license
([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.