User avatar
Whistle Blower
16 posts
Offline
(PS Dear forum mods: this seemed like the best place for my thread but I just couldn't help but notice that there were only threads asking questions instead of giving solutions)

[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]

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:
Steps

  1. Open (double click) on Wineskin
  2. Click "Advanced"
  3. Click "Tools" (next to Configuration and Options)
  4. Click "Update Wrapper" (in the right column)

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:
Steps

  1. Click the refresh button below the list of "Installed Engines"
  2. Click the plus button below the list of "Installed Engines"
  3. The "Add Engine" window should now appear. The default selected option should be the latest engine available. At the time of writing WS9Wine2.22 is the latest
  4. Click "Download and Install"
  5. Click "OK"

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:
Steps

  1. Click "Change Engine Used"
  2. The default selected option should be the engine you just installed
  3. Click OK to change the engine

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:
Steps

  1. Click "Set Screen Options" (Under the "Tools" tab in Wineskin)
  2. Click "Use Mac Driver instead of X11"
  3. Click "Done"
  4. Click "Options" (near the top of the Wineskin window next to "Tools")
  5. Uncheck "Force use of system installed XQuartz instead of using built in WineskinX11"

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:
Steps

  1. Click "Set Screen Options" (Under the "Tools" tab in Wineskin)
  2. Uncheck "Auto Detect GPU Info for Direct3D"
  3. Uncheck "Use Direct3D Boost (if available)"
  4. Click "Done"

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.
Notable beatmaps that have this issue


  • 568455 fhana - Outside of Melancholy ~Yuuutsu no Mukougawa~
  • 707380 ClariS - SHIORI vs Hitorigoto [no video]


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

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
discord-rpc.dll keeps downloading

See The updater keeps downloading discord-rpc.dll!

Restore a backup

If this problem occurred after following one of the steps in this entire guide then you can restore to a working state by pasting the contents of your backup (which you should have made before starting this guide!) into the osu! folder.

Update your wine engine

Newer versions of wine have several bug fixes and features that may make osu! work properly again. If have not already done so follow the steps in Before you fix anything

Check your release stream

Newer release streams may not be able to be run on Wine. You may have gotten a newer release stream if you clicked "Force Update" in your osu! options. This can also happen for other reasons. Here's how to revert your release stream:

  1. Open osu!.cfg in the osu! folder with a text editor
  2. On the first line after "_ReleaseStream = " change the value to "Stable40"
  3. The line should now read: "_ReleaseStream = Stable40"
  4. Save the file and exit
  5. Now delete all files ending in a .dll extension


Reinstalling the Wineskin package

You must do a data backup before doing this option.
If all else fails you'll have to start from scratch:

  1. Delete the entire osu! application (Make sure you have done a data backup)
  2. Download the latest wrapper from http://osuosx.tumblr.com
  3. Follow the steps for Before you fix anything before running osu!
  4. Copy the entirety of your data backup into the osu! folder
  5. (If you are running High Sierra) See Help! My game won't start after updating to High Sierra!


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.
Steps

  1. Create a folder to store all the copied osu! data
  2. Open your osu! folder
  3. Select all files (CMD + A) and then copy them over to your folder
  4. In your new folder delete all .dll files
  5. Delete osu!.exe
  6. Delete osu!.cfg
  7. Check that you have folders: Data, Downloads, Logs, Screenshots (if you took one), Skins, Songs
  8. Check you have files: collection.db, osu!.db, osu!.(name).cfg, presence.db, scores.db

How to restore a data backup


Steps


  1. Make sure osu! is closed
  2. Select all the files (CMD + A) in your data backup folder
  3. Copy the selection (CMD + C)
  4. Paste the files (CMD + V) directly into your osu! folder


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)

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:
Steps

  1. Click "Registry Editor" (Under the "Tools" tab in Wineskin in the left column)
  2. Go to this registry folder: HKEY_CURRENT_USER > Software > Wine > Mac Driver
  3. Double click on "CaptureDisplaysForFullscreen"
  4. Change "Y" to "n" in the text box
  5. Click "OK"
  6. Close the "Registry Editor" window

Help! Clicking on a different window automatically minimises osu!


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

  1. Open your osu! options (In the actual game)
  2. Scroll to "Graphics" options
  3. Uncheck "Fullscreen mode" (Under the subheading "Layout")

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.
Steps

  1. Click "Config Utility" (in the left column under the "Tools" tab in Wineskin)
  2. Click on the "Audio" tab
  3. Change "Output Device" to your headset/headphones or speaker.
  4. Click "Apply" and then "Ok"

Now audio will be routed directly to your audio device instead of through Boom.

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.
Last edited by Technocoder on , edited 18 times in total.
User avatar
Rhythm Rookie
1 posts
Offline
The "Before you fixed anything" part helped me a lot!
User avatar
Combo Commander
265 posts
Offline
I updated from the 2015 stable release (since fallback score submissions will soon be disabled)

It works for now, thanks a lot! :)
User avatar
Whistle Blower
18 posts
Offline
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
User avatar
Tempo Trainee
8 posts
Offline
My osu! can't stop download some kind of discord-rpc.dll_patch

Can someone send me a copy?


thanks
User avatar
Support Team
3,633 posts
Offline
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.
User avatar
Tempo Trainee
8 posts
Offline
i need discord_rpc.dll_patch not the one without patch
User avatar
Rhythm Rookie
2 posts
Offline
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.
User avatar
Rhythm Rookie
2 posts
Offline
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?
User avatar
Whistle Blower
16 posts
Offline
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.
User avatar
Rhythm Rookie
2 posts
Offline
Thanks for the advice!
Rhythm Rookie
4 posts
Offline
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?
User avatar
Whistle Blower
16 posts
Offline
Scribbss
Scribbss wrote:
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!
Reply 13 posts

Users browsing this forum: None


Jump to: