osu! stable installer for Linux with patched wine-osu and other features.

• Installation
  • Prerequisites
    • Drivers
    • PipeWire
  • Installing osu!
• Features
• Troubleshooting
• Flags
• Steam Deck Support
• Credits

The only real requirement is actually git, as the script will install the rest itself. You can easily get it like this:

Ubuntu/Debian: sudo apt install -y git

Arch Linux: sudo pacman -Sy --needed --noconfirm git

Fedora: sudo dnf install -y git

openSUSE: sudo zypper install -y git

Gentoo: sudo emerge --noreplace dev-vcs/git

As obvious as this might sound, installing drivers the right way is needed to have a great experience overall and avoid poor performance or other problems.

Keep in mind that osu! needs lib32 drivers in order to run as it should, so if you're having performance problems, it's probably related to this.

Please make sure to follow the instructions below:

• Installing Drivers

PipeWire isn't really a dependency but is highly recommended, especially with this script.

Check if it's already on your system with:

export LANG=C
pactl info | grep "Server Name"

If it shows Server Name: PulseAudio (on Pipewire) , then you're good to go.

Otherwise, make sure to install it following the instructions at here:

• Installing PipeWire

git clone https://github.com/NelloKudo/osu-winello.git
cd osu-winello
chmod +x ./osu-winello.sh
./osu-winello.sh

## OR

## If you wanna install without dependencies
./osu-winello.sh --no-deps

## If you want a clean install without tweaks (advanced)  (--no-deps also works here)
./osu-winello.sh --basic

You can now launch osu! with:

osu-wine

• You might need to relaunch your terminal to launch the game.
• Use -40/35ms offset to make up for Wine quirks (or -25 if you're using audio compatibility mode)

• Comes with updatable patched wine-osu binaries with the latest community patches for low-latency and crashes.
• Automatic install of dependencies on most distros (apt, pacman, dnf, zypper..)
• Provides osu-handler for importing maps and skins, Discord RPC with winestreamproxy and support for native file managers!
• Supports gosumemory for streaming etc. with automatic install! (Check flags!)
• Installs osu! on either default or custom path (using GUI), also working for already existing osu! installations from Windows!
• Skips the pain of downloading prefix stuff thanks to my fork of osu-wineprefix
• Support for installing Windows fonts (fix for Japanese and special characters)
• Support for old distros (binaries built on GLIBC 2.27)
• Support for Lutris

Please refer to osu-winello's wiki for troubleshooting of any type.

If that doesn't help, either:

• Write me on Discord (marshnello)
• Join ThePooN's Discord, you might learn even more there hehe

Installation script:

./osu-winello.sh: Installs the game
./osu-winello.sh --no-deps: Installs the game but skips installing dependencies
./osu-winello.sh --basic: Installs the game with only dotnet40 and w/o tweaks
./osu-winello.sh uninstall: Uninstalls the game

Game script:

osu-wine: Runs osu!
osu-wine --winecfg : Runs winecfg on the osu! Wineprefix
osu-wine --winetricks: Install packages on osu! Wineprefix
osu-wine --regedit: Opens regedit on osu! Wineprefix
osu-wine --kill: Kills osu! and related processes in osu! Wineprefix
osu-wine --kill9: Kills osu! but with wineserver -k9
osu-wine --update: Updates wine-osu to latest version
osu-wine --w10fonts: Installs Windows 10 fonts from GitHub for osu! (Needed for JP characters etc.)
osu-wine --fixprefix: Reinstalls the osu! Wineprefix from system
osu-wine --info: Troubleshooting and more info
osu-wine --remove: Uninstalls osu! and the script
osu-wine --lutris: Copies wine-osu to lutris and shows instructions to add osu! there
osu-wine --changedir: Changes directory of the install according to the user
osu-wine --devserver <server>: Runs osu on the specified devserver
osu-wine --fixfolders: Reinstalls registry keys for native file manager in case they break
osu-wine --fixsteamdeck: Reinstalls game dependencies after SteamOS updates
osu-wine --gosumemory: Installs and runs gosumemory without any needed config!

Since osu! runs on Wine, you can play that on Steam Deck as well!

It is recommended to not manually install PipeWire on the Steam Deck as it is already installed by default and attempting to do so may cause audio issues.

Before using the script, make sure to:

• Set a password using the passwd command
• Disable read-only filesystem with sudo steamos-readonly disable

If you need help with pacman or just want reliable info, check these two links: Link 1 -- Link 2

The script will handle the rest itself, but you might need to reinstall dependencies after every Deck update (read more here); you can simply do that with:

osu-wine --fixsteamdeck

Special thanks to:

• ThePooN's Discord
• gonX's wine-osu
• Integrating native file manager by Maot
• KatouMegumi's guide
• hwsnemo's wine-osu
• diamondburned's osu-wine
• openglfreak's packages

And that's all. Have fun playing osu!