Read all installation steps before downloading a Wineskin.
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:- Download one of the Wineskins from the above links
- Extract the downloaded zip file
- Download osu!macOS Agent
- Follow the steps for opening osu!macOS Agent
- Select the Troubleshoot tab
- Click the Scan button
- Click the Repair button
- Double click on osu! to open it
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
- Right click your old osu! Wineskin > Show Package Contents
- Go to drive_c > osu!
- Right click your new osu! Wineskin > Show Package Contents
- Go to drive_c > osu!
- Copy over folders: Data, Downloads, Screenshots (if present), Skins, Songs
- 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
- Download bridge.exe from this repository
- Right click osu! > Show Package Contents
- Go to drive_c > osu!
- Drag the bridge.exe file into the osu! folder
- Create a new file in the osu! folder named execute.bat
- Add these two lines to the execute.bat file:
start C:\osu!\bridge.exe start C:\osu!\osu!.exe -nosplash
- Open Wineskin (next to the drive_c folder)
- Click Advanced
- Change the Windows EXE field to (including the outer quotes):
"C:\osu!\execute.bat"
Troubleshooting:
- Check the details shown in the Troubleshoot tab
- Press the Copy Report button
- 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)
- Keep osu!macOS Agent open in the background
- Enable Automatically move beatmaps from Downloads
- Download a beatmap file
- Press F5 while in game to load new beatmaps
Importing skins (osu!macOS Agent)
- Keep osu!macOS Agent open in the background
- Enable Automatically move skins from Downloads
- Download a skin file
- Restart the game
Importing beatmaps (manually)
- Right click osu! > Show Package Contents
- Go to drive_c > osu! > Songs
- Drag the beatmap file inside the Songs folder
- Remove any non-alphanumeric characters from the file name
- Press F5 while in game to load new beatmaps
Importing skins (manually)
- Right click osu! > Show Package Contents
- Go to drive_c > osu! > Skins
- Drag the skin file inside the Skins folder
- Rename the skin file to skin.zip
- Extract the skin.zip file
- Delete the skin.zip file
- Restart the game
Importing beatmaps (directly)
- Download a beatmap
- Drag the file into the osu! window
Importing skins (directly)
- Download a skin
- Drag the file into the osu! window
Changes
Rosetta Wineskin changesCompared to Latest Wineskin
Changes
- [27/12] Update Wine engine to 21.0
- Add font smoothing (thanks Superuser1958)
- Use 32 bit Wine engine
Latest Wineskin changes
Compared to the Catalina Wineskin
Changes
- [19/8] Update Wine engine to 21.2.0
- [27/12] Update Wine engine to 21.1.0
- [15/2] Add font smoothing (thanks Superuser1958)
- [1/2] Update engine to WS11WineCX64Bit20.0.2 (thanks @Gcenx)
- Add CJK language font mappings
- Update engine to WS11WineCX64Bit20.0.0
- Code-signed engine allows direct import of files
- 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
- [16/7] Add Discord Rich Presence (after many hours of work!)
- Update engine to WineCX19.0.1-1
- Remove System Integrity Protection requirement
- Fix immediate crash on game launch
- Halve Wineskin size
Launchpad's Wineskin changes (summarised)
Compared to 2018 unofficial update: community/forums/topics/682197
Changes
- Fix large image loading freezes
- Use unofficial Wine engine WS9Wine4.0-rc3
- Fix opening links in multiplayer
- Reduce graphical lag
Other
Frequently asked questionsosu! 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:
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:
- Right click osu! > Show Package Contents
- Open Wineskin > Set Screen Options
- Check Retina Mode
- 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