Guest
home
beatmaps
rankings
community
store
help
forum
  1. Forums
  2. osu!
  3. Development

macOS Updated Wineskin Installation Guide (Rosetta support)

posted
Total Posts
651
Technocoder
419 posts
Joined June 2017
Topic Starter
Technocoder
Read all installation steps before downloading a Wineskin.

This Wineskin is no longer being actively maintained.

Downloads

Latest Wineskin (Intel and Rosetta):
https://mega.nz/file/ZlUxmQpT#P2MNDUmMLKiAWYpCYIqnxIP3HmlR5-_Y1se_elvmuSQ

Outdated Downloads

Rosetta Wineskin:
https://mega.nz/file/ghsiiY5S#yJVytf3tb3Bcu9zMF2lomsASDofKD4whzxE1htAJKBE

Catalina or older:
https://mega.nz/file/54sgCaJB#nzuV4BNcOx7sJ-zx8elWwO9qgQCrHK763mIrTYyozZU

High Sierra or Mojave or older:
Launchpad'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:
Steps
  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: Discord Rich Presence is not available on the Rosetta Wineskin.
Note: These steps are already applied on the latest Wineskins.
Steps
  1. Download bridge.exe from this repository
  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.

Importing beatmaps (osu!macOS Agent)
  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

Importing skins (osu!macOS Agent)
  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

Importing beatmaps (manually)
  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

Importing skins (manually)
  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

Importing beatmaps (directly)
  1. Download a beatmap
  2. Drag the file into the osu! window

Importing skins (directly)
  1. Download a skin
  2. Drag the file into the osu! window

Changes

Rosetta Wineskin changes
Compared to Latest Wineskin
Changes
  1. [27/12] Update Wine engine to 21.0
  2. Add font smoothing (thanks Superuser1958)
  3. Use 32 bit Wine engine

Latest Wineskin changes
Compared to the Catalina Wineskin
Changes
  1. [19/8] Update Wine engine to 21.2.0
  2. [27/12] Update Wine engine to 21.1.0
  3. [15/2] Add font smoothing (thanks Superuser1958)
  4. [1/2] Update engine to WS11WineCX64Bit20.0.2 (thanks @Gcenx)
  5. Add CJK language font mappings
  6. Update engine to WS11WineCX64Bit20.0.0
  7. Code-signed engine allows direct import of files
  8. Preliminary support for Rosetta based execution

Catalina Wineskin changes
Compared to experimental: community/forums/posts/7367239
Note: All of Launchpad's Wineskin's changes are applied as well
Changes
  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

Launchpad's Wineskin changes (summarised)
Compared to 2018 unofficial update: community/forums/topics/682197
Changes
  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
osu! is damaged and can’t be opened. You should move it to the Trash.
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.
How do I import a beatmap pack?
Extract the beatmap pack and then move all the beatmaps into the Downloads (to be automatically imported by osu!macOS Agent) or Songs folder.
How do I switch between windows?
Disable fullscreen mode in osu!'s settings. Alternatively, use the ⌘+Tab hotkey.
How do I fix lag or frame drops?
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
osu! is stuck in an update loop. How do I fix this?
Click on the Other tab in osu!macOS Agent and then click on the Update osu! button.
Are there viruses?
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
Launchpad (previously 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
Last edited by Technocoder , edited 36 times in total.
VeilStar
osu! Alumni
4,773 posts
Joined April 2014
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_
1 post
Joined July 2015
missingling_
I just want to thank you so, SOO MUCH. <3
totzk9
1 post
Joined May 2014
totzk9
Finally! After 5 years of being inactive from osu! now I can play again! Thank you very much!!!!
Mic238
15 posts
Joined June 2016
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
18 posts
Joined March 2018
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)
Darknn
43 posts
Joined December 2016
Darknn
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?
Last edited by Darknn , edited 2 times in total.
Technocoder
419 posts
Joined June 2017
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
1 post
Joined July 2020
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
1 post
Joined June 2016
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?
Technocoder
419 posts
Joined June 2017
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
18 posts
Joined March 2018
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
1 post
Joined June 2020
nohamik
When I click on the troubleshooting tab, I can't click the scan or repair button. The osu! app doesn't show up.
Technocoder
419 posts
Joined June 2017
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
1 post
Joined November 2016
sscoolqaz
So this works beautifully, except it crashes when I search beatmaps or settings
Technocoder
419 posts
Joined June 2017
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
1 post
Joined July 2020
Someon332
Oh my god thanks so much.
I was so worried that osu! wasn't on mac then I find this.
Launchpad
15 posts
Joined February 2016
Launchpad
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
3 posts
Joined June 2019
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
Technocoder
419 posts
Joined June 2017
Topic Starter
Technocoder
miamia0227

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

0
1 / 651