Install Osu On Mac With Wine

  1. Install Osu On Mac With Wine Glasses
  2. Install Osu On Mac With Wine Vinegar
  3. Install Osu On Mac With Wine Bar
  4. Install Osu On Mac With Wine 2017

Installing Wine on Mac. This tutorial is for intermediate users who want to install and use Wine on their computer running macOS. You should already know the basics of how to use the command line.

Note for MacOS 10.15 Catalina:

As the new version of MacOS drop support for 32-bit application and unfortunately osu! will not run on MacOS 10.15 Catalina. Please install osu! Lazer on https://github.com/ppy/osu/releases. This package will not be updated anymore.

Install Osu On Mac With Wine Glasses

Wine (originally an acronym for 'Wine Is Not an Emulator') is a compatibility layer capable of running Windows applications on several POSIX-compliant operating systems, such as Linux, Mac OSX, & BSD. Wineskin is a tool used to make ports of Windows software to Mac OS X. Mixxx using external drive. The ports are in the form of normal Mac application bundle wrappers. It works like a wrapper around the Windows software, and you can share just the wrappers if you choose.

Migration Process: /uninstall-djay-pro-mjoave.html.

  1. Download the osu! Lazer client, DO NOT move to /Application to replace the old client yet.
  2. Open the old osu! folder and go to drive_c - Program Files - osu!.
  3. Open Terminal by right click osu! folder and select New Terminal at window.
  4. Run the following command in the Terminal:
Download
  • mkdir ~/.osu && mv Songs/ Skins/ ~/.osu
  1. Start Lazer client and go to Settings.
  2. Find Import beatmaps from stable and Import skins from stable.
  3. Go to top right corner and open the sidebar, the runnning task would indicate the process.
  4. When it's finished, delete the ~/.osu folder from the Terminal.
  • rm -r ~/.osu
  1. Move the osu! Lazer client to /Application and replace the old one.
  2. Done and Enjoy!

Step to Install:

  1. Download zip (196M) from this page, it should be sitting in Download folder.

  2. If you are upgrading from the old client, DO NOT open the game or move to /Application and replace the old client immediately. There are some data migrations need to do.

    1. Open osu! folder for both old and new clients (right click on app - show package content - drive_c - Program Files - osu!)
    2. Hold command key and select all of the following folders and files from the old client side
      • Folders: Data, Songs, Skins
      • Files: collection.db, presence.db, scores.db, osu!.db, osu!.cfg, osu!.[Username].cfg
    3. Drag them to the new client side while holding option key. Note: If a symlink a created instead of copying the actual file (A symlink can be identified by an arrow at the corner), remove those symlink files and repeat those steps

  3. Open the new client by right click and select open.

    • An error of no runtime can be ignored.
    • If prompted Gecko package is not installed, click cancel.
    • IMPORTANT!! When osu! installer appear, change the install location before countdown and select drive_c/Program Files/osu!
    • osu! will take a while to download and install itself. The game will start automatically when it finishes.

  4. For the best perfomance, go to setting, set the frame limit to 240fps/Unlimited and turn full screen mode off.

  5. Play a few games. If you're happy with it, move the game to /Application and enjoy!

Testing Environment:

Mac Mini (Late 2014) 2.6GHz, 8G Memory, 256G SSD, MacOS Mojave 10.14.3, Wrapper Wineskin-2.6.2, Engine WS9Wine2.22

Known Issues

  1. Direct Download does not work on MacOS High Sierra 10.13.4 or later, git clone is an alternative option to download. (If you don't already have xcode or command line tool installed, the terminal would prompt you for auto install.)
  • git clone https://github.com/Mic238/osu-for-Mac-Stable-Latest

  1. gdiplus is not compactible with cjkfonts, so it's a trade off to get the setting icons and control buttons work and cjkfonts work. If you prefer cjkfonts more than those graphic glitches, you can follow these steps:

    1. Right click osu! - show package content - open wineskin - click advance.
    2. Click tools at the top - config Utility on top left, The config windows may take a few seconds to jump out.
    3. Go to Libries tab at the top - select gdiplus and click edit - then select built in (wine) and save.
    4. You can revert this setting by the same steps and select native (windows) to revert.

  2. For in-game settings, Shaders would not work (potentially freeze the game), enable Soften Filters will blank the screen, enable Compactible Mode will crash the game. If you accidently turn these settings on, you can go to osu! folder and edit osu!.[Username].cfg with textedit and change the value of BloomSoftening or CompactibilityContext to 0 to fix it.

  3. Some other glitches, osu! Direct from website would not work (in-game download works good). Discord-rpc will not work. Trackpad swipe gesture to switch desktop doesn't work (Use Command+Tab to switch out).

A Little Bouns for all:

To move the beatmaps faster in bulk, open the terminal, copy and paste this command followed by return:

  • echo 'alias osu='mv ~/Downloads/*.osz /Applications/osu!.app/drive_c/Program Files/osu!/songs' >> .bash_profile

Restart terminal and from now on, you can simply type 'osu' in the terminal to move all beatmaps from download folder to game beatmap folder, don't forget to refresh the beatmap list on f5.

Make sure you install XQuartz 2.7.7 or higher first.You will need to download the latest version of osu! from here and place it inside the .app (osu!.app/drive_c/osu!/)Something like: curl -ks https://m1.ppy.sh/r/osu!.exe?`date +%s` > osu!.app/drive_c/osu!/osu!.exe

Ignore this error:

Hit cancel:

Let osu! update and hopefully it should run :)

wine-staging-1.9.9 + Mac Driver seems to work really good. Stable40/Beta40 and Cutting Edge gives ~200 fps/ ~7ms, tested for around 1 day and did not experienced any crashes.

Install Osu On Mac With Wine Vinegar

Looking at symbols and paths inside osu binary, it seems that on *40 and CuttingEdge release streams it is aware of being run on X11/osx.

Install Osu On Mac With Wine Bar

Sometimes, by some twisted logic (fallback mechanism or magic, perhaps?) osu updater will continuously try to 'update' you from *40/CE to Stable (not Stable40) so after update you will end up with a broken osu installation that will look like this:

Install Osu On Mac With Wine 2017

Backing up your working osu setup and manually editing osu!.cfg helps, if you do not want to download same files over and over again.

Use 120 FPS limiter in game if you do not want to fry your laptop GPU.

Run XQuartz and select XQuartz -> Check for XQuartz updates. At the moment of writing the latest version is 2.7.9_rc2.

Force system XQuartz allows for full retina-resolution, but it will cap your performance at vsync (60fps/17ms) which is literally unplayable. I had not looked deeper into this as Mac Driver / WineskinX11 seems to work better.