osu!

About

osu! draws on Japanese rhythm games such as Konami's Beatmania IIDX series (from 1999), Namco's Taiko no Tatsujin drum series, and iNiS's 2005 Nintendo DS game Osu! Tatakae! Ouendan, in which players tap on-screen markers in time with music. osu! is a free-to-win rhythm game, and this repository holds "lazer", the open-source client its developers call the final iteration of the game. It is built on .NET and ships releases for Windows, macOS, Linux, Android and iOS (via TestFlight). It is under constant development and intended to eventually replace the older "osu!stable" client.

How it differs from the original

Rather than a single fixed game mode, osu! lets developers create custom "rulesets", new gameplay variations that reuse its beatmap library and engine. It uses its own assets, and no files from any original game are needed.

Getting started

Download the latest release for your platform from the GitHub releases page or the official osu! site; iOS builds go through a TestFlight link that often fills up. To build from source, install the .NET SDK and run the desktop project from an IDE or the command line.

Media

Additional notes

License

The code and framework are MIT-licensed, but the osu! and ppy branding is trademarked and the game resources are under a separate licence.

Contributing

The project states that issue reports or pull requests created or aided by AI/LLM tools will typically be closed and locked without discussion.