altra64/README.md

75 lines
1.7 KiB
Markdown
Raw Normal View History

# Altra64
2014-06-29 01:10:11 -04:00
2014-06-29 16:31:24 -04:00
Alternative Everdrive64 menu
2014-06-29 01:10:11 -04:00
`Altra64` is an open source menu for [Everdrive64](http://krikzz.com/) and is based on a fork of alt64 which was
2014-06-29 16:31:24 -04:00
originally written by saturnu, and released on the
[Everdrive64 forum](http://krikzz.com/forum/index.php?topic=816.0).
2014-06-29 01:10:11 -04:00
2014-06-29 16:31:24 -04:00
## Building
2014-06-29 01:10:11 -04:00
2016-12-13 15:39:54 -05:00
If you want to build the menu, you need an n64 toolchain. When using windows 10 or Ubuntu, installation is totally automated through a script.
2014-06-29 01:10:11 -04:00
### Dependencies (installed automatically)
* Windows 10 (Aniversary Update or above) / Ubuntu 16.04 (or above)
* [libdragon](https://github.com/DragonMinded/libdragon)
2016-12-29 12:09:13 -05:00
* [libmikmod (with n64 driver)](https://github.com/networkfusion/libmikmod)
2014-06-29 16:31:24 -04:00
* [libmad-n64](https://github.com/parasyte/libmad-n64)
* [libyaml](http://pyyaml.org/wiki/LibYAML)
2014-06-29 01:10:11 -04:00
2014-06-29 16:31:24 -04:00
### Build the Toolchain
2014-06-29 01:10:11 -04:00
2014-06-29 16:31:24 -04:00
*You may skip this step if it's already installed.*
2014-06-29 01:10:11 -04:00
Clone this `Altra64` repo to a directory of your choice.
2014-06-29 01:10:11 -04:00
2016-12-13 15:39:54 -05:00
On Windows 10, browse to the tools directory and double click on ```setup-wsfl.cmd```.
2016-12-13 08:09:11 -05:00
On Ubuntu, browse to the tools directory and run the command ```$ chmod +x ./setup-linux.sh;source ./setup-linux.sh```
2014-06-29 01:10:11 -04:00
### Build `Altra64`
2014-06-29 01:10:11 -04:00
To build the Rom
2014-06-29 16:31:24 -04:00
from the projects root directory,
On Windows 10 run
2014-06-29 16:31:24 -04:00
```
> build
2014-06-29 16:31:24 -04:00
```
on linux
2014-06-29 16:31:24 -04:00
```
$ make
```
2016-12-13 08:09:11 -05:00
If it all worked, you will find `OS64.v64` in the `Altra64` bin directory.
2014-06-29 16:31:24 -04:00
### Debug Build `Altra64`
To build the debug version of the Rom
2014-06-29 16:31:24 -04:00
from the projects root directory,
On Windows 10 run
```
> build debug
```
on linux
```
$ make debug
2014-06-29 16:31:24 -04:00
```
2016-12-13 08:09:11 -05:00
If it all worked, you will find `OS64.v64` in the `Altra64` bin directory.
2014-06-29 16:31:24 -04:00
### Clean `Altra64`
Finally, we can clean the build objects from the project
2014-06-29 16:31:24 -04:00
from the projects root directory,
On Windows 10 run
```
> build clean
```
on linux
```
$ make clean
2014-06-29 16:31:24 -04:00
```
2016-12-13 08:09:11 -05:00
Enjoy!