10-18-2015, 07:28 AM
(This post was last modified: 08-30-2020, 11:39 AM by MacUser.
Edit Reason: Update
)
**August 2020 Update**
A 64-bit native build is in testing here https://forums.pcsx2.net/Thread-Native-M...ting-Build
**Updated October 2019**
Well, it was fun while it lasted. With the release of macOS 10.15 Catalina, 32bit apps will no longer run. Wineskin is 32bit, as is PCSX2, so they don’t work anymore. The guide below will only work for 10.14 Mojave or earlier.
Looking to the future, some parts of PCSX2 are already 64bit, but the recompiler and some plugins still need to be upgraded to 64bit. Also, PCSX2 will need to start on a Vulcan driver. If that happens, it should be possible to compile for macOS using MoltenVK or Gfx-portability. (We can dream about a Metal port, but that is highly unlikely unless a Metal expert joins the development team....)
**Updated 14th October 2017**
***macOS High Sierra has been released, and of course this introduced an issue with Wineskin. Luckily, there is an easy fix. In the Set Screen Options section of Wineskin, in addition to selecting Use Mac Driver, you should also de-select Auto-Detect GPU. PCSX2 will now open and run correctly***
****Notice - The DirectX9 renderer for GSDX has ceased development and been removed from future developer builds. As the DX10, DX11 and OGL renderers do not yet work in Wine, the last build that will work is 1.5.0 v.512.*****
****Notice - The last Wineskin engine to work is WS9Wine 1.9.11*****
There has been a lot of developments and improvements since ConsoleEmu's first post. The guide in his thread is outdated and just causes confusion for people wanting to get PCSX2 up and running on OS X.
The purpose of this post is firstly to help get new users started, and then to show how to keep the app updated. PCSX2-CE uses a Wineskin wrapper around the PC version of PCSX2, and both need to be kept updated.
You will need to download the following:
Wineskin Winery: used to keep the Wineskin wrapper updated. Get it here.
PCSX2: The last build of PCSX2 that works with vcrun2017 is 1.5.0 v512. The last build to work without vcrun2017 is 1.3.1 v1415. If you have issues installing vcrun2015/2017 then try this version.
PCSX2-CE: The wrapper first made by ConsoleEmu. Get v 1.2.1 from his site here.
Wineskin Winery:
This is the app where you download updates to the wrapper and the engine for Wineskin. Open it up and check for updates. Update to the latest wrapper, and download the WS9Wine 1.9.11 engine. (Newer builds don't work as of this post).
PCSX2:
Download and decompress. (The folder will have the build number, it's best to keep this as it is for future reference).
1: Install your BIOS: create a folder inside called "bios" and copy your PS2 BIOS into it. If you don't have your BIOS handy, search this forum or Google it. (Please do not post questions about BIOS here, it's off-topic and answered better elsewhere)
PCSX2-CE:
Download and decompress. You will get a folder containing the app, a winetricks command, and the licensing docs (also a readme, but this post is more relevant). There is also a bios folder that is an alias to the one contained in the wrapper. Ignore this alias, since we are going to delete the folder it points to.
1: Copy the new PCSX2 build to the wrapper:
Step A: Right-click on the PCSX2-CE app and select "Show Package Contents". Go to drive_c and Program files to see the old PCSX2 folder.
Step B: Copy the new PCSX2 folder into Program Files (delete the old one while you are at it)
2: Update the wrapper and engine:
Step A: Open up the Wineskin app contained in the package (you should have seen it earlier when you did 1 above)
Step B: Select Advanced, then Tools.
Step C: Select Update Wrapper (it will probably quit when it's finished, open again for the next step).
Step D: Select Change Engine Used, choose WS9Wine1.9.11 and wait for it to finish.
3: Redirect the wrapper to run the new version of PCSX2:
Under the Configuration tab, reassign which .exe file is run by clicking the Browse button at the top. Choose the new PCSX2.exe
4: Install d3dx9_36 and vcrun2017:
Again open the wineskin app, select Advanced and Tools, then Winetricks. On the bottom left click Update Winetricks.
Step A: Expand the dlls list and scroll down to d3dx9_36. Select and click Run. Allow the script to compete. (This will take a long time. Wait for it to say it's finished).
Step B: Do the same for msxml3. (This is required before you can install vcrun2017).
Step C: Do the same for vcrun2017.
*Note: In order to see what has been successfully installed in the package, click the gear/option button and select "show installed" column.
5: Ensure Mac Driver is selected:
Again in the Wineskin App, select Set Screen Options. Ensure that Use Mac Driver Instead of X11 is selected. Also ensure that Auto-detect GPU Info is De-selected.
You are now ready to run the PCSX2-CE app.
First time run:
When you run it for the first time, a setup wizard will run. You need to choose your language, bios, and plugin settings.
- Configure the SPU2-X plugin. You need to change XAudio2 to Portaudio. (Wine will support XAudio in the future, but as of posting Portaudio is still required).
- Configure the CDVD, USB, FW and Dev9 plugins all as Null.
Note for updating:
- When you download a new build of PCSX2, don't forget to copy over the bios, inis and memcard folders. (Always press the alt key, since OS X tends to just copy over an alias otherwise).
You should have PCSX2 up and running at this stage. If you have any problems or issues with the above steps, please post here. Also, if it works for you let us know too.
I hope this post helps new users get started, and also how to keep themselves updated.
A 64-bit native build is in testing here https://forums.pcsx2.net/Thread-Native-M...ting-Build
**Updated October 2019**
Well, it was fun while it lasted. With the release of macOS 10.15 Catalina, 32bit apps will no longer run. Wineskin is 32bit, as is PCSX2, so they don’t work anymore. The guide below will only work for 10.14 Mojave or earlier.
Looking to the future, some parts of PCSX2 are already 64bit, but the recompiler and some plugins still need to be upgraded to 64bit. Also, PCSX2 will need to start on a Vulcan driver. If that happens, it should be possible to compile for macOS using MoltenVK or Gfx-portability. (We can dream about a Metal port, but that is highly unlikely unless a Metal expert joins the development team....)
**Updated 14th October 2017**
***macOS High Sierra has been released, and of course this introduced an issue with Wineskin. Luckily, there is an easy fix. In the Set Screen Options section of Wineskin, in addition to selecting Use Mac Driver, you should also de-select Auto-Detect GPU. PCSX2 will now open and run correctly***
****Notice - The DirectX9 renderer for GSDX has ceased development and been removed from future developer builds. As the DX10, DX11 and OGL renderers do not yet work in Wine, the last build that will work is 1.5.0 v.512.*****
****Notice - The last Wineskin engine to work is WS9Wine 1.9.11*****
There has been a lot of developments and improvements since ConsoleEmu's first post. The guide in his thread is outdated and just causes confusion for people wanting to get PCSX2 up and running on OS X.
The purpose of this post is firstly to help get new users started, and then to show how to keep the app updated. PCSX2-CE uses a Wineskin wrapper around the PC version of PCSX2, and both need to be kept updated.
You will need to download the following:
Wineskin Winery: used to keep the Wineskin wrapper updated. Get it here.
PCSX2: The last build of PCSX2 that works with vcrun2017 is 1.5.0 v512. The last build to work without vcrun2017 is 1.3.1 v1415. If you have issues installing vcrun2015/2017 then try this version.
PCSX2-CE: The wrapper first made by ConsoleEmu. Get v 1.2.1 from his site here.
Wineskin Winery:
This is the app where you download updates to the wrapper and the engine for Wineskin. Open it up and check for updates. Update to the latest wrapper, and download the WS9Wine 1.9.11 engine. (Newer builds don't work as of this post).
PCSX2:
Download and decompress. (The folder will have the build number, it's best to keep this as it is for future reference).
1: Install your BIOS: create a folder inside called "bios" and copy your PS2 BIOS into it. If you don't have your BIOS handy, search this forum or Google it. (Please do not post questions about BIOS here, it's off-topic and answered better elsewhere)
PCSX2-CE:
Download and decompress. You will get a folder containing the app, a winetricks command, and the licensing docs (also a readme, but this post is more relevant). There is also a bios folder that is an alias to the one contained in the wrapper. Ignore this alias, since we are going to delete the folder it points to.
1: Copy the new PCSX2 build to the wrapper:
Step A: Right-click on the PCSX2-CE app and select "Show Package Contents". Go to drive_c and Program files to see the old PCSX2 folder.
Step B: Copy the new PCSX2 folder into Program Files (delete the old one while you are at it)
2: Update the wrapper and engine:
Step A: Open up the Wineskin app contained in the package (you should have seen it earlier when you did 1 above)
Step B: Select Advanced, then Tools.
Step C: Select Update Wrapper (it will probably quit when it's finished, open again for the next step).
Step D: Select Change Engine Used, choose WS9Wine1.9.11 and wait for it to finish.
3: Redirect the wrapper to run the new version of PCSX2:
Under the Configuration tab, reassign which .exe file is run by clicking the Browse button at the top. Choose the new PCSX2.exe
4: Install d3dx9_36 and vcrun2017:
Again open the wineskin app, select Advanced and Tools, then Winetricks. On the bottom left click Update Winetricks.
Step A: Expand the dlls list and scroll down to d3dx9_36. Select and click Run. Allow the script to compete. (This will take a long time. Wait for it to say it's finished).
Step B: Do the same for msxml3. (This is required before you can install vcrun2017).
Step C: Do the same for vcrun2017.
*Note: In order to see what has been successfully installed in the package, click the gear/option button and select "show installed" column.
5: Ensure Mac Driver is selected:
Again in the Wineskin App, select Set Screen Options. Ensure that Use Mac Driver Instead of X11 is selected. Also ensure that Auto-detect GPU Info is De-selected.
You are now ready to run the PCSX2-CE app.
First time run:
When you run it for the first time, a setup wizard will run. You need to choose your language, bios, and plugin settings.
- Configure the SPU2-X plugin. You need to change XAudio2 to Portaudio. (Wine will support XAudio in the future, but as of posting Portaudio is still required).
- Configure the CDVD, USB, FW and Dev9 plugins all as Null.
Note for updating:
- When you download a new build of PCSX2, don't forget to copy over the bios, inis and memcard folders. (Always press the alt key, since OS X tends to just copy over an alias otherwise).
You should have PCSX2 up and running at this stage. If you have any problems or issues with the above steps, please post here. Also, if it works for you let us know too.
I hope this post helps new users get started, and also how to keep themselves updated.