forum

macOS Updated Wineskin Installation Guide (Rosetta support)

posted
Total Posts
271
Topic Starter
Technocoder
Read all installation steps before downloading a Wineskin.

Downloads


Latest Wineskin:
https://mega.nz/file/QkVWAJxb#Fc-SGCNZ9sun_OJVdizErdy2is1aUNbpc3-9GKJkBxM

Outdated Downloads


Catalina or older:
https://mega.nz/file/54sgCaJB#nzuV4BNcOx7sJ-zx8elWwO9qgQCrHK763mIrTYyozZU
High Sierra or Mojave or older:
slc's Wineskin: community/forums/posts/6919344

Installation


Installation steps:
  1. Download one of the Wineskins from the above links
  2. Extract the downloaded zip file
  3. Download osu!macOS Agent
  4. Follow the steps for opening osu!macOS Agent
  5. Select the Troubleshoot tab
  6. Click the Scan button
  7. Click the Repair button
  8. Double click on osu! to open it

Additional steps (Catalina <10.15.4):
If you are on an older version of Catalina you can either update macOS or disable System Integrity Protection.
Note that the command is: csrutil disable.

Transferring data:
  1. Right click your old osu! Wineskin > Show Package Contents
  2. Go to drive_c > osu!
  3. Right click your new osu! Wineskin > Show Package Contents
  4. Go to drive_c > osu!
  5. Copy over folders: Data, Downloads, Screenshots (if present), Skins, Songs
  6. Copy over files: collection.db, osu!.db, osu!.(name).cfg, scores.db, presence.db

Discord Rich Presence:
Note: These steps are already applied on the latest Wineskins.
  1. Download bridge.exe
  2. Right click osu! > Show Package Contents
  3. Go to drive_c > osu!
  4. Drag the bridge.exe file into the osu! folder
  5. Create a new file in the osu! folder named execute.bat
  6. Add these two lines to the execute.bat file:
    start C:\osu!\bridge.exe
    start C:\osu!\osu!.exe -nosplash
  7. Open Wineskin (next to the drive_c folder)
  8. Click Advanced
  9. Change the Windows EXE field to (including the outer quotes):
    "C:\osu!\execute.bat"

For technical information on how the bridge works see the project page: https://github.com/Techno-coder/macOS-wine-bridge

Troubleshooting:
  1. Check the details shown in the Troubleshoot tab
  2. Press the Copy Report button
  3. Paste the report in your reply to this thread

Importing


You are encouraged to either use osu!macOS Agent or manually import. Directly importing files into osu! may cause the window to freeze. If you are using a Wineskin supported for Catalina or older (including High Sierra or Mojave) you must use one of these two methods.

  1. Keep osu!macOS Agent open in the background
  2. Enable Automatically move beatmaps from Downloads
  3. Download a beatmap file
  4. Press F5 while in game to load new beatmaps
  1. Keep osu!macOS Agent open in the background
  2. Enable Automatically move skins from Downloads
  3. Download a skin file
  4. Restart the game
  1. Right click osu! > Show Package Contents
  2. Go to drive_c > osu! > Songs
  3. Drag the beatmap file inside the Songs folder
  4. Remove any non-alphanumeric characters from the file name
  5. Press F5 while in game to load new beatmaps
  1. Right click osu! > Show Package Contents
  2. Go to drive_c > osu! > Skins
  3. Drag the skin file inside the Skins folder
  4. Rename the skin file to skin.zip
  5. Extract the skin.zip file
  6. Delete the skin.zip file
  7. Restart the game
  1. Download a beatmap
  2. Drag the file into the osu! window
  1. Download a skin
  2. Drag the file into the osu! window

Changes


Latest Wineskin changes
Compared to the Catalina Wineskin
  1. Add CJK language font mappings
  2. Update engine to WS11WineCX64Bit20.0.0
  3. Code-signed engine allows direct import of files
  4. Preliminary support for Rosetta based execution

Catalina Wineskin changes
Compared to experimental: community/forums/posts/7367239
Note: All of slc's Wineskin's changes are applied as well
  1. [16/7] Add Discord Rich Presence (after many hours of work!)
  2. Update engine to WineCX19.0.1-1
  3. Remove System Integrity Protection requirement
  4. Fix immediate crash on game launch
  5. Halve Wineskin size

slc's Wineskin changes (summarised)
Compared to 2018 unofficial update: community/forums/topics/682197
  1. Fix large image loading freezes
  2. Use unofficial Wine engine WS9Wine4.0-rc3
  3. Fix opening links in multiplayer
  4. Reduce graphical lag

Other


Frequently asked questions
Follow all the installation steps. The most likely cause for this issue is that the troubleshooter has not been run. If it still does not work, paste the troubleshooting report.
Extract the beatmap pack and then move all the beatmaps into the Downloads (to be automatically imported by osu!macOS Agent) or Songs folder.
Disable fullscreen mode in osu!'s settings. Alternatively, use the ⌘+Tab hotkey.
There isn't a concrete set of steps to resolve this. You can try disabling some graphical options in osu! such as shaders or using a less performance intensive skin. However, do not enable Compatibility Mode as that will cause your game to crash.

You can try enabling VSync in the osu! settings in case your GPU or CPU is throttling.

You can also try enabling Retina Mode if you are using a Retina display however that may distort your game resolution. To do so:
  1. Right click osu! > Show Package Contents
  2. Open Wineskin > Set Screen Options
  3. Check Retina Mode
  4. Close Wineskin
