osu! builds from the Stable release stream.
Stable is the most recent version of osu! that is not on test phase. It currently renders through OpenGL 3.x, that allows Wine to get the same performance as Windows. It needs .NET Framework 4.0+ to work.
There are also the Beta and Cutting edge release streams that allow to test the latest development features. However they change frequently and older versions get obsolete quickly. Its compatibility level on Wine is usually the same as Stable.
Pretty much everything, unless noted otherwise.
What does not
Chinese, Japanese, and Korean fonts.
What was not tested
Everything was tested.
After installing the .NET 4.0 Framework through winetricks, the game is able to install and launch fine. The lack of raw input can be fixed by installing software such as SteelSeries ExactMouse. Typing into chat/song select is a bit weird. Sometimes it works, sometimes it doesn't. Most of the time, restarting the game or reloading the skin fixes it. There is a black bar along top of the editor that's supposed to be the menu bar. It still works, however. Clicking on the area where the "File" menu is supposed to be brings up the menu just fine. Missing CJK characters/icons could be fixed by installing the correct fonts.
|Operating system||Test date||Wine version||Installs?||Runs?||Used|
|Show||Ubuntu 22.04 "Jammy" (+ variants like Kubuntu)||May 01 2023||8.0.1||Yes||Yes||Yes||Gold||Ravener|
|Show||Arch Linux x86_64||Jan 15 2022||7.0-rc5-staging||Yes||Yes||Yes||Gold||Spooker|
|Show||Arch Linux x86_64||Nov 13 2021||6.21-staging||Yes||Yes||No||Platinum||litecave|
|Show||Ubuntu 21.10 "Impish" (+ variants like Kubuntu)||Nov 24 2021||6.0.2||Yes||Yes||Yes||Silver||C31|
|Show||Manjaro 21.1.5||Nov 15 2021||6.16-staging||Yes||Yes||No||Platinum||litecave|
|Bug #||Description||Status||Resolution||Other apps affected|
|27364||Osu! fails to install (ole32.IIDFromString returns unexpected error code)||CLOSED||FIXED||View|
|30914||Osu! Doesn't start||CLOSED||FIXED||View|
|30941||osu! web-installer 20141028 fails with Wine-Mono: System.InvalidProgramException: Invalid IL code||CLOSED||DUPLICATE||View|
|35568||Osu! fails to install (crash during post-installation in LSA SID translation/.NET runtime)||CLOSED||ABANDONED||View|
|35922||Texture Corruption of Certain Elements on osu! When Using AMD Graphics Hardware||CLOSED||ABANDONED||View|
|35923||OpenGL Renderer Not Selectable On osu!||CLOSED||INVALID||View|
|42005||"osu!" cannot connect to the internet||CLOSED||INVALID||View|
|44184||osu!: installer stuck in a loop||NEW||View|
|47066||Extremely low FPS in osu! on wine 4.6, unplayable on Wayland||RESOLVED||NOTOURBUG||View|
|48507||osu! icons in the setting and music player are not being rendered||CLOSED||FIXED||View|
|48711||osu! crashes on dotnet452 when using built-in gdiplus: System.ArgumentException: Font '?' cannot be found.||CLOSED||WORKSFORME||View|
|50111||osu! crashes since 20201110 version with wine-mono (needs native -> managed byref array marshalling)||NEW||View|
Last update: 2021-08-06.
1) Get winetricks! (the easy way):
$ sudo wget 'https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks' -O /usr/local/bin/winetricks
$ sudo chmod +x /usr/local/bin/winetricks
2) Create a new 32-bit Wine prefix:
$ env WINEARCH=win32 WINEPREFIX=$HOME/.wineosu wineboot --init
If Wine prompts for installing Mono, click Cancel.
3) Install .NET Framework 4.0:
$ env WINEPREFIX=$HOME/.wineosu winetricks --force dotnet40
4) Download and install osu!:
$ mkdir 'osu!'
$ wget '
Run in terminal:
Run in terminal (and detach from it so you can close the console window):
Creating a shortcut:
Create a new plain text file and copy the following:
Save this file as osu!.desktop in the folder ~/.local/share/applications and mark it as executable:
Take the path to an osu! logo image and put it in the Icon field if you want to set an icon for the shortcut.
Last update: 2020-12-31.
Arch Linux specific:
osu! doesn't render anything on screen and exits with some X server error message: install lib32-libxcomposite package:
$ sudo pacman -S lib32-libxcomposite
osu! can't connect to internet: install lib32-gnutls package:
$ sudo pacman -S lib32-gnutls
Japanese characters no displaying correctly: install MS Meiryo font:
$ env WINEPREFIX=$HOME/.wineosu winetricks meiryo
Set language to Japanese to correctly display all kanjis.
This font doesn't include Korean glyphs.
Options menu symbols and audio controls are missing: install GDI+:
$ env WINEPREFIX=$HOME/.wineosu winetricks gdiplus
GDI+ installer is a ~538MB file. If your internet connection is slow or limited, consider instead taking a copy of gdiplus.dll from a Windows 7 installation and copying it to your Wine prefix, and then add manually a Native override for gdiplus.
$ env WINEPREFIX=$HOME/.wineosu winecfg
Go to Libraries tab, add gdiplus and set it to Native Then Builtin. Close all dialogs by clicking OK.
Some unusual image formats are not shown when using native GDI+: install windowscodecs through winetricks:
$ env WINEPREFIX=$HOME/.wineosu winetricks windowscodecs
Note: this workaround may break screenshots and interfere with other windows applications installed on the osu! wineprefix when trying to save files. If you need to disable it:
$ env WINEPREFIX=$HOME/.wineosu winecfg
Go to Libraries tab, find windowscodecs and set it to Builtin (Wine). Close all dialogs by clicking OK.
Audio latency, sound distortion or no audio at all: first try setting PULSE_LATENCY_MSEC environment variable to "40" before running osu!:
$ env PULSE_LATENCY_MSEC=40 WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe'
Other values could be tested in order to get lower latency or fix sound distortion/crackling.
Enabling "Audio compatibility mode" in the osu!'s options menu will switch to legacy DirectSound-based audio engine (osu! is now using WASAPI). It can solve some problems but has higher latency and some audio stuttering.
Frame limiter is permanently locked at 60 fps:
Disable vertical sync by setting vblank_mode environment variable to "0 " before running osu!:
$ env vblank_mode=0 WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe'
This way osu! will not be able to enable VSync at runtime.
Desktop environments usually draw on screen through a compositor than enable fancy window effects. This may cause lag that you can feel when moving the cursor.
Note: you will prefer to run osu! under X.org since Wayland is not fully supported by most window managers.
$ xfconf-query -c xfwm4 -p /general/use_compositing -s false
$ xfconf-query -c xfwm4 -p /general/use_compositing -s true
Other known problems:
$ pkill osu
Press Ctrl+Alt+F1 (or Ctrl+Alt+F7 on some systems) to return to your desktop environment.
$ pkill osu
Wait 10 seconds and try again.
Please leave us a comment in Comments section below if you still have problems installing or running osu!.