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.

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

Release Builds

Packaging scripts are in MapWizard.Desktop/:

• build-linux.sh
• build-osx.sh
• build-win.sh
• build-win.bat

MapWizard.Desktop/Assets/mapwizard.svg is the source for the app logo and all packaged icons. After changing it, regenerate the PNG, ICO, and ICNS files with python3 MapWizard.Desktop/Assets/generate-app-icons.py (requires rsvg-convert and Pillow) before building a release.

Config and Data Paths

Settings file: MainSettings.ini

• Windows: %APPDATA%\MapWizard\MainSettings.ini
• macOS: ~/Library/Application Support/MapWizard/MainSettings.ini
• Linux: $XDG_CONFIG_HOME/MapWizard/MainSettings.ini (fallback: ~/.config/MapWizard/MainSettings.ini)

Combo Colour Studio local projects:

• Windows: %APPDATA%\MapWizard\ComboColourStudio\projects.json
• macOS: ~/Library/Application Support/MapWizard/ComboColourStudio/projects.json
• Linux: $XDG_DATA_HOME/MapWizard/ComboColourStudio/projects.json (fallback: ~/.local/share/MapWizard/ComboColourStudio/projects.json)

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.