Skip to content

A tool to compile sm64ex for macOS (Intel or Apple silicon) and create an app bundle.

Notifications You must be signed in to change notification settings

SpyterDev/SM64EX-mac-Build-Tool

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 

Repository files navigation

Note!

This is tool is not made by the developers of sm64ex. This is just a fan-made tool made on top of Haframjolk's build script and app bundler, to make the process of compiling it quicker and a little more accessible for those who have never used terminal, or compiled anything before.

About SM64EX-mac Build Tool

SM64EX-mac Build Tool is a script to compile sm64ex (and easily install everything you need to compile it) for macOS (Intel or Apple silicon) and create an app bundle (turn it into an app that you can open). There are more feature to come such as the ability to say what build flags other build flags you want on, without having to change it in the shell script. Also a UI wrapper might also be made!

Dependencies

Compiling sm64ex and creating an app bundle with all dylibs included on macOS requires the following Homebrew bottles to be installed, however if you run the sm64ex-mac build tool everything you need will be automatically be installed:

brew install gcc make sdl2 glew glfw pkg-config dylibbundler mingw-w64

Building

Download (clone) the sm64ex repository (or you can have the script download it):

git clone https://github.com/sm64pc/sm64ex.git

Place a legally obtained US Super Mario 64 ROM in the sm64ex repository root and name it baserom.us.z64. Then apply any patches you want to apply, before compilation. By default the sm64ex-mac build tool will prompt you to apply 60 FPS patch script so you just have to say yes or no while running the script.

To use the build tool, download the latest version from Releases.


Place the icon you want to use for the app bundle in the repository root and name it `icon.icns` or when the sm64ex-mac Build Tool asks you if you want to add an icon, drag and drop it.

After you have the sm64ex repository set up just run the build script:

```sh
./install_build_everything.sh

In the releases, there is a version (the same thing without the .sh in the name) which you can open from Finder! That might be easier. The freshly made app will then be appear in a new folder called out in the same folder which the sm64ex-mac Build Tool.

Credits

This is a built on top of Haframjolk's build script

  • SpyterDev: Developer behind this fork. Created dependency installer, build prompts (option to also add an icon in script, option to add build options, and option to apply the 60 FPS Patch before compiliation).
  • Haframjolk: The original developer behind the script (https://github.com/haframjolk/sm64ex-mac). Created the app bundling implementation which the fork uses!

About

A tool to compile sm64ex for macOS (Intel or Apple silicon) and create an app bundle.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%