2025-11-18 22:01:44 -08:00
2025-11-09 20:33:11 -08:00
2025-11-18 22:01:44 -08:00
2025-11-12 03:05:47 -08:00
2025-06-29 11:49:28 -07:00
2025-11-08 00:22:59 -08:00
2025-10-08 17:08:27 -07:00
2025-11-04 15:19:55 -08:00

Mirage

Mirage is a self-hostable "rhythm" game score tracker that doesnt rely on predefined seeds or chart metadata. It preseves your scores across games, even niche ones.

https://github.com/user-attachments/assets/e1a03b39-3c6f-4d31-8a4e-7ae9abaa93a2 https://github.com/user-attachments/assets/63341f3b-991c-4147-8014-30f27020dc05

Features

  • Import & Track Scores Keep a safe backup of your game scores.
  • Add Any Game Works with any rhythm game, even without official metadata.
  • Self-Host or Go Solo Use locally or host for group score tracking. Multi-user system.
  • Presets - Comes pre-loaded with tracking functionality for various rhythm games

Default Supported Games

  • DANCERUSH
  • DANCE aROUND
  • Project DIVA Arcade: Future Tone
  • MUSIC DIVER
  • Nostalgia
  • REFLEC BEAT
  • Taiko no Tatsujin Arcade

Note

Basically stuff that isn't supported by Tachi (yet?), you should use it for all the other games it does support

⚠️ Warning: Work in progress

Development

Install dependencies:

pnpm install:all

Create a .env file in backend based on backend/.env.template. Fill in the fields as required.

Setup and Initialize Database:

pnpm db-init

Create a .env file in frontend based on frontend/.env.template

  • If you did not change the port of the API in the backend env file. Then your VITE_API_URL is http://localhost:5000/api

Start Frontend and Backend

pnpm dev

Stack

  • React Typescript
  • Express
  • Prisma ORM
  • Postgres

You're welcome to join my personal instance, but I make no guarantees about the integrity of data if something goes catastrophically wrong.

Description
Mirage is a self-hostable "rhythm" game score tracker that doesn’t rely on predefined seeds or chart metadata
https://mirage.pinapelz.com/
Readme AGPL-3.0 7.4 MiB
Languages
TypeScript 88.4%
JavaScript 11.4%
HTML 0.2%