osu!lazer

Resources

osu! is a free-to-win, cross-platform rhythm game. osu!lazer is the open-source client intended to eventually replace the legacy osu! client, which is only available for Windows and macOS.

Installation

License

Installing games-arcade/osu-lazer requires accepting the all-rights-reserved license.

USE flags

USE flags for games-arcade/osu-lazer A free-to-win rhythm game and a final iteration of the osu! game client

`+pipewire`	Use pipewire to enable sound output
`debug`	Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces

Data provided by the Gentoo Package Database · Last update: 2025-05-30 22:13 More information about USE flags

Note
Sound will still be possible (through ALSA) without PipeWire; the pipewire use flag merely configures the build to use it.

Emerge

Important
As of 20 May 2025, games-arcade/osu-lazer will build the developer build of osu!, and thus it will have a watermark informing the user of this at the bottom of the main menu. Users wishing to avoid this may consider using the AppImage, as documented below.

root #emerge --ask games-arcade/osu-lazer

Alternative: AppImage release

lazer is also provided as a pre-built AppImage.

FUSE is required to run the AppImage. See the instructions at FUSE to set up AppImage support if not already present.

Required old-format AppImage package

Important
As of 20 May 2025, osu!'s AppImage requires sys-fs/fuse:0, and won't run using just sys-fs/fuse.

In order to be able to run the osu!lazer AppImage, the below emerge will be required:

root #emerge --ask sys-fs/fuse:0

If a distrubution kernel is being used, then this step should be sufficient by itself for being able to run osu!. (Otherwise, FUSE support will simply also need to be enabled within the kernel.)

AppImage download

user $wget https://github.com/ppy/osu/releases/latest/download/osu.AppImage

user $chmod +x osu.AppImage

user $./osu.AppImage

Installation

Warning
Doing the below install will overwrite the executable installed by games-arcade/osu-lazer, so should only be done if the package was not already installed.

To imitate the installation to /usr/bin provided by games-arcade/osu-lazer, one can copy the AppImage over:

root #install osu.AppImage /usr/bin/osu-lazer

Legacy client

The old osu! client (i.e., not lazer) is only natively supported on Windows and macOS. Users have reported success running it with Wine, however, so users who would prefer to stick to the old, and still more popular, client may attempt to run the Windows build available from the osu! website.