MapWizard

osu! beatmap toolset for Windows, Linux, and macOS, built with C#/.NET 10 and Avalonia.

Install

Linux and macOS:

You can install MapWizard by running the following command:

curl -fsSL https://mapwizard.maot.dev/install | bash

or grab the latest release manually.

Windows

You can install MapWizard by downloading and running the .exe installer from the latest release.

Current Tools

• HitSound Copier
• Metadata Manager
• Combo Colour Studio
• Map Picker
• HitSound Editor (beta)
• Map Cleaner

Projects

• MapWizard.Desktop: Avalonia desktop app (main application).
• MapWizard.Theme: Custom Avalonia theme for the app.
• MapWizard.Tools: core tooling logic.
• MapWizard.CLI: soon-to-be command-line interface for the app.
• MapWizard.Tests: test suite.

Requirements

• .NET SDK 10.0.0 or later (see global.json).
• Velopack CLI (vpk) for release packaging.
• NativeAOT toolchain for release builds:
  • Windows: Visual Studio 2022 with the "Desktop development with C++" workload.
  • Linux: clang and zlib headers (sudo apt-get install clang zlib1g-dev on Debian/Ubuntu).
  • macOS: Xcode command line tools.

Run from Source

git clone https://github.com/maotovisk/MapWizard.git
cd MapWizard
dotnet restore
dotnet build
dotnet run --project MapWizard.Desktop

Optional software rendering fallback:

dotnet run --project MapWizard.Desktop -- --software-rendering

Or set the environment variable:

MAPWIZARD_FORCE_SOFTWARE_RENDERING=1 dotnet run --project MapWizard.Desktop

Tests

dotnet test MapWizard.Tests/MapWizard.Tests.csproj

Credits and Special Thanks

• OliBomby's Mapping Tools for inspiration.
• The original Map Wizard (Tauri/Svelte implementation).
• osu! file format docs.
• ppy/osu for reference.
• OsuMemoryDataProvider (Windows memory reader dependency).
• hwsmm/cosutrainer for Linux osu! memory reading reference.

Contributing

Issues and pull requests are welcome. For questions, help, and updates, join the Discord.