README.md

osutool

multipurpose tool for osu! files

Summary

Provides utility for compiling and extracting osu!-related filetypes.

• 🐍 Supports Python 3.8 and above. Tested on Windows 10.
• 🚧 Work in progress. Features are not finalised and may be unstable.
• 🔃 Pull requests are welcome!
• ⭐ Show your support by leaving a star!

osutool is not affiliated with osu!. For official information about osu!, visit osu.ppy.sh.

Contents

• Summary
• Contents
• Features
• Installation
• Usage
  • Compilation (folders to files)
  • Extraction (files to folders)

Features

• convert beatmap/song folders to .osz files, and vice versa
• convert skin folders to .osk files, and vice versa

Installation

python -m pip install --upgrade osutool

Usage

Open a command line from the directory with the files you want to manipulate, then run osutool.

$ osutool

 [NOTICE]  | Mode is not set.
 [INPUT]   | Set mode to [c]ompile or [e]xtract. > _

Compilation (folders to files)

> c

The program will create a file for every applicable folder and subfolder. Files generated from subfolders will be placed in the same subfolder.

Each file will be named after the folder it was created from.

Extraction (files to folders)

> e

The program will generate a folder for every file in the current folder and its subfolders. Folders generated from subfolders will be placed in the same subfolder.

Each folder will be named after the file it was created from.