osu-skin-configurator

Project Overview

osu! Skin Configurator is a Windows desktop tool for osu! skins that creates "presets" of skin changes and switches between them instantly. It bundles skin.ini edits, file copies, and file deletions into a named preset applied with one click or a global hotkey, removing manual ini editing and backup/restore cycles. The tool is built with Tauri v2 and ships as a standalone exe with no installation.

A desktop tool that turns osu! skin changes into one-click presets.

Key Features

• Preset system: bundle ini edits, file moves/deletions, and image processing into named presets stored per skin in config.osp
• Group tree: organize presets into nested groups with drag-and-drop reordering
• One-click apply: select presets, confirm, and apply, or bind global hotkeys for instant switching
• Global hotkeys: per-preset global shortcuts that fire only when osu! is focused
• Drag-and-drop editing: drag into groups, drag to delete, duplicate shortcuts, and smart grouping
• Image editor: tint, crop, and darken pipeline with a live WebGL tint preview and batch generation of long bodies
• Sequence-frame grouping: auto-group numbered frames and treat them as a unit in copy and tint operations
• Rebindable shortcuts: all in-app actions have customizable hotkeys plus a dedicated global-shortcut manager view
• Borderless window: custom titlebar with Windows 11 Snap Layout support
• Auto update: check for new releases on startup with a download progress ring on the titlebar

Target Audience

• Players who change osu! skins frequently
• Creators who batch-process skin images and ini files
• Users who want to switch skin configs instantly with hotkeys
• Developers interested in Tauri desktop tools

Quick Start

1. Download osu-skin-configurator.exe from Releases
2. Launch it; the tool auto-detects your osu! installation
3. Select a skin in the left sidebar and click the pencil button to enter edit mode
4. Create a preset group and a preset, then add ini edits or file operations
5. Save, switch back to use mode, hover to preview, and click to apply

Core Advantages

• One-click switching: turns tedious skin changes into reusable presets
• No manual ini editing: type-aware field editing reduces mistakes
• Global hotkeys: fire only when osu! is focused for crisp switching
• No installation: a standalone exe that works out of the box

System Requirements

Item	Requirement
OS	Windows 10 / 11 (osu! stable is Windows-only)
Runtime	WebView2 Runtime
Build from source	Rust stable and Tauri CLI v2
Target app	An installed osu! client

Notes

• All preview images and file sources are stored as skin-relative paths for portability
• App configuration is written to the system AppData directory
• Adding a new language requires submitting translation files per the localization guide