wiki

Common problems

Quick fixes for the problems players run into most. For a message the game shows you, see Error messages. Still stuck? Ask in our Discord.

osu!(stable) and the Somtum Patcher

Relax, Autopilot or the pp counter don't work

The Somtum Patcher adds Relax and Autopilot scores, the live pp counter and its own options to osu!(stable) by changing the game while it runs. Each osu! update can move the code it changes, so on some builds a feature doesn't switch on. You might see no Relax/Autopilot scores, no pp counter, or a message that a feature has been disabled for your osu! build.

Try the cuttingedge release stream. In osu!, open Options → General → Updates, set Release stream to Cutting Edge, let osu! update, close it, and start it again from the Somtum Patcher or the Somtum Launcher. If it still doesn't work, tell us on Discord which osu! version you're on (it's shown under Options → General → Updates) and which feature is missing.

osu! freezes, shows a black screen, or won't close after starting

  1. Close osu! from Task Manager (Ctrl + Shift + Esc, then End task on osu!).
  2. Get the newest Somtum Patcher from the download page, or let the Somtum Launcher update itself.
  3. Start osu! again from the Patcher.
  4. Still freezing? Try the cuttingedge release stream, and tell us on Discord.

My antivirus removed or blocked the Patcher or pkms.dll

Some antiviruses (Windows Defender among them) flag tools that change a running game, so they sometimes block the Somtum Patcher or our anti-cheat, pkms.dll, by mistake. Download it again from the download page and add an exception for its folder. Without the anti-cheat your scores aren't submitted.

ReShade or another shader tool

They aren't allowed: they put their own opengl32.dll, d3d9.dll or dxgi.dll next to osu!.exe, the way some cheats load. Delete that file from your osu! folder (see Playing with the Somtum Patcher).

Linux (Wine): osu! closes while starting

A first start under Wine can be slow. If you see "osu! did not finish starting within 10 seconds", just start it again: the second start is usually quick. See the error message.

TumThai

My osu!lazer beatmaps, skins and replays aren't there

TumThai keeps its own files, apart from osu!lazer's. See bringing your osu!lazer beatmaps and replays.

"Score will not be submitted"

Usually your TumThai is out of date: an installed TumThai updates itself, or download it again from the download page. The message says why underneath; see Why didn't my score submit?.

Old clients (2008 to 2015)

The old client won't start

Old builds need .NET Framework 3.5 (a few 2015 builds need .NET Framework 4). On Windows 10 and 11, turn it on in Control Panel → Programs → Turn Windows features on or off → .NET Framework 3.5. Keep pkms.dll next to osu!.exe, or your scores aren't submitted.

Accounts

"This is a new device" when logging in

Confirm the device on the verification page (sign in to this website first), then log in again. See the error message.