Attention
August 2023 update: osu! Wineskins for macOS, osu!macOS Agent, and this osu!mac documentation website is no longer officially supported or maintained. Official support will no longer be provided by the authors of these respective projects on the osu! forums. You can read more information about this change from Technocoder and aidswidjaja. Thank you for everything.
osu!mac
let’s get you set up with osu! on your macOS-powered device!
Getting started
Community-developed osu! Wineskins are the best way to play osu-stable on your Mac.
Install them using our installation guide
Get started with our new users section
Find fixes to your issue using our knowledge base
Need help?
A small but dedicated volunteer support team is available. Visit us on the macOS Wineskin thread or start your own thread in the Help subforum.
Along with a detailed description of your issue, attach your log files from Troubleshooting Basics in a never-expire pastebin such as paste.gg
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.
Other options
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.
Disclaimers
Warning
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.
Tip
Don’t play osu! in maths class.
Sitemap
- 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)