Personal tools
Please be aware that the osu!wiki will be moving to GitHub.
You won't be able to edit articles soon so make sure to learn how to use GitHub.
Go to the new home of the osu!wiki

Osu! File Formats

From osu!wiki
Jump to: navigation, search
Other Languages

Français  Русский  Bahasa Indonesia  中文  Deutsch  한국어  Polski  Português 


osu!-specific file format

File format Usage
.osz Executable beatmap file.
.osk Executable skin file.
.db Cached information.
Beatmap Editor
.osu Compose, Timing, Song Setup.
.osb Design.
.osr Executable replay file (cannot be decompressed).

Osu!sys os.png Creating .osz/.osk file

.osz/.osk file is a file extension tailored specifically for osu!.exe. When opened, .osz file will be extracted by osu!.exe and transferred to "Songs" folder while .osk will be extracted and transferred to "Skins" folder. By default, beatmap files downloaded directly from the official website generally be in .osz file format. Creating a .osz/.osk file is a fundamental knowledge for beatmapping/storyboarding and skinning community respectively.

From an archiver

Software needed:-

  • File archiver (WinRAR, 7zip)
  • osu! (For testing purpose and osu! icon)


  1. Compile your files into a folder (.mp3, .flv, .osu, SB, etc. into the folder). Name the folder.
    For explanation purpose, folder will be named "Amigo Fiesta".
  2. Right-click the folder and choose to archive the folder (Add to archive...).
    You can also choose to open the File archiver software first and drag-and-drop the folder in.
  3. Inspect the settings. Set archive method as ".zip" (not .7z, .rar) and rename the folder file extension to .osz manually in the text box.
    Amigo Fiesta.zip -> Amigo Fiesta.osz, Archive method: ".zip"
  4. Allow the archive process. An .osz file will be produced as end product along with the distinctive osu! icon for the file.
  5. Rinse and repeat for new copy. For skinning, use .osk extension.

Picture examples (credit to MLGnom's Skinning tutorial)

From the game

Software needed:-

  • osu! (and nothing else, since the game can make .osz/.osk files)


  1. Like above, compile your files into a folder and name it.
    Usually, if you edited the beatmap before, everything will be ready to be converted to .osz. For skins, you must compile the files before.
  2. Open osu!.
  3. If you want to make a .osz, then:
    • Go to "Edit" and choose the beatmap you want to convert to .osz.
    • Open "File", then "Export Package..."
    • The .osz will be produced and placed in the "Exports" folder of the osu! folder.
  4. If you want to make a .osk, then:
    • First, make sure your skin has everything you want to compile. You can check by clicking "Open Skin Folder" if you're using the skin to convert.
    • Then, in the "Options" menu, click on "Select Skin".
    • On the skin selection screen, choose the skin you want and click on "Export as .osk".
    • The .osk will be produced and placed in the "Exports" folder of the osu! folder.

Contents of
Getting Started Registration Installation Newbie's guide Game Interface Options Hit Objects
osu! Game Styles Basic explanation Multi-play
External ports » osu!stream osu!droid opsu! osu!wp T-Aiko Beats
External clients » osu!tourney osu!MapDownloader
World of osu!
Miscellaneous » Mascots osu!academy osu!talk
Beatmap Editor Compose / Design (Scripting) / Timing / Song Setup

Beatmapping Beat Snap Divisor / Distance Snap Custom Sample Overrides Kiai Time Mapping Techniques Skinning Skin.ini Storyboarding

Online Editing
and Ranking
Beatmap forum Submission Beatmap Approval (How to Get Your Map Ranked) Modding (Getting Your Map Modded) Music Theory Audio Editing Kudosu / Star Priority
People The Team Administrators/Global Moderation Team Quality Assurance Team Beatmap Nomination Group Language Moderators osu! Alumni Support Team Community Contributors List of notable people