Install Osu On With Wine

This article is applicable to the following wrappers:

For those who wanna play or try osu! On Linux but don't want to use Wine there is a new version of the client currently in development called osu! Lazer and it's open source! But first, as stated on the GitHub page of the project. Is an unofficial open-source client for osu! Wine Windows version last published 1. If you have problems installing. It's not all that often that you have to edit registry values in WINE, but with some programs, you may. Technically, winetricks doesn't provide the registry editor, but it makes accessing it easier. Select 'Run regedit' from the prefix menu and press 'OK.' A basic Windows registry editor will open up. Actually creating registry values is a bit. Installing Wine 5.0 on Ubuntu # The Wine packages are included in the default Ubuntu repositories and can be easily installed with the apt package manager. This is the easiest way to install Wine on Ubuntu. However, the distro version may lag behind the latest release of Wine. Most of the Windows applications are built for 32-bit architecture. Mkdir -p /'Wine Prefixes' && WINEPREFIX=/'Wine Prefixes/osu!' WINEARCH='win32' wineboot.

• Technocoder’s Wineskin with macOS Catalina 10.15 support

This guide will walk you through how to install Technocoder’s Wineskin with macOS 10.15 Catalina support. It should also work on all other modern versions of macOS too.

Using macOS Catalina 10.15.0 to 10.15.4?


Warning

This section only applies to users who are using macOS Catalina 10.15.0 to 10.15.4

If you do not use macOS Catalina, or you are on macOS Catalina 10.15.5 or later, you can skip this section!

If you don’t know what specific macOS version you’re using, use this Apple support article to learn how to find out.

Apple recently introduced changes to how macOS works. New Macs come with System Integrity Protection.

Therefore, in order to run osu!mac on macOS Catalina 10.15.0 to 10.15.4 you need to disable System Integrity Protection.

Danger

While disabling System Integrity Protection shouldn’t harm your computer directly, you are sorta compromising the integrity of your system (hence the name ‘System Integrity Protection’).

Please be informed about the risks of disabling SIP. Consider updating your macOS instead.

You can learn more about SIP in this Apple support article.

Osu

These instructions are quoted from the Apple Developer documentation.

To disable SIP, do the following:

  1. Restart your computer in Recovery mode.

    • Turn on your Mac and immediately press and hold these two keys: Command (⌘) and R.

    • Release the keys when you see an Apple logo, spinning globe or other startup screen.

    • You may be prompted to enter a password, such as a firmware password or the password of a user who is an administrator of this Mac. Enter the requested password to continue.

  2. Launch Terminal from the Utilities menu. It should be in the menu bar at the top of your screen.

  3. Run the command csrutildisable.

  4. Restart your computer. You can do so from the top menu bar (just like you would normally)

Once you have SIP disabled, you’re now set to start getting ready with osu!.


Warning

A newer Wineskin with support for M1 Macs (under Rosetta 2), as well as Intel x86 computers (on any modern macOS version) is now available. It brings new stability updates and bug fixes, and we’d encourage updating to this newer version.

You’ll need to use this new version if you want to play on any Apple Silicon computer.

Step 1: Download the Wineskin¶

Download the osu! Wineskin from Technocoder:

  • osu! forum thread:community/forums/posts/7560723

  • mega.nz direct download (468.1M):https://mega.nz/file/…

Note

To play osu! on macOS a compatibility layer called Wine is used. A Wineskin allows a preconfigured version of Wine to be bundled as one app so that you can get right into the game without messing about with the settings.

Once it has downloaded, extract the .zip file.

Move it outside of your Downloads folder, such as your Desktop. This is really important, as not doing so could lead osu! to be sandboxed.

We also recommend downloading Technocoder’s osu!macOS Agent program, since it’ll be used throughout this guide. In general, it’s a great tool that every macOS osu-stable player on Wine should have. However, this is optional (though strongly encouraged) and alternative instructions are provided for those who are comfortable with digging deeper.

  • osu! forum thread:community/forums/topics/1036678

  • GitHub download link (7.61MB):Techno-coder/osu-macOS-Agent…

Warning

Install osu on with wine opener

On 12 October 2020 a bug was introduced with an update for osu!macOS Agent. It caused Wineskin.app to display a error that left the settings menu unopenable. You’ll need to download the newest version of osu!macOS Agent, which was updated on 23 January 2021. See Wineskin.app doesn’t open, even if osu! does / exec[number].bat problem.

Step 2: Repair the Wineskin¶

If you try to open the Wineskin immediately, macOS will say that it’s broken. Let’s fix that.

  1. Open osu!macOS Agent

  2. Click the Troubleshoot tab

  3. Click Scan

  4. Once the scan is complete, click Repair

Wine

If it was successful, you should see a Fixed indicator next to Quarantineattributeispresent in the log.

Alternative option: Using the Terminal


On the bleeding edge? You can also use the Terminal to repair your Wineskin.

  1. Open Terminal. It should be in your Applications/Utilities folder.

  2. Type the following command.

where ~/path/to/my/osu!.app is the filepath to your osu! install.

For example: if my osu!.app was in the Desktop, the command to enter would be:

