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.
Application Details:
Version: | Stable |
License: | Free to use |
URL: | https://osu.ppy.sh |
Votes: | 6 |
Latest Rating: | Silver |
Latest Wine Version Tested: | 5.0.3 |
Maintainers: About Maintainership
What works
Startup image works(black background)
What does not
Game crashes after startup logo.
Workarounds
What was not tested
Game play
Hardware tested
Graphics:
Additional Comments
Operating system | Test date | Wine version | Installs? | Runs? | Used Workaround? | Rating | Submitter | ||
Show | Ubuntu 20.04 "Focal" (+ variants like Kubuntu) | Dec 31 2020 | 5.0.3 | Yes | Yes | Yes | Silver | Invictus Tiberius | |
Current | FreeBSD 12.2 | Dec 31 2020 | 5.0.3 | Yes | No | No | Garbage | StreamNet | |
Show | Manjaro Linux 20.1 | Sep 19 2020 | 5.16 | Yes | Yes | Yes | Gold | James | |
Show | antiX-19 x64-core "Marielle Franco" | Sep 05 2020 | 5.16 | Yes | No | No | Garbage | Jakub Semeniuk | |
Show | Ubuntu 20.04 "Focal" (+ variants like Kubuntu) | Aug 16 2020 | 5.15 | Yes | Yes | No | Platinum | 13122002 |
Bug # | Description | Status | Resolution | Other apps affected |
30941 | osu! web-installer 20141028 fails with Wine-Mono: System.InvalidProgramException: Invalid IL code | NEW | 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 | UNCONFIRMED | View | |
50111 | osu! crashes since 20201110 version with wine-mono (needs native -> managed byref array marshalling) | UNCONFIRMED | View |
Last update: 2020-12-31.
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 'http://m1.ppy.sh/r/osu!install.exe' --output-document='osu!/osu!.exe'
$ env PULSE_LATENCY_MSEC=40 WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe'
Run in terminal:
$ env PULSE_LATENCY_MSEC=40 WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe'
Run in terminal (and detach from it so you can close the console window):
$ env PULSE_LATENCY_MSEC=40 WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe' &
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:
$ chmod +x '~/.local/share/applications/osu!.desktop'
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.
Open winecfg:
$ 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.
Also check out The Poon's guide and Franc[e]sco's guide.
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.
Video latency:
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.
Disable compositing:
$ xfconf-query -c xfwm4 -p /general/use_compositing -s false
Re-enable compositing:
$ 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!.
The following comments are owned by whoever posted them. WineHQ is not responsible for what they say.
by jack henderson on Tuesday December 22nd 2020, 8:12
by Invictus Tiberius on Wednesday December 23rd 2020, 13:40
env PULSE_LATENCY_MSEC=40 WINEPREFIX=$HOME/.wineosu wine ~/osu\!/osu\!.exe &
This is a temporary solution if you don't manage to create the .desktop file and allows to close the terminal while osu! is running. Hope it helps!
by Lys1257 on Sunday November 22nd 2020, 20:02
download this "UniFonts5.4" and install it, you shall only need to click next, if if appear a dialog with "??", just click it
1drv.ms/u/s!AhC5R--MJQkvrkmkLF7pFM1wV6ZN?e=rJLTBp
env WINEPREFIX=$HOME/.wineosu winetricks ~/Downloads/UniFonts5.4.exe
by Lys1257 on Sunday November 22nd 2020, 20:06
env WINEPREFIX=$HOME/.wineosu wine ~/Downloads/UniFonts5.4.exe
by Nguyen Chinh Huu on Sunday November 22nd 2020, 1:44
by Invictus Tiberius on Sunday November 22nd 2020, 6:45
by Lys1257 on Monday October 26th 2020, 7:53
but when you switch your GPU to NVIDIA, it seems like doesn't working after a quick flash of osu!
I find a solution, witch is pretty easy
try to install lib32-nvidia-utils
sudo pacman -S lib32-nvidia-utils
by Lys1257 on Monday October 26th 2020, 7:57
by Nguyen Chinh Huu on Sunday January 5th 2020, 7:28
Or you can return to the old engine in Setting => Sound => Audio compatibility mode, which is not recommended because of the high latency and frequent shuttering.
by Invictus Tiberius on Sunday January 5th 2020, 10:19
PULSE_LATENCY_MSEC=40, WASAPI: 67, 67, 50, 57, 63, 61, 52 (59.6ms)
PULSE_LATENCY_MSEC=40, Directsound: 104, 101, 107, 101, 105, 97 (102.5ms)
PULSE_LATENCY_MSEC=20, WASAPI: 30, 29, 22, 25, 24, 22 (25.3ms) --sound is distorted--
PULSE_LATENCY_MSEC=20, DirectSound: 101, 104, 99, 97, 101, 102 (100.6ms) --pretty much the same as before--
It's a nice workaround and applies to WineHQ packages. Adding to Troubleshooting section.
by Micah Jinkerson on Saturday December 14th 2019, 22:46
I've tryed changing the WINE version to everything above XP but it still results in the same.
by Micah Jinkerson on Saturday December 14th 2019, 22:55
by Invictus Tiberius on Thursday December 19th 2019, 4:05
by Jason on Thursday September 12th 2019, 3:00
by Jason on Thursday September 12th 2019, 2:33
by Invictus Tiberius on Wednesday September 18th 2019, 11:22
$ mkdir 'osu!'
$ wget 'm1.ppy.sh/r/osu!install.exe' --output-document='osu!/osu!.exe'
$ env WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe'
A new folder called "osu!" is created directly in your personal user folder '/home/user/osu!'. Then, 'osu!install.exe' is renamed to 'osu!.exe'; that way it will install its files directly in '/home/user/osu!'.
If you want to install osu! in the usual way, try:
$ wget 'm1.ppy.sh/r/osu!install.exe'
$ env WINEPREFIX=$HOME/.wineosu wine 'osu!install.exe'
Then, if you didn't choice another path, the osu! files will be found in '/home/user/.wineosu/drive_c/user/user/Local Settings/Application Data/osu!'
by Nguyen Chinh Huu on Monday August 19th 2019, 22:23
by Invictus Tiberius on Wednesday August 21st 2019, 21:11
by Nguyen Chinh Huu on Monday April 29th 2019, 9:36
If you have installed cjkfonts or fakejapanese_vlgothic, you have to use --force flag to install it.
by Invictus Tiberius on Wednesday May 1st 2019, 4:08
by Nguyen Chinh Huu on Wednesday May 1st 2019, 10:19
by Gage Johnson on Friday January 4th 2019, 11:44
by Invictus Tiberius on Saturday January 5th 2019, 16:37
by André on Friday November 9th 2018, 11:23
by Robert on Thursday August 2nd 2018, 11:01
by Robert on Thursday August 2nd 2018, 11:22
by Ena on Sunday June 3rd 2018, 12:21
After you click ok, a window will pop up; its called "oh no!" and it will display the error (shown below):
#=z1U64elhN$6ScXutjLe68OMafNiDW: No available GL context found. ---> OpenTK.Graphics.GraphicsContextException: Failed to initialize EGL, error BAD_ALLOC.
at OpenTK.Platform.Egl.EglWindowInfo..ctor(IntPtr handle, IntPtr display, IntPtr surface)
at OpenTK.Platform.Egl.EglAnglePlatformFactory.CreateWindowInfo(IAngleWindowInfoInternal window_info, Int32 major, GraphicsContextFlags flags)
at OpenTK.Platform.Egl.EglAnglePlatformFactory.CreateGLContext(GraphicsMode mode, IWindowInfo window, IGraphicsContext shareContext, Boolean directRendering, Int32 major, Int32 minor, GraphicsContextFlags flags)
at OpenTK.Graphics.GraphicsContext..ctor(GraphicsMode mode, IWindowInfo window, IGraphicsContext shareContext, Int32 major, Int32 minor, GraphicsContextFlags flags)
at #=zN5FEz26lyeeReWfdrjnq99Map8xE.#=zegPSY_c=(Int32 #=zbrLuJSw=, Int32 #=zxzJ1FKg=, GraphicsContextFlags #=zzeNMliw=)
at #=zl1FmSAdVU5XcZFWz2wwT96w=.#=zh4G6cmQDc_G1(GraphicsContextFlags #=zzeNMliw=)
--- End of inner exception stack trace ---
at #=zl1FmSAdVU5XcZFWz2wwT96w=.#=zh4G6cmQDc_G1(GraphicsContextFlags #=zzeNMliw=)
at #=zl1FmSAdVU5XcZFWz2wwT96w=.#=zh4G6cmQDc_G1(GraphicsContextFlags #=zzeNMliw=)
at #=zl1FmSAdVU5XcZFWz2wwT96w=.#=zh4G6cmQDc_G1(GraphicsContextFlags #=zzeNMliw=)
at #=zl1FmSAdVU5XcZFWz2wwT96w=.OnHandleCreated(EventArgs #=z_Pvg3ZA=)
at #=zYTfEQdWXPSgMtNA4bKQNAjWhu_TZ.OnHandleCreated(EventArgs #=z_Pvg3ZA=)
at System.Windows.Forms.Control.WmCreate(Message& m)
at System.Windows.Forms.Control.WndProc(Message& m)
at System.Windows.Forms.ScrollableControl.WndProc(Message& m)
at System.Windows.Forms.ContainerControl.WndProc(Message& m)
at System.Windows.Forms.Form.WmCreate(Message& m)
at System.Windows.Forms.Form.WndProc(Message& m)
at #=zekbVG2TReeQyJ70gKx_9C2k=.WndProc(Message& #=z_sw5Hvg=)
at System.Windows.Forms.Control.ControlNativeWindow.OnMessage(Message& m)
at System.Windows.Forms.Control.ControlNativeWindow.WndProc(Message& m)
at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)
The update log looks like this:
6/3/2018 5:17:47 PM: Running repair (False)
6/3/2018 5:17:48 PM: Force update requested
6/3/2018 5:17:49 PM: CallbackStatus updated to Checking
6/3/2018 5:17:49 PM:
6/3/2018 5:17:49 PM: Beginning update thread
6/3/2018 5:17:49 PM: Stream: Stable40
6/3/2018 5:17:49 PM:
6/3/2018 5:17:49 PM: Running cleanup..
6/3/2018 5:17:49 PM: Cleanup successful!
6/3/2018 5:17:49 PM: Requesting update information...
6/3/2018 5:17:50 PM: discord-rpc.dll: CHANGED (cached)
I have version 3.0.1.
by Invictus Tiberius on Tuesday June 12th 2018, 8:44
by Ian Snyder on Thursday May 3rd 2018, 1:05
I'm using Ubuntu 18.04 LTS and Wine 3.0 from ubuntu repository.
Have any idea of this problem?
by osaka-takumi on Wednesday May 2nd 2018, 11:11
wiki.archlinux.org/index.php/Microsoft_fonts
Please delete the internal font folder of wine
Otherwise font glitches will not be Fixed.
gdiplus override to Native, graphical glitches & CJK fonts will be fixed
by bbadadadadad bitch on Thursday April 26th 2018, 16:08
by bbadadadadad bitch on Thursday April 26th 2018, 16:06
help;
by osaka-takumi on Thursday February 22nd 2018, 5:44
by Supashake YT on Wednesday February 21st 2018, 23:35
by Howard Zhang on Sunday January 21st 2018, 9:57
by Invictus Tiberius on Sunday January 21st 2018, 11:42
$ env WINEPREFIX=$HOME/.wineosu wine 'C:\«path_to_the_game»\osu!.exe'
Where "$HOME/.wineosu" is the absolute path to your wine-prefix and 'C:\«path_to_the_game»\" is a folder inside the wine-prefix where osu! is installed.
Be sure you followed all the guide to get it properly installed (I checked all steps for Wine 3.0-rc6 and it is working). Please leave us another comment if you are still in trouble.
by Howard Zhang on Monday January 22nd 2018, 20:16
And I didn't quite understand the command line. so do I put env WINEPREFIX=$HOME/.wineosu wine "c:\home/Umbryft/.wineosu/dosdevices/c:/users/Umbryft/Local Settings/Application Data/osu!\osu!.exe
by Howard Zhang on Monday January 22nd 2018, 20:22
P.S. I forgot to add this in my last comment and I don't know how to edit it so I'm just adding It here I hope you don't mind hx.
by Invictus Tiberius on Wednesday January 24th 2018, 11:15
env WINEPREFIX=$HOME/.wineosu
Wine use this part to know what folder on your file system will be used as the "C:\" unit. Remember that Wine needs to "emulate" a Windows-like environment for your applications.
wine 'C:\Umbryft\Local Settings\Application Data\osu!\osu!.exe'
Inside the indicated "C:\" unit folder, Wine will execute the program that match to the indicated path, in this case, "osu!.exe". When using a terminal, you can put that path inside single quotes ' ', but in a ".desktop" shortcut, you need to use double quotes " " and append an additional inverted slash "\" to the existent:
env WINEPREFIX=$HOME/.wineosu wine "C:\\Users\\Umbryft\\Local Settings\\Application Data\\osu!\\osu!.exe"