Skip to main content


Mapping Tools currently only runs on Windows. The web-based version is there for all platforms but is still in development.


Mapping Tools can be downloaded from the downloads page or from the GitHub releases.


Download and run the installer. Go through all the steps and finish the installer. Mapping Tools will then be installed.

The installer automatically installs any dependencies that may be required for Mapping Tools to work.


Download the portable version .zip file and extract all of the contents into a folder. You can then open Mapping Tools.exe.


In order to run, you need to have installed .NET Desktop Runtime 5 with the same architecture as your version of Mapping Tools. That means you need to install x64 .NET if you downloaded x64 Mapping Tools and you need to install x86 .NET if you downloaded x86 Mapping Tools.


You can find an early preview of web-based Mapping Tools here. This version works on all platforms.

Still in early stages of developement

Many of the tools are still missing and there are likely a lot of bugs. If it doesn't load, try reloading the page with Shift-F5 and clear the cache.


Once you have installed Mapping Tools, click the button in the top left to open the navigation menu and go to Preferences to configure Mapping Tools.

The most important fields to set are the following:

  • osu! folder: path to the folder containing osu!.
  • Songs folder: path to the folder containing all your maps. It's typically directly inside the osu! folder.
  • osu! config user file: path to your osu! user configuration file. It's typically directly inside the osu! folder with the filename osu.[username].cfg.

Make sure these fields are correct, as Mapping Tools may not work properly otherwise.

Last updated on by OliBomby