-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
49 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,49 @@ | ||
# Mednafen | ||
|
||
## Compiling this Repository on macOS (tested on Monterey) | ||
|
||
### Dependencies | ||
|
||
Mednafen is built upon a number of external libraries which are required in order to have a successful compile. | ||
|
||
The below is assuming that you already have a working install of Homebrew/MacPorts, and a working set of git/autoconf/automake/gcc/make and the Xcode Command Line Tools installed, | ||
if not the following (and other) commands may still be needed: | ||
|
||
``` | ||
Get Xcode Command Line tools: | ||
xcode-select --install | ||
``` | ||
|
||
We have confirmed a successful Mednafen build on macOS Monterey running on both Intel(x86_64) and Apple silicon M1(ARM64) architectures and will provide instructions accordingly. | ||
|
||
For a native Intel(x86_64) build we will use "Homebrew" to pull in the needed Mednafen dependencies: | ||
``` | ||
brew install pkg-config gettext sdl2 libsndfile jack lzo zstd | ||
``` | ||
|
||
For a native Apple silicon M1(ARM64) build we will have to use "MacPorts" in order to get the correct Mednafen dependencies to build: | ||
``` | ||
sudo port -N install pkgconfig clang-14 libiconv libsdl2 libcdio gettext libsndfile libmpcdec zlib | ||
``` | ||
|
||
### Compilation Commands | ||
|
||
Mednafen's build process makes use of 'configure' in order to set up environment-specific options in preparation | ||
for the compile; the below instructions to build Mednafen will attempt to use all of your machine's threads when compiling as the compilation process can take up quite some time, the procedure is as follows : | ||
|
||
``` | ||
./configure --enable-ss | ||
make -j -j `sysctl -n hw.logicalcpu` | ||
``` | ||
|
||
At this point, the Mednafen binary can be found in the mednafen/src/ folder; you may manually copy/move it | ||
from there, or use the prescribed: | ||
``` | ||
sudo make install | ||
``` | ||
|
||
## Further Mednafen documentation: | ||
|
||
Mednafen has quite a few options that can affect the experience, luckily the Mednafen documentation site has quite a few pages of resources that live here: | ||
[https://mednafen.github.io/documentation/) |