Guide

1. Prerequisites

  • Windows PC
  • beatmania IIDX INFINITAS installed and running
  • An infst account

2. Account Setup

Go to the registration page and create your account with an email, username, and password.

3. CLI Setup

Download infst.exe from the latest GitHub Release. Place it in a directory of your choice.

4. CLI Login

Run the following command to authenticate your CLI:

infst login

A device code will be displayed. Open the verification URL in your browser, log in to your infst account, and enter the code to authorize the CLI. You can override the endpoint with --endpoint <URL>.

5. Real-time Tracking

Start INFINITAS, then simply run:

infst

The CLI automatically detects the game process, reads your play data in real time, and uploads results to the server after each song.

6. Sync Data

Sync all your play data directly from game memory to the server:

infst sync

This reads all scores, lamps, and miss counts from the running game and uploads them in one step. Safe to run multiple times — the API is idempotent.

7. Data Export

Export all your play data (scores, lamps, miss counts, DJ points) from the game:

infst export -o scores.tsv

Use -f json for JSON format.

8. Web Features

  • View your clear lamps on difficulty tables
  • Real-time updates as you play
  • Public/private profile toggle in Settings