Skip to content

README.md

Latest commit

 

History

History
143 lines (94 loc) · 3.92 KB

README.md

File metadata and controls

143 lines (94 loc) · 3.92 KB

AI slop. polluting the environment so you can see fullalt %

osu!Taiko Replay Analyzer

Visualize and analyze osu!Taiko replays. Detects playstyle (full-alt / singletap / hybrid), tracks BPM comfort zones, shows pattern weak spots, and builds per-player profiles across many replays.

Windows

  1. Install Python 3.11+ from https://www.python.org/downloads/ — tick "Add Python to PATH" during setup.

  2. Double-click run.bat — it sets everything up on first launch.

That's it. Every launch after that goes straight to the app.

Linux

You need: Python 3.11+ and pygame 2.x

Install pygame via your package manager (python3-pygame) or pip (pip3 install pygame), then run:

python3 main.py

Setup

Songs folder

The app needs your osu! Songs folder (or osu! lazer files/ directory) to load beatmaps.

It tries to detect the location automatically. If that fails, it will prompt you once — enter the path and it saves to config.txt.

You can also set it manually by opening config.txt and editing the line:

songs_folder = C:\Users\you\AppData\Local\osu!\Songs

Common locations:

Stable (Songs folder)

  • Windows: %LOCALAPPDATA%\osu!\Songs
  • Linux: ~/.local/share/osu-wine/osu!/Songs

Lazer (files directory)

  • Windows: %APPDATA%\osu\files
  • Linux: ~/.local/share/osu/files

Replays

To open a single replay, put the .osr file in the same folder as the app and run. If there is only one .osr file it opens automatically — if there are multiple you will be asked to pick one.

To import many replays at once into profiles, use --mass-add (see below).

Usage

python3 main.py [replay.osr] [options]

Windows: replace python3 with python, or just use run.bat.

Options

  • (no arguments) — auto-detects a single .osr in the current folder
  • replay.osr — open a specific replay file
  • --songs <path> — override the Songs / lazer files folder for this run
  • --portable — run without a Songs folder (playstyle analysis only, no beatmap data)
  • --profile — open the profile viewer
  • --profile "Name" — open a specific player's profile directly
  • --create-profile "Name" — create a new player profile
  • --create-profile "Name" --layout DDKK — create profile with a specific key layout
  • --create-profile "Name" --aliases "Alt,Old" — create profile with username aliases
  • --mass-add — scan a folder of replays and import them into matching profiles
  • --delete-profile "Name" — delete a player profile

Profiles

Profiles store replay history and aggregate stats across sessions.

# Create
python3 main.py --create-profile "PlayerName"
python3 main.py --create-profile "PlayerName" --layout DDKK

# Import many replays at once
python3 main.py --mass-add

# Delete
python3 main.py --delete-profile "PlayerName"

Saved profiles are listed in config.txt. Profile data is stored at:

  • Windows: %APPDATA%\taiko-replay-analyzer\profiles\
  • Linux: ~/.local/share/taiko-replay-analyzer/profiles\

Key Layouts

  • KDDK — Kat · Don · Don · Kat (default)
  • DDKK — Don · Don · Kat · Kat
  • KKDD — Kat · Kat · Don · Don

Layout is set when creating a profile. Press [L] in the Profile Viewer → Playstyle tab to change it at any time.

Controls

Replay Viewer

  • Space — play / pause
  • ← → — seek ±5 seconds
  • Shift + ← → — seek ±30 seconds
  • D — toggle data panel
  • P — open player profile
  • Esc — quit

Profile Viewer

  • Tab — cycle tabs (Overview / Patterns / Playstyle)
  • ↑ ↓ — scroll
  • L — cycle key layout
  • Enter — open selected replay
  • Esc — back / quit

Skin

The skin/ folder holds the visual assets (notes, drum, hit results, lane background). These are standard osu! skin files — replace them with any skin you like. The app falls back to plain shapes if an asset is missing.