ekgame/osu-heatmap

osu! beatmap heatmaps

This project is a website to generate beatmap heatmaps where lighter spots have more objects and darker spots have less.

Check out the website

Description

This is a useful tool for aspiring mappers to check the playfeld usage of a beatmap and to see how cool maps with playfield gimmicks look.

Supports loading .osu and .osz files and loading beatmap sets from the official osu! website by beatmap link.

Running locally for development

Prerequisites:

• Node v21 - that's the version I worked with, but other versions might work too

Setup:

1. Clone the repository.
2. Open the project in a terminal.
3. Run npm install to install dependencies.
4. Copy .env.example to .env and fill out the enviroment variables.
5. Run npm run dev to launch the server in development mode.

Version history

• 1.0
  • Initial release
  • Loading .osu and .osz files
  • Loading from URL
  • Loading from examples

Acknowledgments

• osu-classes, osu-parsers and osu-standard-stable - does the heavy lifting of parsing beatmaps and approximating slider paths.
• The website uses Nuxt for client and server.
• tinygradient - used for the color gradients.