[Note: I have created a Wineskin package that fixes many of the issues listed here. You can find it here: https://osu.ppy.sh/community/forums/topics/682197]
[Note: I have created a troubleshooting tool that automatically fixes some of these issues. You can find it here: https://osu.ppy.sh/community/forums/topics/1036678]

Over the course of playing osu! on OSX I've experienced multiple issues and found ways to fix them.
This is assuming you are using the Wineskin wrapper to run osu! on OSX.

Miscellaneous Information

Wineskin can be found right clicking the osu! icon and clicking "Show package contents".
osu! folder can be found by going to Show package contents > drive_c > osu!

Before you do anything

I highly recommend you back up the entire osu! folder. Some of these steps initially made my game crash or stuck in an update loop. In the event that happens you may have to start from scratch and redownload the Wineskin wrapper from the OSX osu! tumblr (found here: http://osuosx.tumblr.com)

Before you fix anything

If you haven't already, start by updating the Wineskin wrapper. The wrapper is rather outdated and probably won't fix anything but it can't really hurt. To update the wrapper:
The wrapper version (shown near the bottom of the window above "Install Software") should now be 2.6.2 or higher. Don't close the Wineskin window yet; we'll use it later.

Next you'll need to update the Wine engine. I highly recommend you do this regardless of whether you are facing issues or not. The engine included with the osu! Wineskin is incredibly outdated (In software development, 2 - 3 years is a very long time). The engine is essentially what runs osu! so this is one of the more volatile steps. Updating the engine provided me with a significant performance boost, fixed many of the issues I was having previously, and it allowed my game to run under OSX driver mode (more on that later).

To update the engine we'll need a way to download engines. Download Wineskin Winery: http://wineskin.urgesoftware.com/tiki-index.php?page=Downloads
Now open Wineskin Winery and follow these steps:
Now that the latest engine is installed we'll need to change the engine used in the Wineskin wrapper. Go back to Wineskin and follow these steps:
Now you can go onto the other steps!

Help! My game won't open and/or opens this program called XQuartz!

You must update the wine engine for this to work properly.
For some reason WineskinX11 (the XQuartz included with Wineskin) won't start osu! properly. You'll notice this if you get an error "Invalid Drawable" in the logs. The way that this has been fixed is to install XQuartz on your system and use this XQuartz instead of the default. I have a better alternative:
Now if you start osu! you will hopefully notice less input lag and frame drops. At least that's what happened for me. Additionally, you won't need to wait for XQuartz to start up anymore.

Reverting to an older Wine version

See Before you do anything on downloading Wineskin Winery. When clicking “Add Engine” be sure to select the Wine version that you wish to install. Then click “Download and Install”.

After that follow the rest of the steps in Before you do anything but when clicking “Change Engine Used” select the engine that you wish to use.

Help! My game won't start after updating to High Sierra!

High Sierra interferes with a few of Wineskin's startup processes. Here's how to fix it:

osu! runs really slow and/or the Song Setup window does not show

If your computer is rather old or you're running macOS Mojave you may experience problems with various elements of the Wineskin including performance or UI elements. In this case, you may wish to reenable XQuartz as the graphical engine for the Wineskin. Follow the steps for Help! My game won't open and/or opens this program called XQuartz! but in reverse. Consider this as a last resort if nothing else works. You will also need to download and install XQuartz (https://www.xquartz.org).

osu! or Wineskin will not open!

Sometimes, the quarantine attribute will still be stuck on the Wineskin wrapper. The quarantine attribute will prevent osu! from writing files and performing all the actions that it needs to. Here is how to disable the quarantine attribute.
Thanks to Bedrock for the command

Help! osu! is stuck loading a beatmap!

For unknown reasons, osu! on OSX does not handle large image files. Delete the background image of the beatmap (or rename it) to fix this.

A beatmap just won't import!

Make sure the .osz file doesn't have any strange characters in the filename. Rename the .osz file and remove any non alphanumeric characters (dashes should be fine).

Example:
Before: 153776 yuikonnu & ayaponzu* - Super Nuko World.osz
After: 153776 yuikonnu ayaponzu - Super Nuko World.osz

The updater keeps downloading discord-rpc.dll!

Unfortunately I don't know why this happens but it's a simple fix:

Steps

1. Download a copy of the working discord-rpc.dll here: https://drive.google.com/file/d/1x17jM9fnbyfbGM9vY6H54UXWECSILwlY/view?usp=sharing
2. Move the file into your osu! folder

See the section: Discord Rich Presence doesn't work!

osu! crashes after a key is pressed!

Keyboard layouts other than the default US layout may not work with osu!. This is especially true for keyboard layouts that produce a character other than those part of the ASCII format, such as Japanese, Chinese or Korean. Set your keyboard layout to the US layout to fix this.

There isn't a menu bar in edit mode!

The menu bar is still there, just that it's completely black. You'll notice a strip of black on top of "compose design timing song setup". Click on that strip and then the menus will display.

Oh no! I'm stuck in an update loop and/or I'm crashing on startup!

Unfortunately for you, there aren't a concrete set of steps to resolve this. However, there are several things you can try but at worst you'll have to reinstall the Wineskin package.
If you haven't already make sure to do a data backup. The steps to do this are listed under How to do a data backup

How to do a data backup

This backup saves all of your osu! data such as scores, replays and songs. You may want to do this if you are crashing on startup or stuck in an update loop.

How to restore a data backup

If you are experiencing issues you may wish to delete osu!.(name).cfg as well. (Note: This will reset your in game settings and you will be required to login again)

Updating the osu! executable

At times, the executable provided in a wrapper may be outdated and won’t update for some reason. In this case, you’ll need to update the executable manually:

Help! I'm running a dual monitor setup and osu! blacks out my other screen!

This will only work if you have enabled "Use Mac Driver".
This is due to Wine using a function similar to a "Game Mode" but has the side effect of blacking out everything except the game. For the technical folk out there you can read up on it here: https://developer.apple.com/library/content/documentation/GraphicsImaging/Conceptual/QuartzDisplayServicesConceptual/Articles/DisplayCapture.html
Here's how to fix it:

Help! Clicking on a different window automatically minimises osu!

Admittedly I have no idea why it does this but there is a simple fix:

There's noticeable audio latency

This is especially prevalent if you have programs like Boom or Boom2 installed. Boom post processes your audio which increases the quality but also increases the audio latency. You can fix this without quitting Boom.
Now audio will be routed directly to your audio device instead of through Boom.

Discord Rich Presence doesn't work!

See the section Discord Rich Presence under my Wineskin thread: community/forums/topics/1106057.

Communication between processes is different in different operating systems. Discord on macOS expects to receive information from a macOS game. Discord on osu! expects to send information to a Discord on a Windows machine. You'll need to replace the discord-rpc.dll file to allow communication properly (Thanks to slc for pointing out this alternative file):

Steps

1. Download xnu-discord-rpc.dll from this guy here: https://github.com/goeo-/discord-rpc/releases (If you have a Github account consider starring the fork)
2. Navigate to the osu! folder (Right click osu! > Show Package Contents > drive_c > osu!)
3. Delete the existing discord-rpc.dll file
4. Drag the xnu-discord-rpc.dll file into it and rename it to discord-rpc.dll

The game lags when I select a Beatmap and I can't change Visual Settings at the bottom

Follow the steps for Help! My game won't open and/or opens this program called XQuartz!

The mouse cursor is showing on top of the osu! cursor

Follow the steps for Help! I'm running a dual monitor setup and osu! blacks out my other screen!.
If that doesn't work press F9 (to show osu! users) and then press ESC.

Random Author Notes

The above troubleshooting steps were found after I was pissed significantly miffed that I couldn't read a mapping tutorial on my second monitor when osu! was open.

The "Before you fixed anything" part helped me a lot!

I updated from the 2015 stable release (since fallback score submissions will soon be disabled)

It works for now, thanks a lot!

I have a Mac and the problem of the month for osu for me is that when I start it up, the screen is just white. I can still hear the sound but I can't see anything

My osu! can't stop download some kind of discord-rpc.dll_patch

Can someone send me a copy?


thanks

jonaahDE wrote:

My osu! can't stop download some kind of discord-rpc.dll_patch

Can someone send me a copy?


thanks

https://drive.google.com/file/d/1x17jM9fnbyfbGM9vY6H54UXWECSILwlY/view?usp=sharing

The link is in the post.

ayaya

everything else is fine, except for that whenever i type (searching, playing the game, etc) the game will either freeze or crash.

i can press keys while keybinding, but the keys don't change, they stay default, no matter what key i press.

Every time I try to use update wrapper or change engine used, it would just say your wrapper is running and can't perform the task. Is there a way to stop the wrapper?

Alledion wrote:

Every time I try to use update wrapper or change engine used, it would just say your wrapper is running and can't perform the task. Is there a way to stop the wrapper?

Open Activity Monitor and type in the search bar "wine", "Wineskin" and "osu" and then force quit any programs with those names.

Thanks for the advice!

Dntm8kmeeatu wrote:

jonaahDE wrote:

My osu! can't stop download some kind of discord-rpc.dll_patch

Can someone send me a copy?


thanks

https://drive.google.com/file/d/1x17jM9 ... sp=sharing

The link is in the post.

Where should I put the file after downloading?

Technocoder wrote:

osu! folder can be found by going to Show package contents > drive_c > osu!

Before I updated to High Sierra (was using El Capitan before, never updated to Sierra) my Osu! with this wrapper worked perfectly smooth, no input lag or anything. Now that I've updated to High Sierra I've had no problem opening it, however, the gameplay is terrible now. I get high input lag and the notes don't even show up on time anymore they are super delayed and very laggy, along with the cursor lag, it's pretty much unplayable. I haven't seen anyone with this problem though, only those having trouble opening it and no gameplay problems. Any thoughts on how I could fix?

Currently my odd problem, is that whenever I am playing and get to low hp, the screen goes entirely black, I am not even using a dual monitor setup or anything, it really hinders gameplay.

See my reply on a previous problem extremely to similar to this one.


Only thing I can think of is OpenGL issues but your GL Version is only slightly lower than mine so I doubt it's a huge issue. You can try disabling as many graphical effects in the osu! options and if that doesn't work, enable compatibility mode. If even that doesn't work I'll add a section in my guide later that explains how to revert your Wine version to an older one that may work better.

[quote="catitaa6"]hey! worked for me - i moved some settings around, something was probably causing conflict and the problem is gone. not sure what it was as i changed a lot of stuff, but fortunately it's properly working again. thanks again for this lovely package now i can say it's fully running
[/box]

RIP formatting

osu! is black when i open it and I only hear audio help what do I do I also tried to reinstall it and i can't get into wine yet because it says busy please wait well how long do i have to wait?!?!

Update: reinstalled osu! it works fine now now i have lag like every 2-3 seconds i try to play a map WHATS WRONG!?!?!? forgot to mention also on the latelst high Sierra update just released a few days ago

orangeosu wrote:

osu! is black when i open it and I only hear audio help what do I do I also tried to reinstall it and i can't get into wine yet because it says busy please wait well how long do i have to wait?!?!

Update: reinstalled osu! it works fine now now i have lag like every 2-3 seconds i try to play a map WHATS WRONG!?!?!?

As I posted before although skipped over, I am also having the lag problem but it is all throughout Osu! since the High Sierra update. Before, however, the wrapper worked perfectly. What causes this lag? It is unbearable. Thanks

Z3xs wrote:

I have a Mac and the problem of the month for osu for me is that when I start it up, the screen is just white. I can still hear the sound but I can't see anything

Same here except my screen is black i cant see anything but i can hear the game

These tips were helpful when I still had Osu, but when I had it running in the background for about 5 mins, it suddenly froze and had to uninstall it. Upon reinstalling the game, I set up all the settings to what I had before uninstalling Osu. But now the game won't even launch. I have tried using all the steps in the post but still hasn't worked. I'm running on High Sierra. In Activity Monitor, I see the Osu app active for about a minute then immediately shuts down. I also didn't see the Osu wine commands active during the process.

IndigoRush wrote:

Z3xs wrote:

I have a Mac and the problem of the month for osu for me is that when I start it up, the screen is just white. I can still hear the sound but I can't see anything

Same here except my screen is black i cant see anything but i can hear the game

Have you put shaders on?

I've looked through here and can't seem to find a solution for my issue. I'm using a Wacom Intuos P S (newest intuos tablet, also known as intuos draw) when I play osu! and when I'm playing, the cursor will freeze for a few seconds - every 10-20 seconds and make me fail. I have Wacom drivers installed, so I checked to see if it was my tablet by playing with my mouse and I get the same problem. The mouse & tablet works perfectly fine outside of osu! so I'm not sure what the problem is.

For some reason, osu will work fine but then will give an error message that reads,"Unable to find a version of the runtime to run this application". I backed up my osu folder and reinstalled osu, but after I restored my backup, the updater opened and installed some files, and I got the error message after it closed. I'm unsure as to how to fix this, and I don't want to reinstall osu again in case the same thing happens.

I'm unable to open wineskin. Its constantly stuck on this small window that says its busy. Anyone able to help?

Thank you soo much!!

When it is on desktop it launches but won't launch when moved to applications. Also, when updating, replacing the dll file won't work and would still be downloading 17 files.

Is anyone having a problem where when you open up osu! it says unable to find version? I had pressed the "Click to Restart osu!" and it just told me it couldn't find a version?

My osu! opens up at black screen, I can hear the music and I can still navigate throughout the menu but only displays black screen!

When I try to update Osu, an error appears: you can not find a version of the runtime to run this application. Can anybody help me?

i did everything you said here but it still wont run

I have just found out that if you are in an update loop, you can delete the file "Wineskinx11" (Contents>MacOS) and it should stop the update loop.

This is only if you have updated all of the wineskin stuff beforehand - including the engine and completed the steps under "Help!My game wont start after updating to High Sierra"

This has just worked for me and I cant speak for anyone else but I hope it helps.

My Wine package worked fine until a couple days ago when osu! updated. I've updated the settings, but I get an error message saying, "Unable to find a version of the runtime to run this application." I'm not sure why it's happening, but the log I checked from a Wine test run said that fonts wouldn't initialize (with the X11 from the computer). Future runs said, "No X11 Log info when using XQuartz!" How do I fix this?

The XQuartz file now just mentions hardware, graphics, and Wine engine used, but now Wine says something that I don't know how to fix. Here's what I got:

Hey guys, I got xQuartz and Wine installed, however I have to cd to the osu.exe file to launch. And once I do this I'm stuck at can't download .NET.

Heres the logs:

Hey the application works perfectly fine but there is a noticeable cursor lag or just some slight FPS issues.

MacBook Pro (Retina, 13-inch, Late 2012) is what I'm running it on if that helps

It crashes When I turn on compatability mode and won't start up (had to reinstall). Is that a graphics problem or is there a fix to that?

don't have the logs anymore sorry

diddy_dante wrote:

It crashes When I turn on compatability mode and won't start up (had to reinstall). Is that a graphics problem or is there a fix to that?

don't have the logs anymore sorry

Probably some graphics issue.

If you accidentally turn it on in the future, right click on your osu! icon and hit "Show package contents" then go to "Contents > Resources > drive_c > osu!". Edit the file "osu!.pcname.cfg" in any text editor (TextEdit will do) and set the line CompatibilityContext equal to 0. Save the file and close the document and you should be able to start the game again.

help, i have a mac 12 inch (2012 version) running osx 13.6. i have followed all your instruction but my game wont load. in activity monitor it appers but after 1 min it disseapear and the game does not show

Thank you so much for posting this guide! I love osu! and recently switched from Windows to Mac and this guide helped me get osu! to finally run after installation!

Thank you. Helped a lot

Do you know how to fix the Japanese characters showing as boxes?

Whenever I play this beatmap: https://osu.ppy.sh/beatmapsets/219380/#osu/724015
my game crashes.

After I played any other map, throughout the song everything was just fine until the very end as I was getting my score, the game crashes.

When I say "the game crashes" I mean the application doesn't close. It's just frozen for eternity, so I have to Force Quit OSU.

Has anyone else encountered this? Is there any fix for this?

Lv99Pikachu wrote:

Whenever I play this beatmap: https://osu.ppy.sh/beatmapsets/219380/#osu/724015
my game crashes.

After I played any other map, throughout the song everything was just fine until the very end as I was getting my score, the game crashes.

When I say "the game crashes" I mean the application doesn't close. It's just frozen for eternity, so I have to Force Quit OSU.

Has anyone else encountered this? Is there any fix for this?

Try deleting and redownloading the map.

Death wrote:

Lv99Pikachu wrote:

Whenever I play this beatmap: https://osu.ppy.sh/beatmapsets/219380/#osu/724015
my game crashes.

After I played any other map, throughout the song everything was just fine until the very end as I was getting my score, the game crashes.

When I say "the game crashes" I mean the application doesn't close. It's just frozen for eternity, so I have to Force Quit OSU.

Has anyone else encountered this? Is there any fix for this?

Try deleting and redownloading the map.

It didn't help. It's happening whenever I play any beatmap.

EDITED: Nvm.. I found out that the skin I was using was crashing my game. (I was using BeastTrollMC's skin)

I have an extremely hard time reading English so I prefer to play games either in Korean or Japanese. When I try to change my language to.. one of them, it appears as boxes. I'm using macOS.

I've tried to search for a solution but none has helped, can anyone help me on here?

This was really helpful!! Ever since my computer updated itself to MacOS Mojave, I couldn't open osu at all... I just backed up the osu folder, installed the google drive folder, and restored the osu folder and it worked for me the only problem is the input lag now... but I'm just glad I got it to open right now.... phew! I thought I could never play again LOL

When doing a data backup it says delete all .dll files, (sounds dumb but) does this mean ALL .dll files(including the ones in the 'windows' folder or the just the ones in c_drive>osu?

KrazyKang wrote:

When doing a data backup it says delete all .dll files, (sounds dumb but) does this mean ALL .dll files(including the ones in the 'windows' folder or the just the ones in c_drive>osu?

Only the ones the osu folder

Well I finally got osu! to work on Mojave(thank you); though a little choppy; but I haven't restored my backup, because it is from a stable(fallback) version and didn't work beforehand. Do you know if I can just replace the songs file with the one in my backup folder and it'll have them? it is the only concern. Otherwise I can just download them again over time.

Help! Is there an auto updater?

KrazyKang wrote:

Well I finally got osu! to work on Mojave(thank you); though a little choppy; but I haven't restored my backup, because it is from a stable(fallback) version and didn't work beforehand. Do you know if I can just replace the songs file with the one in my backup folder and it'll have them? it is the only concern. Otherwise I can just download them again over time.

The songs folder of all things should be fine to transfer over.

LimbowGraphicZz wrote:

Help! Is there an auto updater?

I'm not aware of an auto updater so I've added a section in my guide about updating osu! manually. Theoretically, osu! should update itself after it's been updated manually.