Skip to main content

osutool

multipurpose tool for osu! files

version status downloads

license python

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

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.

Metadata

Release files for osutool 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for osutool 0.1.3
File Size Uploaded Provenance Actions
osutool-0.1.3.tar.gz 5.2 kB Without provenance Details for osutool-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for osutool 0.1.3
File Interpreter ABI Platform Actions
osutool-0.1.3-py3-none-any.whl Python 3 none any Details for osutool-0.1.3-py3-none-any.whl

Total release size: 11.2 kB

Release files / osutool-0.1.3.tar.gz

Download URL osutool-0.1.3.tar.gz
Size 5.2 kB
Tags Source
SHA-256 checksum
How to use checksums
45c0e59f30b526b342e1c050549aba7d23c8e39ffe5612613076679d4375fafe
BLAKE2b-256 checksum
How to use checksums
02b6b400e538036e5420ec0e29b1abed53386d4187d31d4e0dc4fd2e343d94bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.9.19

Release files / osutool-0.1.3-py3-none-any.whl

Download URL osutool-0.1.3-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d3009958b4d14396e6ba6a855e807bb7f498cf2860e897214b83bdfd645f76e7
BLAKE2b-256 checksum
How to use checksums
fd841d20189007a5817890626e8aa23e3e99d439e6583b71dcd0dc996d40b5f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.9.19

Security for osutool 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page