OSZ File - osu! Beatmap File Format, How to Create & Open It?
What is an OSZ file?
An OSZ file is a compressed file format used by the rhythm game osu! to store beatmap data. Beatmaps are essentially levels for the game, and they include information such as the song, the beat timing, and the placement of hit objects on the game screen. OSZ files allow for easy distribution of beatmaps and are typically downloaded from the internet and imported into the game. OSU! also has the OSR file format that is a game replay file and can be replayed by game players.
MIME Type of OSR File Format: x-osu-replay
OSZ File Format
The internal file format details of OSZ file types are not available publicly. It contains ZIP-compressed data that has information to play the music, show graphics, and display players about the events when they must interact with the game.
Key Characteristics of OSZ Files
| Characteristic | Description |
|---|---|
| File Extension | .osu |
| Primary Variants | Standard osu! beatmap files (all game modes), osu!taiko beatmap files (Taiko mode), osu!catch beatmap files (Catch the Beat mode), and osu!mania beatmap files (Mania mode) |
| Format Type | Plain text file using the INI file format with section-based organization; stores beatmap data in human-readable format; includes [General], [Editor], [Metadata], [Difficulty], [Events], [TimingPoints], and [HitObjects] sections |
| Primary Use | Defining all gameplay elements for an osu! rhythm game beatmap; stores timing data, hit object placements, difficulty settings, song metadata, and visual event information |
| Main Feature | Highly customizable plain text format enabling precise beatmap creation and editing; supports four distinct game modes (osu!, Taiko, Catch the Beat, Mania); includes detailed hit object definitions with support for circles, sliders, spinners, and long notes |
| Security Profile | Safe for game use; contains no executable code; can be safely edited with any text editor; human-readable format allows for direct modification and fine-tuning of beatmap parameters |
| Compatibility | Native to osu! game client (Windows, macOS, Linux); can be edited with any text editor; OSZ packages contain the OSU file along with audio (MP3/OGG) and image (JPG/PNG) assets; can be converted to other rhythm game formats using community tools |
How to Create OSZ File?
OSU! has detailed instructions for creating OSZ and OSK files. The following steps can be used to create an OSZ file using OSU!.
- Open a beatmap via the editor.
- From the top menu, select File > Export package….
- The .osz archive will be placed in the Exports folder inside the osu! folder.
How to Open and Work with OSU Files
Opening OSU Files in osu!
OSU files are automatically used when playing a beatmap in osu!:
Install an OSZ file by double-clicking it
The game extracts the OSU file and associated assets
Select the beatmap from the song selection menu
The OSU file provides the gameplay instructions
Editing OSU Files
To edit an OSU file:
Extract the OSU file from the OSZ archive
Open the file with any text editor (Notepad++, Visual Studio Code, etc.)
Modify the desired sections and values
Save the file and test the changes in osu!
Creating New OSU Files
New OSU files are typically created using the osu! beatmap editor:
Launch osu! and open the beatmap editor
Select a song file
Use the editor to place hit objects
The editor generates the OSU file automatically
Share the beatmap set as an OSZ file
Converting OSU Files
OSU files can be converted to other formats using specialized tools:
osu! to StepMania – Convert to SM format
osu! to Quaver – Convert to QS format
Frequently Asked Questions (FAQ)
Q1: What does OSU stand for in the osu! game?
A1: OSU stands for osu! beatmap, which is the file format used to store all gameplay data for a playable beatmap in the rhythm game .
Q2: How do I open and edit an OSU file?
A2: You can open and edit OSU files with any text editor like Notepad, Notepad++, or Visual Studio Code, as they are stored in plain text using the INI format .
Q3: What is the difference between an OSU file and an OSZ file?
A3: An OSU file is the beatmap file containing gameplay data, while an OSZ file is a ZIP archive containing the OSU file along with audio and image assets .
Q4: Can I create an OSU file without using the osu! game?
A4: While you can create OSU files manually with a text editor, it is much easier to use the built-in beatmap editor in osu!, which generates the file automatically .
Q5: What game modes are supported by OSU files?
A5: OSU files support four game modes: standard osu! (clicking circles), Taiko (drumming), Catch the Beat (fruit catching), and Mania (keyboard rhythm) .