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 on Windows. It needs .NET Framework 4.5+ to work.

There are also Beta and Cutting edge release streams that allow to test the latest development features. However they change frecuently and older versions of them get rapidly obsolete. Its compatibility level on Wine is currently 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: 4.0.3

Maintainers: About Maintainership

Free Download osu!install.exe

Test Results

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

    Known Bugs

    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

    Show all bugs

    HowTo / Notes

    Minimal Installation Guide

    Last update: 2019-05-03.


    Recommended readings:


    This section describes some minimum steps required to run osu! in vanilla Wine. Other sections have additional information to improve user experience. For practical purposes, winetricks is used (it's not mandatory since you can install .NET Framework manually but it requires more steps), so first get the latest version:

    $ wget 'https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks'
    $ chmod +x ~/winetricks


    1) Create a new 32-bit Wine prefix:

    $ env WINEARCH=win32 WINEPREFIX=$HOME/.wineosu wineboot --init

    If Wine prompts for installing Mono, click Cancel.


    2) Install .NET Framework 4.5:

    $ env WINEPREFIX=$HOME/.wineosu ~/winetricks dotnet45


    3) 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'

    BUG 44184: If the installer stuck in an endless loop, close it and then:

    $ > 'osu!/discord-rpc.dll'
    $ env WINEPREFIX=$HOME/.wineosu wine 'osu!/osu!.exe'

    This will create a dummy discord-rpc.dll and try to start osu! again.


    4) Creating a shortcut: 

    Create a new plain text file and put the following:

    [Desktop Entry]
    Exec=env WINEPREFIX=$HOME/.wineosu wine ~/osu\\!/osu\\!.exe
    Name=osu!
    Type=Application
    Icon=«path_to_an_osu_logo_here»
    Terminal=0

    Save this file as osu!.desktop in ~/.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-01-05.


    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 very 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.


    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 shuttering.


    Please 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.


    Other known problems:

    • My system is frozen!: if osu! freezes and you lose 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+F7 (or Ctrl+Alt+F1 on some systems) to return to your desktop environment.


    • I started osu but my cpu usage is at 100% and nothing happens: same as frozen system. Open a terminal and execute 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 and go to your osu! folder. Open the osu!.«user».cfg file, find the Fullscreen and Letterboxing options and set them to "0", then find the Width and Height options and set them to a value lower than your monitor's resolution:
      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!.

    If osu! Doesn't Recognize Your Internet Connection

    If osu! doesnt't recognize internet connection and you have internet connection, install 32-Bit GNUTLS Package. In Arch Linux,

    sudo pacman -S lib32-gnutls

    Comments

    The following comments are owned by whoever posted them. WineHQ is not responsible for what they say.

    Workaround for sound crackling or no sound with the new sound engine
    by Nguyen Chinh Huu on Sunday January 5th 2020, 7:28
    With the new osu!stable release with use WASAPI rather than the legacy DirectSound but have better (lower) latency, you might experiencing sound crackle or no sound. If that is the case, try setting the environment variable PULSE_LATENCY_MSEC=40 (or lower if your hardware handle that).
    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.
    RE: Workaround for sound crackling or no sound with the new sound engine
    by Invictus Tiberius on Sunday January 5th 2020, 10:19
    Tested on neon (ubuntu bionic), winehq-devel 5.0~rc4.

    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.
    osu! will not run and results in a NET framework error
    by Micah Jinkerson on Saturday December 14th 2019, 22:46
    When running osu! with the provided command in the HowTo, Im given the following error: i.imgur.com/th3ECEu.jpg

    I've tryed changing the WINE version to everything above XP but it still results in the same.
    RE: osu! will not run and results in a NET framework error
    by Micah Jinkerson on Saturday December 14th 2019, 22:55
    Forgot to say im running xfce ubuntu 16.04 with WINE version 4.0.3
    RE: osu! will not run and results in a NET framework error
    by Invictus Tiberius on Thursday December 19th 2019, 4:05
    Cannot replicate the bug. Just tested on Ubuntu 18.04 and Arch with wine-stable 4.0.3 and wine-staging 5.0-rc1 and it's working fine.
    osu! shortcut not working
    by Jason on Thursday September 12th 2019, 3:00
    the command for making the shortcut will not work.
    osu! folder in Application data in C drive not found
    by Jason on Thursday September 12th 2019, 2:33
    I have directed to C:\users\user\Local Settings\Application Data\ and i don't seem to find the osu! folder, did i miss a step?
    RE: osu! folder in Application data in C drive not found
    by Invictus Tiberius on Wednesday September 18th 2019, 11:22
    By following these steps:

    $ 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!'
    osu! show a black screen on Arch Linux
    by Nguyen Chinh Huu on Monday August 19th 2019, 22:23
    If osu! just show a black screen but there is music playing in the background or it doesn't run at all, and output an X error, try installing lib32-libxcomposite
    RE: osu! show a black screen on Arch Linux
    by Invictus Tiberius on Wednesday August 21st 2019, 21:11
    Just tested on Arch and it works. Thanks for the info. Adding to Troubleshooting section.
    Japanese Font
    by Nguyen Chinh Huu on Monday April 29th 2019, 9:36
    If you want to use GDI+ to fix the graphical glitches, you can still have osu! render Japanese using Meiryo fonts through winetricks: winetricks meiryo.
    If you have installed cjkfonts or fakejapanese_vlgothic, you have to use --force flag to install it.
    RE: Japanese Font
    by Invictus Tiberius on Wednesday May 1st 2019, 4:08
    Just tested and seems to work for most Japanese characters but not all. Anyway it's a better solution that doing nothing so I will add it to de guide. Thanks for the info.
    RE: Japanese Font
    by Nguyen Chinh Huu on Wednesday May 1st 2019, 10:19
    Try changing the language of the game to Japanese (日本語) (the forth selectionn), and they will be displayed correctly. Maybe on other languages, the game thinks it is Chinese and try using Chinese font for them if there aren't any Japanese-only character.

    by Gage Johnson on Friday January 4th 2019, 11:44
    I get a 403 forbidden when winetricks tries to install dotnet462. Any help on a solution?
    RE:
    by Invictus Tiberius on Saturday January 5th 2019, 16:37
    Try installing dotnet45; it's enough for osu!stable.
    Gnome intellihide panels showing up
    by André on Friday November 9th 2018, 11:23
    On gnome desktop, sometimes (randomly) when i alt+tab the game, both panels (that were set to intellihide) were showing up if i touch the edge of the screen. To fix this just run the game on a virtual desktop with your fullscreen resolution.
    Game is laggy and crashes.
    by Robert on Thursday August 2nd 2018, 11:01
    Everything was going well up until today when I wanted to play osu!, and it has a lot of lag spikes which make it unplayable. A few seconds into a map, or even barely loading the map, the game crashes.
    RE: Game is laggy and crashes.
    by Robert on Thursday August 2nd 2018, 11:22
    Since I play osu! on a Seagate Expansion Drive, I thought of the fact that the USB was loose. So, I retightened it and it works perfectly! :)))))))))))))
    New bug?
    by Ena on Sunday June 3rd 2018, 12:21
    I followed the instructions above and osu downloaded and installed properly, but on the first open it displays a message saying "osu was unable to obtain a graphics context. If this is the first time you've seen this please try restarting your PC. If this is a fresh install, you may be missing graphics drivers."
    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.
    RE: New bug?
    by Invictus Tiberius on Tuesday June 12th 2018, 8:44
    Hi. This usually happens when there's no graphics hardware available. Verify you have correctly installed graphic drivers. I can't replicate this on my PC, so search for some info on google. You can also check Franc[e]sco's guide; he updated the guide some time ago and it is very complete.
    Crashes when type korean characters in game
    by Ian Snyder on Thursday May 3rd 2018, 1:05
    osu! freezes when I type any Korean characters on osu! settings and beatmap search. However, It didn't freeze in bancho.
    I'm using Ubuntu 18.04 LTS and Wine 3.0 from ubuntu repository.

    Have any idea of this problem?
    fixes graphical & font glitches
    by osaka-takumi on Wednesday May 2nd 2018, 11:11
    install Windows fonts on Linux
    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
    ssssorry nevermind got it aaa
    cant get framework
    by bbadadadadad bitch on Thursday April 26th 2018, 16:06
    whenever i try to dowloaded it just fails on me, of course i open the dowloader on wine but since the machine i have doesnt work with it, cant seem to have it.
    help;
    osu!direct
    by osaka-takumi on Thursday February 22nd 2018, 5:44
    osu!direct is very goood working
    osu install problem
    by Supashake YT on Wednesday February 21st 2018, 23:35
    When I the osu installer is downloading osu, after the download countdown for what folder you want to put it in is done, it says 'An error occurred, please check you internet connection' even though my internet connection is fine

    by Howard Zhang on Sunday January 21st 2018, 9:57
    How do I launch it. Running osu!.exe doesn't work
    RE: How to launch the game
    by Invictus Tiberius on Sunday January 21st 2018, 11:42
    Hi. osu! should create a shortcut when installing but if it is not your case, use the following command:

    $ 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.
    RE: How to launch the game
    by Howard Zhang on Monday January 22nd 2018, 20:16
    Hey it did create a shortcut in the folder where osu! was installed. But when I click it, my mouse does the spiny thing and then it just stops.

    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
    RE: How to launch the game
    by Howard Zhang on Monday January 22nd 2018, 20:22
    I just checked task manager and it says it's running, but it doesn't pop up. But I should also tell you that after initial installation, osu ran fine. It was only after I closed it out it wouldn't pop up again. I would usually just use the env WINEPREFIX=$HOME/.wineosu wine 'osu!install.exe' command to get it up and running again but it stopped working so I don't know.

    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.
    RE: How to launch the game
    by Invictus Tiberius on Wednesday January 24th 2018, 11:15
    Hi, sorry for answering late. I updated the guide by adding an additional step explaining How to create a shortcut for osu! I hope it would be useful. If you can't still launch osu!, ask again. Anyways, I will try to explain some details here:

    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"
    Back