Welcome to difficalcy

Difficalcy is a simple HTTP API interface for the official osu! difficulty calculators.

Basic usage

Run the server:

docker run -p 5000:80 ghcr.io/syriiin/difficalcy-osu:latest

Call the API:

curl "localhost:5000/api/calculation?BeatmapId=658127"

Get your lazer powered calculations:

{
  "accuracy": 1,
  "combo": 2402,
  "difficulty": {
    "aim": 3.4715033440194416,
    "speed": 3.4738667283055444,
    "flashlight": 0,
    "total": 7.25543964698689
  },
  "performance": {
    "aim": 220.83646290283872,
    "speed": 231.26239294786578,
    "accuracy": 142.3199671239901,
    "flashlight": 0,
    "total": 614.5217398659557
  }
}

See Getting Started for a full example setup.