WineHQ
Category: Main Games osu! Stable

osu!

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: 7
Latest Rating: Platinum
Latest Wine Version Tested: 6.21-staging

Maintainers: About Maintainership

No maintainers. Volunteer today!

Free Download osu!install.exe

Test Results

Old test results
The test results you have selected are very old and may not represent the current state of Wine.
Selected Test Results

What works

Installation works as expected. Game works as expected, though performance may be lower than native Windows.

What does not

On Arch Linux, the internet and graphics may not work without installing additional packages.

Workarounds

For Arch Linux, run the following commands:

If the graphics don't render:

sudo pacman -S lib32-libxcomposite

If osu! can't connect to the internet:

sudo pacman -S lib32-gnutls

What was not tested

Beatmap editor

Hardware tested

Graphics:

  • GPU: Nvidia
  • Driver: proprietary

Additional Comments

selected in Test Results table below
Operating systemTest dateWine versionInstalls?Runs?Used
Workaround?
RatingSubmitter
ShowArch Linux x86_64Nov 13 20216.21-stagingYes Yes NoPlatinumlitecave 
ShowUbuntu 21.10 "Impish" (+ variants like Kubuntu)Nov 24 20216.0.2Yes Yes YesSilverC31 
ShowManjaro 21.1.5Nov 15 20216.16-stagingYes Yes NoPlatinumlitecave 
ShowKDE neonAug 06 20216.13-stagingYes Yes YesGoldInvictus Tiberius 
ShowUbuntu 20.04 "Focal" (+ variants like Kubuntu)Dec 31 20205.0.3Yes Yes YesSilverInvictus Tiberius 

Known Bugs

Bug # Description Status Resolution Other apps affected
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
50111 osu! crashes since 20201110 version with wine-mono (needs native -> managed byref array marshalling) UNCONFIRMED View

Show all bugs

HowTo / Notes

Installation

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 'http://m1.ppy.sh/r/osu!install.exe' --output-document='osu!/osu!.exe'
$ env WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe'
Running the game

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:

[Desktop Entry]
Exec=env PULSE_LATENCY_MSEC=40 WINEPREFIX=$HOME/.wineosu wine ~/osu\\!/osu\\!.exe
Name=osu!
Type=Application
Categories=Game;
Icon=path_to_osu_logo
Terminal=0


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.

Troubleshooting

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.


  • GNOME 3 (Mutter): it should disable it automatically when running at borderless/fullscreen. If you're running on windowed mode or have many monitors, compositing may remain enabled unless osu! window fills all the screen output area.


  • KDE Plasma 5 (KWin): press Ctrl+Alt+F12 to disable/enable compositing.You can also add a window rule to block compositing when osu! starts and re-enable when it close.


  • Xfce 4 (Xfwm):

    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:

  • My system is frozen!: if osu! freezes and you lose the control of your system, press Ctrl+Alt+F2 (to enter to a tty) login and enter the following to force closing osu!:
    $ pkill osu

    Press Ctrl+Alt+F1 (or Ctrl+Alt+F7 on some systems) to return to your desktop environment.


  • I ran osu but my cpu usage is at 100% and nothing happens: same as frozen system. Open a terminal and run:
    $ pkill osu

    Wait 10 seconds and try again.


  • Alt+tab doesn't work when Fullscreen is enabled: if you can't use Alt+Tab hotkey, disable Fullscreen mode inside osu!.


  • I can't switch to Windowed mode from Fullscreen/Borderless/Letterbox: close the game. Open osu!.«your_user_name».cfg in the osu! folder, and edit the next fields:
    Fullscreen = 0
    Letterboxing = 0
    Width = 800
    Height = 600



Please leave us a comment in Comments section below if you still have problems installing or running osu!.

Comments

Comments Disabled

Comments for this application have been disabled because there are no maintainers.
Back