osu!

What works

Solo Mode

Multi Mode

Adding beatmap file directly to osu! by clicking .osz file and select run with osu!

Sound

Sign in osu! account

Control Music, Effect, and Master with the arrow keys

Control Music, Effect, and Master with scroll wheel

Select beatmap and select song with the arrow keys in Solo Mode

Delete beatmap from in game

Run osu! updater

What does not

"An occurred! Please check your internet connection" when installing osu!

Workarounds

Install dotnet40

What was not tested

Song Editor

Hardware tested

Graphics:

• GPU: Nvidia
• Driver: proprietary

Additional Comments

Last update: 2019-05-03.

Recommended readings:

• Ultimate guide to low-latency osu! on Linux by Franc[e]sco
• Low-latency osu! on Linux by The Poon
• osu-wine by Forefront

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:

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.

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! doesnt't recognize internet connection and you have internet connection, install 32-Bit GNUTLS Package. In Arch Linux,

sudo pacman -S lib32-gnutls