Skip to content

A program to analyze misses in an osu! replay

Notifications You must be signed in to change notification settings

ThereGoesMySanity/osuMissAnalyzer

Repository files navigation

osu! Miss Analyzer

GitHub all releases GitHub release (latest by date)

A program to analyze misses in an osu! replay.

Credit for the beatmap and replay parsing and analysis code goes to firedigger from his osu! replay analyzer.

How To Use

First, edit the options.cfg file and specify your osu! directory (the one with osu!.db in it) and/or the songs directory.

After that, you can run the program by double-clicking the icon or dragging a replay file on to the exe. If you didn't specify a replay file manually, you can select from the five most recent replays found in your osu! directory (saved or otherwise). After this, it'll search your osu!db to find the corresponding beatmap, or open a file chooser dialog if it couldn't find osu!.db.

After it's found the beatmap and replay, it'll analyze the misses and display them in an interactive window.

Examples

chocomint's first Blue Zenith choke chocomint's second Blue Zenith choke

The line is your cursor movement. The arrows are the direction of the cursor. The color changes show the hit window of the focused note. The small hollow circles along the line are the points where there was a click. These are also colored to reflect the note's hit windows (300 is blue, 100 is green, 50 is purple). The tiny red circle is placed at the center of the 300 hit window - perfect accuracy.

Controls

Key Action
Up Arrow/Scroll Up Zoom in
Down Arrow/Scroll Down Zoom out
Right Arrow/Left Mouse Next miss
Left Arrow/Right Mouse Previous miss
T Draw outlines only
P Save images for each miss
R Select new replay
A Switch between viewing only misses and viewing all objects

Outlines only example:

Options

In options.cfg, you can define various settings that impact the program.

To add these to options.cfg, add a new line formatted <Setting Name>=<Value>

Setting Description
OsuDir Specify the osu! directory. Make sure that osu!.db is in here. If the program takes a while to start, please add this option.
SongsDir Specify osu!'s songs dir. Only necessary if it isn't OsuDir/Songs.
APIKey osu! API key
WatchDogMode Enable watch dog mode, in which newest replays in OsuDir are loaded as they appear.
ColorScheme Changes the program's color scheme. Accepted values are Default or Dark

Alternate Usage

You can also run it from the command line with this format: osuMissAnalyzer.exe [<replay> [<beatmap>]]