Installing
This description tries to demonstrate of installing Xep128 "by hand" from some binary build. If you want to build Xep128 yourself, from source, then you need to read this: Compilation
Xep128 in its current state does not have any installer. This can be treated as both of good and bad - matter of taste. Some people don't like stuffs needing installation which then causes changes in their systems. Others may complain that it's harder to make something work without an installer, as they should do all the steps at their own then.
Currently, for an "install-less" solution, all supported architectures means that:
- you need to get the executable file (for Windows, it's an exe file)
- the run-time dependency of SDL2 (for Windows, it's the DLL of SDL2)
- the ROM image file of Xep128 (without this, the emulator can be started - which is not true for the above requirements - however it will exit then and won't work, of course)
All supported architectures by Xep128 needs the ROM images. You can simply download from here for example:
http://xep128.lgb.hu/files/combined.rom
If you have a .ZIP file for Xep128 it probably contains it. For a simple setup, you can put that combined.rom file into the same directory where the executable is.
There is not so much "official" build for OSX yet, but you can try this: http://xep128.lgb.hu/files/xep128.osx
This single file is the executable file itself. The "extension" osx in the name does not mean anything, it's just my taste, you can even rename the file to simple "xep128".
SDL2 dependency is a bit tricky. Since I don't have any access of OSX (especially not with GUI), I couldn't try. However the best chance can be using "Homebrew". It's a package manager for OSX, you can read about it here: http://brew.sh/
Basically you need a terminal window, and you can try this:
brew update
If you get an error message about bad command (or something) "brew", you need to install Homebrew first. For that, you can visit their page at http://brew.sh/ but according to that, it's simple enough to copy and paste this command into a command prompt of a terminal window on your Mac:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
For sure, if you need to install Homebrew at this step, you need the update part after this again as the first was not successful (without Homebrew installed yet):
brew update
Now, if any of the way you have working and updated Homebrew, you can install SDL2 through it, with this command:
brew install sdl2
Xep128 needs at least SDL 2.0.4 which is the newest version of SDL (at the time when I write this). Without the "brew update" it's possible that brew would install an older version of SDL. Actually, you can read the output of the last command to find it's something about SDL "2.0.4" to be sure.
Now, you need that xep128.osx, which is an executable binary (not an installer, or something like that!), capable of running - in theory at least - on 64 bits x86 hardware. What you need, is to put this file into a directory where you would like, also the combined.rom should be put "next to" it (into the same directory I mean). Then, at the command prompt you need to navigate (use the "cd" command to change directory) to that directory, and you can "say" this:
chmod +x xep128.osx
./xep128.osx
Of course if you renamed xep128.osx, you should use that file name instead. The second command will actually start Xep128, all the previous steps need to be done only once as the part of the "initial preparation work". Of course if I only new OSX for real, I would be able to tell how to make Xep128 then to be included in the GUI in a way that you don't need command prompt to start it all the time. Unfortunately, I don't know OSX, neither I have it ...