Below are some helpful tips if you’re a bit lost, but if you know what you’re doing feel free to skim over them.

Note

For an application with the name osu!.app, the ! will confuse the Terminal window. Therefore, you must escape it by prefixing the ! with a (backslash) to form osu!.app. It is also recommended you enclose the filepath in quotation marks.

Note

You may be asked for your password. While entering your password the cursor might blink but you won’t see any characters appear on the screen - this is normal! Just proceed to type your password as if there was a dialog box there, and hit Enter once you’re done. (If you stuffed it up you’ll get another chance to retype it.)

Tip

If you get a Permissiondenied error it means you aren’t using an administrator account. In your Terminal window, type:

where administrator is the name of your system’s admin account. When the Password: prompt appears, enter your password for administrator (or whatever your admin account is). Then try running the Terminal command (or to do this automatically, type sudo!!).

If you don’t know which account is your admin account (like if you use a family computer), go to the Applemenu (top-left corner of the screen) > SystemPreferences... > Users&Groups and you should be able to see which account is your administrator account. You’ll still need the password to execute the command though.

Note

On older macOS versions, you may get a warning that reads this.

Improper use of the sudo command could lead to data loss or the deletion of important system files. Please double-check your typing when using sudo. Type “man sudo” for more information. To proceed, enter your password, or type Ctrl-C to abort.

Type your password as normal, as shown above.

Tip

Having trouble finding the filepath of your osu! installation? You can drag and drop the file from your installation directory (or the Desktop) to get the path!

My Terminal will look slightly different to yours, but the concept (and the command!) remains the same.

Danger

Unless you do something incredibly stupid, you probably won’t completely stuff your computer. That being said, if you do something incredibly stupid, you’ll stuff your computer. The sudo command allows your local user account to perform otherwise restricted actions, so please don’t go around typing random things if something’s not working - ask us a question instead!


Step 3: Updating osu!¶

At this point, you should have already repaired osu! and now you’re set to open it. In some cases, this will work perfectly, but for most people including myself, osu! will be stuck in an update loop. It can even be difficult to kill the process once it starts updating.

Tip

If you ever have trouble closing osu! once it’s stuck in an update loop, see Common issues: osu! won’t close.

Note

Does osu! appear to be running fine? If you’re not stuck in an update loop, then you can easily skip this section.

  1. Open osu!macOS Agent

  2. Click the Other tab

  3. Click Update osu!

This will download the latest executable from the osu! servers and replace the existing osu!.exe inside your Wineskin wrapper.

Alternative option: Manually installing the latest version of osu!


If you’re brave enough to go it alone, these steps will get you the latest version of osu! running - avoiding the possibility of an update loop.

  1. Download osu.exe from osu.ppy.sh/home/download.

  2. Locate where osu!.app (your Wineskin) is installed

  3. Right click on it and select ShowPackageContents

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

  5. From here, click osu!.

  6. From here, locate osu!.exe and replace this file with the updated version that you just downloaded. Make sure you keep the filename the same.


Step 4: Run osu!¶

Now everything should be good to go! Click osu!.app in whichever directory you placed it in and try it out for a spin!

Did things not go to plan? Check out Common issues to see if someone else has encountered your problem before, or ask a question on the osu! forums.

If everything turned out fine, check out Setting up your screen options and Welcome to osu! to improve your osu! experience. We’d recommend doing this before you start clicking circles.

I know a lot of people have been facing issues setting up osu! on Linux.Most of the guides online are either outdated or just all over the place, so I hope to maintain a good guide here that is relatively easy to follow.

I'd like to start by saying I have only tested this on Debian-based distributions, however it should work fine on others.

If you have any problems during or after installation, please don't hesitate to contact me on Discord (tsunyoku#0066) and I will try my best to help.

Installing Lutris

To start with the osu! installation, we want to install Lutris.Lutris is the program that will manage all the wine bullshit for us.

To install on Ubuntu or other Debian-based software:

Install Osu On With Wine Rack

To install on Arch-based distributions:

For other distributions, see here.

Installing osu!

Once Lutris is installed, we need to install osu! through Lutris.Lutris will be available as a regular application so find it and open it.

Install

Once it is open, you will see a sidebar with a heading called Sources. Press on the Lutris option and then type osu! in the Search games search bar.You will find osu! here. Click on it and press Install.

It'll come up with a dialog asking to select what version to install, scroll until you see a version called Windows and then continue.Lutris will begin installing dependencies and osu! itself. This can take anywhere between 2 and 15 minutes from my experience so just wait it out.

Once it has installed, try to play it to verify that it opens. Audio and other things may be glitchy, but we will fix that below. If it doesn't open at all or there is an error, scroll to the Known Issues section and see if that solves your problem. If not, feel free to contact for help!

Optimising osu!

Once you have installed osu! and it can run, close it and we will begin a series of fixes/optimisations to make your experience better.

First, we want to use ThePooN's winepulse patches for audio.Run these commands in a Terminal window:

Once we have applied the patches, we need to edit pulse's config to help with latency:

Install Osu On With Wine

