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: Gold
Latest Wine Version Tested: 8.0.1

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

  • Gamemode (Standard, Catch the Beat, Mania; work flawlessly in Optimal Rendering)
  • All visual gameplay settings.
  • Beatmaps import on ./songs/ directly.
  • Alt-Tab
  • Skins.
  • Offset settings.
  • Bancho (Login, Chat, Leaderboard).
  • Updater.
  • Languages.
  • Keybindings and Mouse input settings, Raw Input turned on.

What does not

  • Discord Rich Presence Integration, with Discord Linux Build.
  • Beatmap editor, there's glitch on menu bar, others are OK.
  • Boss (Ins) Key
  • CJK Fonts, see Troubleshooting on HowTo


    Workarounds

    What was not tested

    • IM Integration
    • osu!direct, needs osu! Supporter to proceed. 

    Hardware tested

    Graphics:

    • GPU: Nvidia
    • Driver: open source

    Additional Comments

    Installation based on HowTo instructions with some extra steps from the PooN's guide.

    System Information:

    • osu! b20200118.2 Stable Release
    • Discord Stable 53284, Host 0.0.9
    • Zorin OS 15.1 Ultimate x86_64
    • GNOME 3.30.2
    • Intel i5-7200U (Quadcore) @ 3.100GHz
    • RAM 4GB DDR3
    • NVIDIA GeForce 940MX, using nvidia-driver-440 (open source)
    • Intel Integrated Graphics

    selected in Test Results table below
    Operating systemTest dateWine versionInstalls?Runs?Used
    Workaround?
    RatingSubmitter
    ShowUbuntu 22.04 "Jammy" (+ variants like Kubuntu)May 01 20238.0.1Yes Yes YesGoldRavener 
    ShowArch Linux x86_64Jan 15 20227.0-rc5-stagingYes Yes YesGoldSpooker 
    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 YesGoldAet456 
    ShowUbuntu 20.04 "Focal" (+ variants like Kubuntu)Dec 31 20205.0.3Yes Yes YesSilverAet456 
    ShowFreeBSD 12.2Dec 31 20205.0.3Yes No NoGarbageStreamNet 
    ShowManjaro Linux 20.1Sep 19 20205.16Yes Yes YesGoldJames 
    ShowantiX-19 x64-core "Marielle Franco"Sep 05 20205.16Yes No NoGarbageEliza Semeniuk 
    ShowUbuntu 20.04 "Focal" (+ variants like Kubuntu)Aug 16 20205.15Yes Yes NoPlatinum13122002 
    ShowPop!_OS 20.04 LTSOct 03 20205.0.2Yes Yes YesGoldDaemonWhite 
    CurrentZorin OSJan 29 20204.0.3Yes Yes NoSilverSultan Iskandar Maulana 
    ShowUbuntu 19.04 "Disco" amd64 (+ variants like Kubuntu)Sep 06 20194.0.2Yes Yes YesSilverselfisekai.rocks 
    ShowUbuntu 18.04 "Bionic" amd64 (+variants like Kubuntu)Aug 02 20194.0.1Yes Yes YesGoldYuki Snowy 
    ShowArch Linux x86_64Apr 04 20194.5No, but has workaround Yes YesGoldYudha 
    ShowSolusMay 09 20194.1Yes Yes NoSilverIvan Pavluk 
    ShowUbuntu 18.04 "Bionic" amd64 (+variants like Kubuntu)Oct 20 20183.18-stagingYes Yes YesGoldPham Truong Thanh Trung 
    ShowUbuntu 18.10 "Cosmic" amd64 (+variants like Kubuntu)Nov 17 20183.0.3Yes Yes YesSilverCONBlaze 
    ShowLive Wifislax 1.1Sep 02 20183.14-stagingYes Yes YesSilverEne 
    ShowArch Linux x86_64Aug 05 20183.13Yes Yes YesGoldAet456 
    ShowUbuntu 17.04 "Zesty" amd64 (+ variants like Kubuntu)Nov 08 20172.20Yes Yes YesGoldAet456 
    ShowUbuntu 17.10 "Artful" amd64 (+variants like Kubuntu)Nov 04 20172.19-stagingNo, but has workaround Yes YesBronzeMikołaj Karaś 
    ShowUbuntu 17.04 "Zesty" amd64 (+ variants like Kubuntu)Oct 24 20172.19Yes Yes YesGoldAet456 
    ShowUbuntu 17.04 "Zesty" amd64 (+ variants like Kubuntu)Sep 24 20172.17Yes Yes YesSilverAet456 
    ShowUbuntu 17.04 "Zesty" amd64 (+ variants like Kubuntu)Sep 01 20172.15Yes Yes YesSilverkiroma 
    ShowmacOS 10.12 "Sierra"Jun 24 20172.10Yes Yes NoGoldfacespkz 
    ShowElementary OS LokiJun 23 20172.10Yes Yes NoSilverLilacse 
    ShowArch Linux x86_64Apr 28 20172.6Yes Yes NoGoldDustin Bosveld 
    ShowUbuntu 16.10 "Yakkety" amd64 (+ variants like Kubuntu)Jul 16 20161.9.14Yes Yes NoGoldan anonymous user 
    ShowArch LinuxMar 13 20161.9.4Yes Yes NoSilveran anonymous user 
    ShowUbuntu 14.04 "Trusty" i386 (+ variants like Kubuntu)Feb 26 20161.8.1Yes Yes NoGoldhto 
    ShowUbuntu 15.10 "Wily" amd64 (+ variants like Kubuntu)Jan 10 20161.9.1Yes Yes NoGoldKamil 
    ShowMac OS X 10.11 "El Capitan"Nov 20 20151.7.54Yes Yes NoSilverMagic NAT 
    ShowGentoo Linux x86_64Feb 06 20151.7.33Yes Yes NoGoldEichhorn 
    Showelementary OS Freya BetaDec 29 20141.7.33Yes Yes NoGoldan anonymous user 
    ShowLinux Mint 17 "Qiana" x86_64Oct 31 20141.7.29Yes Yes NoGoldan anonymous user 
    ShowArch Linux x86_64Oct 27 20141.7.29Yes Yes NoGoldLara Maia 
    ShowUbuntu 14.04 "Trusty" i386 (+ variants like Kubuntu)Sep 20 20141.7.26No, but has workaround Yes NoSilverNate 
    ShowArch Linux x86_64Jun 15 20141.7.19Yes Yes NoGoldAlex 
    ShowUbuntu 14.04 "Trusty" amd64 (+ variants like Kubuntu)May 14 20141.7.18Yes Yes NoGoldan anonymous user 
    ShowUbuntu 14.04 "Trusty" amd64 (+ variants like Kubuntu)Apr 04 20141.7.15No, but has workaround Yes NoGoldSean Rhone (Espionage724) 
    ShowDebian GNU/Linux 8.x "Jessie" x86_64Jan 03 20141.7.9No, but has workaround Yes NoSilveran anonymous user 
    ShowopenSUSE 13.1Nov 30 20131.7.6No, but has workaround Yes NoSilverSean Rhone (Espionage724) 
    ShowUbuntu 13.04 "Raring" amd64 (+ variants like Kubuntu)Sep 18 20131.7.1No, but has workaround Yes NoSilverSean Rhone (Espionage724) 
    ShowGentoo Linux x86_64Dec 17 20131.6No, but has workaround No NoGarbagean anonymous user 
    ShowUbuntu 13.04 "Raring" amd64 (+ variants like Kubuntu)Apr 13 20131.5.28No, but has workaround Yes NoSilverSean Rhone (Espionage724) 
    ShowUbuntu 12.10 "Quantal" amd64 (+ variants like Kubuntu)Apr 10 20131.5.27No, but has workaround Yes NoSilverSean Rhone (Espionage724) 
    ShowUbuntu 12.10 "Quantal" amd64 (+ variants like Kubuntu)Apr 10 20131.4.1No, but has workaround Yes NoSilverSean Rhone (Espionage724) 

    Known Bugs

    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
    32342 Multiple applications and games using 'Webkit', 'Blink' or 'CEF' (libcef) web browser engine crash on startup ('Arial' and 'Times New Roman' font face name validation) STAGED 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) CLOSED FIXED View
    56794 Mono error when trying to run Osu NEW View

    Show open 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