Click on the Other tab in osu!macOS Agent and then click on the Update osu! button.
No. For an explanation about the false positives see this Wineskin issue: https://github.com/Gcenx/WineskinServer/issues/48

Other macOS resources
osu!mac - osu! on macOS documentation site (maintained by aidswidjaja)

Outdated macOS resources
[Guide] Fixing Mac Issues: community/forums/topics/679205
Unofficial Updated OSX osu! Wineskin Package: community/forums/topics/682197

Special thanks
Death and Dntm8kmeeatu for their amazing work in helping users with their issues
peppy for creating the original Wineskin
slc for creating an updated Wineskin
Gcenx for maintaining the Wineskin project and Wine engines
aidswidjaja for maintaining osu!mac and assisting users with their issues
VeilStar
I don't even use macOS but I would like to take a moment to thank you for all your work on macOS compatibility and helping macOS users out when they run into issues. Fantastic job!
missingling_
I just want to thank you so, SOO MUCH. <3
totzk9
Finally! After 5 years of being inactive from osu! now I can play again! Thank you very much!!!!
Mic238
soz it's a new 64 bit wrapper of wineskin 11.

I feel like osu Lazer is getting better so I just discontinue my wrapper update

it doesn't run as smooth as native Lazer, input delay is noticeable, probably need to change some settings like raw input and frame rate

But always good to have a option to go for ranking and pp :>) Great job!
SPM37
BTW to anyone who dosent want to restart the game when importing skins you just need to either grab the osk file into the osu! window or use osuMACOS agent and the press Control+ALT+Shift+S. or Command+shift+alt+S

However the F5 is somehow nessesary because putting the osk file directly into the osu!.app with this newer version of wine will neglect the file (im not sure if this has been fixed or not)
Oblivous
For anyone wondering, this does work on Catalina! And it also works on older versions, it just adds Catalina support. Just to make it work, you have to follow the steps as told on the top of this forum, but anyways one question still bugs me,

Does this work with the compatibility mode on? And when I tested it it didn't, but is there still a way to make it work?
Topic Starter
Technocoder

Oblivous wrote:

I have tested it and it does work with macOS Catalina, but one question still bugs me,

Does this work with the compatibility mode on? And when I tested it it didn't, but is there still a way to make it work?
No, it doesn't and I don't know of a way that makes compatibility mode work.
TTTechnoPro
Thank you for all your hard work!

Is there a fix to Japanese Kanji in song titles showing up as empty squares? I don't have this issue on osu on my PC. Please let me know!
kyujenu18
When it was verifying osu, it had a pop-up that said it was damaged and cannot be opened. What should I do in this situation?
Topic Starter
Technocoder

TTTechnoPro wrote:

Thank you for all your hard work!

Is there a fix to Japanese Kanji in song titles showing up as empty squares? I don't have this issue on osu on my PC. Please let me know!
Peppy mentions in this post (community/forums/posts/7140978) that font support can probably be added back with fake font mappings. I haven't had the chance to do this yet.

kyujenu18 wrote:

When it was verifying osu, it had a pop-up that said it was damaged and cannot be opened. What should I do in this situation?
Please follow the installation steps carefully. If it still doesn't work after doing so, please follow the steps under the Troubleshooting section.
SPM37
Well i got around a a problem with sic´s wraper cause it gets stuck in an update loop (i have not tried the fix on the old wrapper help post)
nohamik
When I click on the troubleshooting tab, I can't click the scan or repair button. The osu! app doesn't show up.
Topic Starter
Technocoder

nohamik wrote:

When I click on the troubleshooting tab, I can't click the scan or repair button. The osu! app doesn't show up.
Did you select the osu!.app first? There's a select button on the General tab.
sscoolqaz
So this works beautifully, except it crashes when I search beatmaps or settings
Topic Starter
Technocoder

sscoolqaz wrote:

So this works beautifully, except it crashes when I search beatmaps or settings
Which Wineskin and what keyboard layout are you using? If you aren't using an English layout (such as US) then switch to one.
Someon332
Oh my god thanks so much.
I was so worried that osu! wasn't on mac then I find this.
slc
hey, as someone who has previously "maintained" a wineskin for osu! on mac, this is pretty amazing considering that you made an entire agent program for this! thank you
miamia0227
Hi, I'm having some trouble downloading osu beatmaps.
I finally updated my macOS to Catalina recently and did all the steps to update osu to Catalina supported one.
Everything is working perfectly, except I can't open the osu beatmaps and add new songs.
Whenever I try to open the beat maps I downloaded on osu, it says "There's no Windows program configured to open this type of file".(I will attach a screenshot below.)
The file type I download from the official osu website is in filename.osz format.
Please let me know if there's a solution to this! Thank you :)
(English is not my first language, sorry if there are grammatical mistakes and all those! >_<)

Screen shot vvv
https://paste.pics/9QDYW
Topic Starter
Technocoder

miamia0227 wrote:

Hi, I'm having some trouble downloading osu beatmaps.
I finally updated my macOS to Catalina recently and did all the steps to update osu to Catalina supported one.
Everything is working perfectly, except I can't open the osu beatmaps and add new songs.
Whenever I try to open the beat maps I downloaded on osu, it says "There's no Windows program configured to open this type of file".(I will attach a screenshot below.)
The file type I download from the official osu website is in filename.osz format.
Please let me know if there's a solution to this! Thank you :)
(English is not my first language, sorry if there are grammatical mistakes and all those! >_<)

Screen shot vvv
https://paste.pics/9QDYW
Please see the steps in the post on Importing beatmaps.
show more
Please sign in to reply.

New reply