What is an OSR file?
An OSR file is a game replay file created by the osu! game. Osu! is a rhythm game where users match mouse clicks with the music. The song played by the user, hits and misses, time and date of song played, and overall ranking is recorded in the OSR file. This OSR file can then be shared with others for replay purpose. OSR file requires the beatmap file to be present in the “Songs” folder.
MIME Type of OSR File Format: x-osu-replay
OSR File Format
OSR files are saved as binary files with fixed as well as variable length data fields.
| Data Type | Format |
|---|---|
| Byte | Game mode of the replay (0 = osu! Standard, 1 = Taiko, 2 = Catch the Beat, 3 = osu!mania) |
| Integer | Version of the game when the replay was created (ex. 20131216) |
| String | osu! beatmap MD5 hash |
| String | Player name |
| String | osu! replay MD5 hash (includes certain properties of the replay) |
| Short | Number of 300s |
| Short | Number of 100s in standard, 150s in Taiko, 100s in CTB, 100s in mania |
| Short | Number of 50s in standard, small fruit in CTB, 50s in mania |
| Short | Number of Gekis in standard, Max 300s in mania |
| Short | Number of Katus in standard, 200s in mania |
| Short | Number of misses |
| Integer | Total score displayed on the score report |
| Short | Greatest combo displayed on the score report |
| Byte | Perfect/full combo (1 = no misses and no slider breaks and no early finished sliders) |
| Integer | Mods used. See below for list of mod values. |
| String | Life bar graph: comma separated pairs u/v, where u is the time in milliseconds into the song and v is a floating point value from 0 - 1 that represents the amount of life you have at the given time (0 = life bar is empty, 1= life bar is full) |
| Long | Time stamp (Windows ticks) |
| Integer | Length in bytes of compressed replay data |
| Byte | Array Compressed replay data |
| Long | Online Score ID |
| Double | Additional mod information. Only present if Target Practice is enabled. |
Key Characteristics of OSR Files
| Characteristic | Description |
|---|---|
| File Extension | .osr |
| Primary Variants | osu! Replay Files (gameplay recordings), Windows System Restore Files (crash diagnostics), Personal Backup Files (data backup archives) |
| Format Type | Binary data format with multiple variants; osu! variant features a structured header followed by compressed replay data (keyframes and input streams); Windows variant contains memory dumps and crash diagnostics |
| Primary Use | Recording and replaying osu! gameplay sessions, storing Windows system crash diagnostic information, and backing up personal data through third-party software |
| Main Feature | Comprehensive gameplay recording capturing every cursor movement, click, and keypress with precise timing; enables performance analysis, community sharing, and technique improvement for rhythm game players |
| Security Profile | Safe for intended use; osu! variant contains no executable code; Windows variant may contain sensitive system information; not intended for manual editing; specialized tools required for safe viewing and analysis |
| Compatibility | osu! variant requires osu! game client (Windows, macOS, Linux) to play; can be analyzed using osu! Replay Editor (web-based); Windows variant requires WinDbg or Visual Studio for analysis; backup variant requires specific backup software |
How to Open and Work with OSR Files
Opening osu! Replay Files
To open an OSR replay file in osu!:
Launch the osu! game client
Go to the main menu
Select the “Replays” section
Choose “Import Replay”
Navigate to and select the .osr file
The replay will load and begin playing automatically
Alternatively, you can use osu! Replay Editor—a web-based tool that provides in-depth analysis and viewing of OSR replay files.
Frequently Asked Questions (FAQ)
Q1: What does OSR stand for in osu!?
A1: OSR stands for osu! Replay, which is the file format used to record and store gameplay sessions in the osu! rhythm game .
Q2: How do I open and watch an OSR replay file?
A2: You can open an OSR file by launching osu! and importing the replay through the Replays section, or by using the osu! Replay Editor web tool .
Q3: Can I convert an OSR replay file to a video format?
A3: Yes, you can convert OSR replay files to video by using screen recording software to capture the replay playback in osu! or using specialized conversion tools .
Q4: What information is stored inside an osu! OSR file?
A4: An OSR file stores cursor movements, click timing, keypresses, score data, accuracy, combo information, and beatmap details for a gameplay session .
Q5: Can I open a Windows System Restore OSR file with a text editor?
A5: No, Windows OSR files are binary crash dump files and will display garbled characters if opened in a text editor. They should be analyzed using debugging tools like WinDbg .
