let’s get you set up with osu! on your macOS-powered device!¶
Community-developed osu! Wineskins are the best way to play osu-stable on your Mac.
If creating a thread, put macOS and Wineskin in your thread title.
Our commmunity support members are volunteers, ranging from osu! support team members to people helping out in their free time. A response may take upwards to a week, although generally you should receive one within a day or two.
If you prefer, other options are available, including the official (but abandoned) Wineskin from ppy, or other alternatives (that won’t let you play ranked). These docs won’t cover these options in great detail but they’re pretty straightforward to get started with.
This information is supplied by volunteers in good faith. However, we are not responsible if it doesn’t work, your computer sets on fire, or you start the next thermonuclear war. We do our best to make sure the information here is safe for you, your osu! account and your computer, but you proceed at your own risk.
Don’t play osu! in maths class.
- Common issues
- Troubleshooting Basics
- Performance Troubleshooting
- Apple Silicon / Big Sur issues
- .NET runtime issues
- Command prompt window showing before osu! crashes
- osu! has graphical glitches, or isn’t rendering icons/CJK fonts properly
- osu! cannot be opened because the developer cannot be verified
- osu! doesn’t run on macOS Monterey
- Startup issues
- Wineskin.app doesn’t open, even if osu! does / exec[number].bat problem
- osu! was unable to obtain a graphics context
- osu! captures my monitor/my second monitor is black
- Performance issues with high-polling rate mice
- Enabling Retina Mode
- Mouse/trackpad input feels unstable
- osu! won’t close
- osu! is being detected as malware
- Pointing osu!macOS Agent to your osu! install location
- osu!macOS Agent crashes on startup
- Using the macOS Terminal to repair Wineskins
- Discord Rich Presence (32-bit Wineskins / non-WS11 WineskinServer)
- Discord Rich Presence (64-bit Wineskins / WS-11 WineskinServer)
- Discord Rich Presence (Discussion)