Wat is het OSZ-bestandsformaat?
Een .osz-bestand is een beatmap-pakket voor osu!, het gratis ritmespel ontwikkeld door Dean Herbert (peppy) en gedistribueerd door ppy Pty Ltd. Structureel gezien is een .osz-bestand een standaard ZIP-archief dat is hernoemd met de extensie .osz - door het terug te hernoemen naar .zip en het te openen met een archiefprogramma, wordt de inhoud onmiddellijk zichtbaar.
In een typisch .osz-pakket vindt u:
- Een of meer
.osubeatmap-definitiebestanden (UTF-8 tekst, interne formaatversie 14) - Een audiotrack, meestal
.mp3of.ogg - Een achtergrondafbeelding (
.pngof.jpg) - Optionele storyboard-scripts en aangepaste hitsound
.wavof.oggsamples
Wanneer de osu!-client een .osz-bestand opent, pakt deze het archief automatisch uit in de map „Songs” en registreert alle inbegrepen moeilijkheidsgraden. Beatmaps worden gedistribueerd via de osu!-website; het klikken op een downloadlink daar zorgt ervoor dat de client het bestand direct importeert. De osu!lazer-client, die in 2024 de stabiele status bereikte, accepteert ook .osz-imports op Windows, macOS, Linux, Android en iOS.
De integriteit wordt geverifieerd met CRC-32 checksums per ZIP-item en MD5-hashes per .osu-bestand, waarbij de laatste wordt gebruikt om scores te valideren die naar het online ranglijstsysteem worden verzonden. Pakketgroottes variëren doorgaans van 2 MB tot 150 MB, afhankelijk van de audiolengte en het aantal inbegrepen moeilijkheidsgraden.
Beveiliging & veiligheid
RISICO: LOWOSZ-bestanden bevatten alleen audio, afbeeldingen en tekstgebaseerde .osu-bestanden - geen uitvoerbare bestanden. Laag risico. Download alleen van de officiële site osu.ppy.sh om geknoeide bestanden te voorkomen. Community-mirrorsites bundelen .osz-bestanden soms met downloaders vol adware - gebruik de in-game download van de officiële osu!-client of de officiële website.
Formaatdetails
in een notendopProgramma's die OSZ-bestanden openen
Windows2 apps
osu!
Gratis Dubbelklik op het .osz-bestand; osu! importeert en extraheert het automatisch naar de map „Songs”. 
7-Zip
Open-source Rechtermuisklik → Archief openen (behandelen als ZIP) om de inhoud te inspecteren zonder osu! te installeren. 
macOS1 app
osu! (lazer)
Gratis Download osu!lazer voor macOS; Bestand → Importeren van, selecteer het .osz-bestand. 
Linux1 app
osu! (lazer)
Gratis Download osu!lazer voor macOS; Bestand → Importeren van, selecteer het .osz-bestand. 
Android1 app
osu!lazer (Android)
Gratis Installeer osu!lazer via Google Play of de osu!-site; open het .osz-bestand om te importeren.
osu!lazer (iOS)
Gratis Installeer osu!lazer via de App Store; gebruik de Bestanden-app om .osz te openen en over te dragen naar osu!lazer. Technische details
diepe specificaties| Containerformaat | Standaard ZIP-archief; magic bytes `50 4B 03 04` op offset 0, identiek aan elk `.zip`-bestand |
| Intern beatmap-formaat | `.osu` UTF-8 tekstbestanden; huidige interne formaatversie 14 (sinds 2013); oudere mappen kunnen versies 9-13 gebruiken |
| Audio-codering | MP3 (128-320 kbps) of OGG Vorbis (128-192 kbps) is gebruikelijk; er wordt geen strikte coderingslimiet opgelegd door het formaat |
| Afbeeldingsformaat | PNG of JPEG voor achtergrondkunst; geen opgelegde resolutielimiet |
| Compressie | DEFLATE per item (ZIP); audio- en afbeeldingsbestanden worden vaak opgeslagen met de ZIP STORED-methode (ongecomprimeerd) |
| Beatmap-integriteit | MD5-hash per `.osu`-bestand gebruikt voor online ranglijstvalidatie; CRC-32 per ZIP-item (standaard ZIP) |
| Typische pakketgrootte | 2 MB - 150 MB afhankelijk van audiolengte en aantal inbegrepen moeilijkheidsgraden |
| Typisch aantal bestanden | 10-50 bestanden per pakket: één `.osu` per moeilijkheidsgraad plus gedeelde audio-, achtergrond- en hitsound-assets |
| MIME-type | `application/x-osu-beatmap-archive` (geregistreerd door osu!-client); `application/zip` wordt ook geaccepteerd |
| Platformondersteuning | Windows, macOS, Linux (osu!stable en osu!lazer); Android en iOS (osu!lazer, stabiel sinds 2024) |
| Importgedrag | osu!-client extraheert automatisch naar de map „Songs” bij het openen van het bestand; geen handmatige extractie vereist door de gebruiker |
| Optioneel storyboard | `.osb` storyboard-script of inline storyboard-sectie in `.osu`; aangepaste scripttaal voor animaties en effecten |
| Hitsound-samples | WAV- of OGG-audiobestanden gebundeld in het pakket; overschrijven standaard spelgeluiden per beatmap |
| Byte-volgorde | Little-endian (standaard ZIP-structuur) |
| Uitgebracht | 2007 (osu! initial release, September 2007) |
| Laatste versie | N/A (format has not been versioned externally; osu! file format v14 internally for .osu files) |
| Specificatie | osu.ppy.sh |
OSZ conversies
Community V&A
gevraagd door gebruikersNog geen vragen - wees de eerste om iets te vragen over OSZ-bestanden.
