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! won’t close

This article is applicable to the following wrappers:
• slc’s Wineskin for macOS 10.14 Mojave and earlier
• Technocoder’s Wineskin with macOS Catalina 10.15 support
• Technocoder’s unofficial Wineskin for macOS 10.14 Mojave and earlier

Behaviour

osu! is stuck in an update loop, it’s hung and won’t close, or you suspect some leftover processes are still running on your system.

Cause

On first run, osu! will try to update, but due to incompatibilities between the update server and Wine, it will continually restart the application.

Alternatively, osu! or Wine has either crashed, hung, or closed without killing all processes.

Resolution

You can kill all Wineskin processes associated with your osu! wrapper in Wineskin options.

  1. Locate where osu!.app is installed

  2. Right click on it and select Show Package Contents

  3. You should now see three files/folders: Contents, drive_c and Wineskin. Click Wineskin

  4. A window like the one below should pop up. Click Advanced

../_images/wineskin.png

  1. Click the Tools tab

  2. Under the Utilities heading, select Kill Wineskin Processes

../_images/kill-wineskin-processes.png

  1. Accept the dialog box by clicking Yes

../_images/wineskin-kill-successful.png

  1. Wait for the tool to run. Once it is finished, close Wineskin by clicking the close icon (in the top-left corner) and then clicking Quit

If you are unable to access Wineskin options

You need to go to your Applications/Utilities folder and open Activity Monitor. From there, kill all of the Wine processes.

  1. Type wine into the search bar. You’ll see a number of different wine, wine-preloader and osu-wine processes around.

../_images/activity-monitor-1.png

  1. Click on the Wineserver process (or a random one if that doesn’t exist), then click the Activity Monitor close icon.

  1. You’ll reach a dialog that looks like this. Click Quit to close the application, or click Force Quit if the process is not responding or normal Quit doesn’t work.

../_images/activity-monitor-2.png

Warning

Make sure you don’t have any other Wine processes running in the background (and if you do, differentiate them from osu! before you kill the processes).

  1. You’ll need to repeat steps 2 and 3 for each process (though they may disappear automatically after killing one)


If that didn’t work

If that didn’t work, you should probably restart your computer. Perform basic troubleshooting and ask for help on the osu! forums.