Report a bug

How can I report a bug?

You can report a bug by opening a new issue in our GitHub repository. Alternatively you can also do so in the #bug-reports channel on our discord server, but we highly encourage everyone to use GitHub instead because it's much more organized.

When making a bug report, please use the following format:

  • A clear and concise description of what the bug is.
  • Steps we can use to reproduce the bug, for example:
    • Go to X.
    • Enable Y.
    • Do Z.
    • etc.
  • Additional information. This can be a video and/or a screenshot showing the issue. You can also attach game and Event Viewer logs (we really appreciate that so please attach them if possible!). Of course, feel free to leave out any sensitive or personal information.

How do I get the game logs? (osu!)

Note: you should do all of this BEFORE the crash, because osu! clears the log files on each launch.

  • Launch osu!.
  • Go to the Options and click Open osu! folder button.
  • Find the Logs directory in the window that opens.
  • runtime.log file is the log you need to include.

How do I get the Event Viewer logs? (osu!)

  • After osu! has crashed, press Win + R to open the run box.
  • In the run box type eventvwr and press Enter. This will open the Event Viewer.
  • In Event Viewer, on the left, click Windows Logs and then Application.
  • On the right, click Filter current log.
  • On the filter window that opens, make sure you have the Error box checked and click OK.
  • Press Ctrl + F and type osu! in the find box. It will find the first crash log from osu!.
  • Go into the Details tab, expand System and Event Data by clicking on each of them.
  • Copy the text from there and paste it into your bug report.