How to use SSP on macOS

This tutorial will go over the process of using Homebrew and Wineskin-Server (aka Kegworks) to install SSP on macOS versions 12 - 14 (may also apply to 10.15 - 11)

---

1. Download Homebrew by copying the line of code on the website into a terminal window and pressing "enter". You may be prompted to enter your password at some point during the installation.

---

2. Download Wineskin-Server using the same method to download Homebrew; copy the line of code under "Install the new version", paste it into the terminal window and press "enter". Homebrew should install Wineskin-server successfully after a few minutes. You may also be prompted to enter your password for this installation as well.

• Note: Wineskin-Server has ceased development. The team that made it have since moved on to a similar project called Kegworks. The steps in this guide can be used with the newer software, as they both function very similarly.

---

3. Open the Wineskin Winery app (in the "Applications" folder). Update the wrapper if updates are available. Click on the + icon to add an engine, choosing either "WS11Wine64Bit9.3" or "WS12WineCX64Bit23.7.1-2". Once the engine of your choice has been installed, create a wrapper by clicking on the "Create New Blank Wrapper" button. The process of creating a new wrapper will take a few minutes to complete.

---

4. Once the wrapper has been created, click on the "View wrapper in Finder" option and run the wrapper application. Before you can install the application you will need to download a Japanese font.

• Click on the "Winetricks" option in the Wineskin window. On the next window, click on the "fonts" dropdown menu, scroll down to the "fakejapanese" font, select it by clicking on its checkbox, then click "run" and "yes" on the following prompt. This is the font that will be used by japanese ghosts, including the default ghost of SSP. Once the process is finished, click on the "Close" button to return to the main menu.

---

5. Download SSP by clicking the "Complete Install Package" on the left. It should be the button closest to the top of the page.

---

6. Go back to the Wineskin window and click "Install Software". On the next window click on the "Choose Setup Executable" button. Locate the folder the SSP setup downloaded to and select it.

• After a few minutes, a setup window should appear. Choose a folder to install SSP. I would recommend creating a new folder in the Program Files folder of the C:\ drive, as Wineskin-Server recommends new software be installed in the C:\ drive. This will take a few more to complete.

---

7. Go back to the main menu and select "Advanced Options". From here you will need specify the file path for the SSP executable. Click "Browse" and select SSP.exe in the newly created folder.

• Once you are done, click "Test Run" to start the program. The default ghost should be on your screen (for reference:)

---

8. You can now begin installing Ghosts. For beginner users, I recommend installing SSP Angel, it contains helpful tips about the many functions of SSP as well as a general reference for how to use the program.

• Go to the GitHub page through the download link and click on the .nar file at the bottom of the page. Once it's done installing, you can simply drag and drop the file onto the ghost you have open and switch to them by right-clicking the ghost, going to the "Change Ghost" option, and clicking on "SSP Angel" in the expanded list. This step can be repeated with any ghost, shell, balloon, or plugin you want SSP to install.

• Once you have the ghost installed, close the program to complete the test. Save your Wineskin wrapper to the dock by searching for it in the finder and dragging it to the dock. This wrapper can be used to run SSP at any time.

You can now use SSP on your Mac!

Notes:

• Baseware features should work (updates, hotkeys, collisions, etc.) but ghost-specific features may not (window detection, saori/plugin-specific functions, os information) If a ghost has these functions specified somewhere (ex: in the readme), you may need to turn these off yourself.