Now, we want to increase our user's priority (you will probably need to run this with sudo su):

REMEMBER TO REPLACE USERNAME WITH YOUR USERNAME

Next we need to do some more config editing.

Open pulse's default config like so:

Once you are in the config, look for this line: load-module module-udev-detect (it was around line 52 for me)Once you have found this line, add tsched=0 on the end of this line so it looks like so: load-module module-udev-detect tsched=0. Then save and exit.

Next, we need to add a environment variable to our osu! install before restarting to finish our installation.Open up Lutris again and you should find osu! in your Games library. Right click it and press configure.

Go to the System options tab and scroll until you find a Environment variables table.In the Key box, type STAGING_AUDIO_DURATION (case sensitive) and set the Value to 5000.

Then press save and you should be good to go! Note that you must restart your system first. After you reboot and open osu!, make sure to set Audio compatibility mode on, otherwise your audio will be very fucked.

After restarting or upon first open, the osu! splash screen appears and shortly closes.

This is due to some Lutris dependency stuff. We can fix it though!Open up a Terminal window and run these commands:

Once it's done, reboot your system and try again.

My Discord Rich Presence doesn't show or it's incorrect

First, you will need to download an IPC bridge for Discord which you can find here. You will need to run the exe in the same wine prefix as your osu!, and the best way is probably to make it run in a pre-startup script in Lutris.

If after this, it still doesn't work then chances are that you have installed Discord using snap so the ipc locations are different. In this case, we can just symlink like so:

ln -s /run/user/<id>/snap.discord/discord-ipc-0 /run/user/<id>/discord-ipc-0

Note: I believe the id should be 1000 for everyone, but I maybe wrong hence why I've left it for you to work out. Just cd into /run/user and you'll find it.

My cursor keeps teleporting when I use my tablet

Chances are, you installed OpenTabletDriver and use them as your drivers. Some distributions some with drivers for tablets also, and they are clashing.

To fix this problem we just need to disable the ones in your kernel like so: sudo rmmod wacom if you are using a Wacom tablet. If you aren't using a Wacom tablet, then I would do some research to find out what it's called as I have no clue.

You will need to run this at every startup, so feel free to make a startup script for it.

Other common problems can usually be found here so I recommend you also look around here.If you're still having problems with your tablet or it isn't disabling, I recommend you join the OpenTabletDriver Discord server as the support there is generally very good.

'NoneType' object has no attribute 'lower'

Right click osu! in your Lutris library and press Configure. Go to the Runner options tab and disable Enable DXVK/VKD3D option. Press save and run osu! again and it should work correctly.

Black screen when opening osu!

Install lib32-libxcomposite.

Note: this is also sometimes a problem with pulse so ensure lib32-libpulse is also installed if the above lib doesn't fix it for you.

Importing maps

I've yet to find an efficient way to do this with Lutris yet. You can find your osu! install in /home/<your username>/Games/osu/drive_c/osu (unless you manually changed it.)

Update: If you are using Arch there is a package to handle maps/skins for you. You can find it here. I will do more research into making this work for other distros and update this later.

Download any maps you want from the website and place the .osz files in your Songs folder, F5 in game will take care of them for you.

Importing skins

Skins are a nightmare. Download the skin you want and open the .osk file in your Archive Manager.

Update: If you are using Arch there is a package to handle maps/skins for you. You can find it here. I will do more research into making this work for other distros and update this later.

Navigate to your osu! install folder (you can find it in the part above) and go to your Skins folder.

Create a new folder for the Skin naming it whatever you want and then drag the contents of the .osk from your Archive Manager into it.Then, ingame press the keybind CTRL + SHIFT + S to reload your current skin and the skin list, where you will find your new skin.

Desktop shortcut for osu!

Install Osu On With Wine Bottle

Lutris is actually handy in the sense it can create them for you. Right click osu! in your Lutris library and there is a button to create a shortcut.

If you are like me and use Ubuntu 20.04 or later, there is a very irritating process with allowing shortcuts to run. Right click the shortcut you find on your desktop and press properties. Go to the permissions tab and ensure that it is allowed to run and then it should work.

PP Counter

I've not tested StreamCompanion, but I can say gosumemory works really well.

Head over to the github repo and go to the releases tab. Download the linux version and extract the zip somewhere.

Before we can use gosumemory we need to setup the config, so run sudo ./gosumemory to generate one.Open the config.ini file and we will do some configuring. First, set wine to True since osu! is running using wine.

Since we are running on Wine, we will need to set our Songs path manually.

By default this is /home/<your username>/Games/osu/drive_c/osu/Songs but you can set it accordingly if you edited it yourself.

Once you've edited these 2 entries, you are good to go and you can run it by using sudo ./gosumemory.

Install Osu On With Wine Opener

With this version, the ingame overlay won't be available to you as it is running natively.

If you want the ingame overlay, you can download the Windows version and run it in Lutris' wine prefix for osu! however I never got it working so I won't provide instructions for that here yet.

Install Osu On With Wine Bar

Wine

Install Osu On With Wine Rack

If you're having troubles at any point with gosumemory, then I suggest you join their discord.