Konamate: Running Konaste games on Linux

Important

YOU MUST HAVE A LEGAL SUBSCRIPTION TO PLAY THESE GAMES. THIS TOOL DOES NOT ALTER ANY GAME FILES.

This is a simple, customizable helper tool for launching コナステ (konaste) games on Linux. This tool aims to be “simple,” not “one‑click easy.” You’ll need to perform the required setup manually following the guide, but in return you gain the flexibility to customize the configuration to your liking and work with future dependencies updates.

Currently, it supports the following games:

Warning

I only regularly play INFINITAS, SDVX, and GITADORA. For other games, I’ve only verified that they launch.

How it works

Konaste games authenticate your subscription in the browser, then launch the game launcher via a custom URL scheme that includes an authorization token. Since the standalone executable won't run by itself, traditional launchers like Lutris cannot be used. Konamate uses Patchright to authenticate with a stored passkey, captures the launch URL, and starts the game with the necessary environment variables. Desktop URL association is available as an optional alternative.

Prerequisites

Modern Linux distribution
Google Chrome, Chromium, Brave, Microsoft Edge, or Vivaldi supported by Patchright, and a system keyring
umu-launcher and it's dependencies
- I recommend using Proton via umu‑launcher. Since Proton containerizes all the dependencies that Wine requires, it can run reproducibly on any system.
- But you can also launch Wine directly if you prefer.
Recommended using atty303/proton-ge-custom to fix audio delay issues
Optional desktop integration requires desktop-file-install and notify-send. ImageMagick can provide game icons.

I’m using Bazzite, and the minimal setup in this guide works out of the box without any extra system settings.

Installation

Download the latest release from the GitHub releases page and install it using the following command:

cp ~/Downloads/konamate-x86_64-unknown-linux-gnu ~/.local/bin/konamate
chmod +x ~/.local/bin/konamate

or install it with ubi.

ubi -p atty303/konamate -e konamate -i ~/.local/bin

Upgrading from Konaste

The executable and application data locations changed in Konamate. After installing the new executable, copy your existing configuration and browser state to the new locations:

konamate migrate

Existing files in the new locations take precedence, and legacy data is left unchanged. Keyring entries are copied from the legacy service when first used. Wine prefixes and desktop URL associations are not migrated. If you use the optional desktop integration, run konamate <game> associate again for each configured game, then remove the old executable when it is no longer needed.

Minimal steps to launch the games

Konamate automatically detects a compatible Chromium browser and saves its path when a browser command is first used. To detect and save it in advance, run:

konamate config --detect

Use konamate config --browser /path/to/chromium when automatic detection does not find the intended browser.

Register a passkey with the virtual authenticator. Complete the registration on the KONAMI account page opened by the command:

konamate browser register-passkey

You need to prepare the PulseAudio sink that configured sample rate to 44100Hz for the game audio output. For example, you can use the following command to create a loopback sink temporarily:

pw-loopback -m "[ FL FR ]" --capture-props='media.class=Audio/Sink node.name=konamate-sink node.description=Konamate audio.rate=44100'

To persist the sink, you can configure PipeWire configuration.

beatmania IIDX INFINTAS

Click to expand the steps

Run the following command to configure and create the wine prefix:

konamate infinitas config --env.PROTONPATH=GE-Proton10-9 --env.PULSE_SINK=konamate-sink
konamate infinitas exec umu-run wineboot --init

Download the installer from the official website (you need to log in to your account).
Run the following command to install it:

konamate infinitas exec WINEDLLOVERRIDES="ieframe=d" umu-run msiexec /i ~/Downloads/infinitas_installer_2022060800.msi

Authenticate and launch the game:

konamate infinitas run

After the launcher is started, click the UPDATE button to update the game.
After the update is complete, click the SETTING button and set audio output to WASAPI (共有モード)(Shared Mode).

[!WARNING] Wine does not support WASAPI Exclusive Mode on winepulse.drv(PulseAudio), so you must use Shared Mode.

After the audio output is set, click the ゲーム起動 button to launch the game.

SOUND VOLTEX EXCEED GEAR

Click to expand the steps

Run the following command to configure and create the wine prefix:

konamate sdvx config --env.PROTONPATH=GE-Proton10-9 --env.PULSE_SINK=konamate-sink
konamate sdvx exec umu-run wineboot --init

Download the installer from the official website (you need to log in to your account).
Run the following command to install it:

konamate sdvx exec WINEDLLOVERRIDES="ieframe=d" umu-run msiexec /i ~/Downloads/sdvx_installer_2022011800.msi

Authenticate and launch the game:

konamate sdvx run

GITADORA

Click to expand the steps

Run the following command to configure the wine prefix:

konamate gitadora config --env.PROTONPATH=GE-Proton10-9 --env.PULSE_SINK=konamate-sink
konamate gitadora exec umu-run wineboot --init

Download the installer from the official website (you need to log in to your account).
Run the following command to install it:

konamate gitadora exec WINEDLLOVERRIDES="ieframe=d" umu-run msiexec /i ~/Downloads/GITADORA_installer.msi

Authenticate and launch the game:

konamate gitadora run

Usage

You can explore the available commands by specifying the --help option.

`konamate config`

This command displays or stores application-wide settings. With no options it only displays the saved settings. Use --detect to find a compatible browser and save its path, or --browser /path/to/chromium to save a path explicitly. Browser-related commands also accept --browser as a one-time override.

When no browser is configured, browser-related commands search PATH, the user Flatpak exports, and the system Flatpak exports for Google Chrome, Chromium, Brave, Microsoft Edge, or Vivaldi, in that order. The detected path is saved for future use. An existing setting is never replaced automatically; use konamate config --detect to detect again.

`konamate ls`

This command lists the available games that can be managed by this tool.

You can add new games by creating a game definition file in the ~/.config/konamate/games.json file. Format of the game definition file is as defaultGames in the src/games.ts. Additional properties used by %{key} placeholders must have string values. Invalid JSON and values that do not match the game definition schema are reported with their field path.

`konamate <game> config`

This command configures the environment for the specified game. If user configuration is not initialized, it will create with the default configuration.

konamate infinitas config: Shows the current configuration for the game.
konamate infinitas config --env.NAME=<value>: Sets the environment variable NAME to value. Use this to set umu-launcher, Proton or Wine environment variables.

`konamate <game> profile`

This command manages the profiles for the specified game. Profiles are used to configure the command to run the game when launching from browser. Some default game definitions have preconfigured profiles for running the game directly without launcher.

konamate infinitas profile: Lists the available profiles for the game.
konamate infinitas profile --default: Unsets the default profile. If no profile is set as default, selection will be prompted when launching. This is stored as "runProfile": null in the game configuration.
konamate infinitas profile <name> --command <command>: Creates or updates a profile with the specified name and command.
konamate infinitas profile <name> --delete: Deletes the specified profile.
konamate infinitas profile <name> --default: Sets the specified profile as the default profile. The profile must already exist or be created by the same command.

Placeholders are expanded everywhere they occur in a profile command. Values inserted by %u, %t, %r, and %{key} are shell-escaped before the command is executed. Placeholders cannot be nested inside shell expansions such as $(), ${}, backticks, or process substitutions.

Configuration files are validated when read. A missing configuration is treated as uninitialized, while malformed JSON, invalid fields, and I/O errors are reported instead of being replaced with defaults.

You can use the following placeholders in the command string:

%u: URL passed to the game.
%t: Token from the URL.
%r: Installation directory as windows format (e.g. C:\Games)
%{key}: The value of the game definition key.
- %{id}: The game ID (e.g. 'infinitas', 'sdvx', etc.).

`konamate <game> associate`

This command registers the URL scheme for the specified game in the desktop environment. It is optional and allows a regular browser to launch the game through a desktop entry.

`konamate <game> exec <...command>`

This command executes the specified command with configured environment variables.

konamate infinitas exec umu-run winetricks <verbs>: Runs Winetricks with the specified verbs.
konamate infinitas exec umu-run winecfg: Opens the Wine configuration dialog.

`konamate <game> run [url]`

Without a URL, this command authenticates in the configured browser, captures the game launch URL, and executes the selected profile. Use --profile NAME to override the default; when a terminal is available, Konamate prompts if several profiles are available and none is selected.

With a URL, it launches the selected profile directly. Desktop entries created by associate use this form with --notify.

Tweaks for better performance

Enable ntsync

ntsync runs faster than the existing esync or fsync methods. It requires Linux kernel 6.14 or newer, and becomes available when /dev/ntsync exists.

To enable ntsync, run the following command:

konamate infinitas config --env.PROTON_USE_NTSYNC=1

Use gamescope

To run the game with gamescope, you can use the following command to configure the profile:

konamate infinitas profile gamescope --command "gamescope -f -r 120 -w 1920 -h 1080 --mangoapp -- umu-run %r\\game\\app\\bm2dx.exe -t %t" --default

To revert this configuration when game update is required, you can run:

konamate infinitas profile launcher --default

Setup low latency audio with PipeWire

Use PipeWire as the audio server for low latency audio with flexible routing and maximum compatibility.

Click to expand the setup steps

Configure linux side audio settings for low latency audio:

~/.config/pipewire/pipewire.conf.d/90-low-latency.conf:

context.properties = {
  default.clock.rate = 48000

  # If possible, switch the entire graph to 44.1 kHz to suppress resampling.
  default.clock.allowed-rates = [ 44100, 48000 ]

  # Reducing it lowers latency, but increases CPU load and makes the audio more prone to dropouts.
  default.clock.quantum = 32
  default.clock.min-quantum = 32
  # Set it to twice the minimum.
  default.clock.max-quantum = 64
  default.clock.quantum-limit = 64
}

~/.config/pipewire/pipewire-pulse.conf.d/90-rt.conf:

context.modules = [
  {
    name = libpipewire-module-rt
    args = {
      nice.level = -20
      rt.prio = 99
    }
  }
]

Configure a dedicated virtual audio device for games:

~/.config/pipewire/pipewire.conf.d/90-infinitas.conf:

context.modules = [
  {
    name = libpipewire-module-loopback
    args = {
      node.description = "Konamate Loopback"
      audio.position = [ FL FR ]
      capture.props = {
        node.name = "konamate-sink"
        media.class = "Audio/Sink"
        node.description = "Konamate Sink"
        device.description = "Konamate Sink"
        device.class = "sound"
        device.icon-name = "audio-card"
        node.virtual = false
        # IMPORTANT: Set the sample rate to 44100Hz for compatibility with Konaste games.
        audio.rate = 44100
        audio.channels = 2
      }
      playback.props = {
        node.name = "konamate-output"
        node.passive = true

        # You can specify the target audio output device here or leave it as default.
        # target.object = "alsa_output.pci-0000_c4_00.6.analog-stereo"
      }
    }
  }
]

Apply the configuration by running:

systemctl --user restart pipewire pipewire-pulse

Configure the game side audio buffer size to reduce latency:

konamate infinitas config --env.PULSE_LATENCY_MSEC=60

Lowering the value will reduce latency, but may cause audio dropouts if your system cannot handle it.

References

Since I was new to Linux’s audio system, I referred to the following.

Use ASIO in INFINITAS

INFINITAS supports ASIO output as a hidden feature. On Windows, follow the guide. You can enable it by adding the --asio option to bm2dx.exe. Wine can enable ASIO via wineasio, though I haven’t verified whether this actually reduces latency.

Troubleshooting

Locale issues

Maybe Koanste games expect the system to be configured for Japanese locale. If you encounter issues, try setting the locale to Japanese may help.

konamate infinitas config --env.LANG=ja_JP.UTF-8

Launching the game fails

After clicking the launch button, do not go back to the previous page. Doing so will cause the game launch authorization to fail.

INIFNITAS failed to start with audio device error

You need to set the audio output to WASAPI (共有モード) (Shared Mode) in the game settings.

INFIINITAS does not play sound

You need to provide audio output device that configured sample rate to 44100Hz.

Development

Activate mise.
Run mise install in the project root to install the dependencies.
Run mise run setup to install the git hooks.

Use mise run check for the fast formatting, linting, type, and unit test checks used during development. Run mise run test for all reproducible checks, including a compiled binary build. You can also run mise run build directly to build the CLI for the default architecture.

To install the tool from source, run the following command:

deno install -A --global -n konamate --config ./deno.jsonc src/main.ts

If you're not using the compiled binary, the tool cannot determine its own execution path. You must specify the --self-path option when running the associate command.

Live SDVX end-to-end test

The live test exercises the integrated Patchright login and launch flow and starts the installed game through umu/Proton. It is interactive, host-dependent, and intentionally separate from mise run check and CI.

Use an existing SDVX Wine prefix, but pass it explicitly so the test does not read or modify ~/.config/konamate. Patchright browser storage and the generated konamate configuration are isolated in a temporary directory. The existing passkey is read from the keyring.

mise run test:e2e:linux:sdvx -- \
  --wine-prefix /path/to/sdvx-prefix \
  --proton-path GE-Proton10-9

Use --game-env NAME=VALUE for additional game environment variables. Browser, audio sink, passkey entry, and result path can be selected with --browser, --pulse-sink, --passkey-service, --passkey-name, and --output.

The test asks for confirmation before accessing the account or launching the game. Proton and SDVX may update the selected prefix, shader caches, and game settings. After the game exits, confirm the title screen, audio, and physical controller behavior. Sanitized results are written under ${XDG_CACHE_HOME:-~/.cache}/konamate/e2e/ by default; launch URLs, authorization tokens, and passkey contents are not recorded.

Verified Configurations

Click to expand the verified configurations

All games

OS: Bazzite 42 Desktop Edition (KDE Plasma 6)
Browser: Firefox 140

beatmania IIDX INFINTAS

All game functionality has been tested on the following configurations:

Hardware: Minisforum UM790 Pro
- CPU: AMD Ryzen 9 7940HS (8C / 4.0 - 5.2 GHz)
- GPU: AMD Radeon 780M Integrated Graphics
- RAM: 64 GB
Audio: Sennheiser GSX1000 (7.1ch Virtual Surround)
Display:
- Primary: Hisense 43E7N 4K @120Hz via HDMI
- Secondary: Full HD Monitor @60Hz via USB-C
Controller: GAMO2 PHOENIXWAN+ LMT x2
Proton: GE-Proton10-9-wma

Although I’m using displays with different refresh rates, there’s no problem running at 120 fps. CPU load is around 10% and GPU load is around 70% during gameplay and streaming with OBS Studio. There’s no noticeable difference compared to running it on Windows 11 in a dual-boot setup.

SOUND VOLTEX EXCEED GEAR

All game functionality has been tested on the following configurations:

Hardware: Minisforum MS-A2
- CPU: AMD Ryzen 9 7945HX (16C / 2.5 - 5.4 GHz)
- GPU: AMD Radeon RX6400 (4GB)
- RAM: 32 GB
Audio: Creative Sound BlasterX G6 (7.1ch Virtual Surround)
Display:
- Primary: FHD @120Hz via HDMI
- Secondary: Full HD Monitor @60Hz via USB-C
Controller: SOUND VOLTEX CONSOLE -NEMSYS- Ultimate Model (2017)
Proton: GE-Proton10-9-wma

There’s no noticeable difference compared to running it on Windows 11 in a dual-boot setup.

Alternative configuration for performance testing

Hardware: Minisforum UM790 Pro
- CPU: AMD Ryzen 9 7940HS (8C / 4.0 - 5.2 GHz)
- GPU: AMD Radeon 780M Integrated Graphics (UMA 6GB)
- RAM: 64 GB
Audio: Sennheiser GSX1000 (7.1ch Virtual Surround)
Display:
- Primary: Hisense 43E7N 4K @120Hz via HDMI
- Secondary: Full HD Monitor @60Hz via USB-C
Proton: GE-Proton10-9

The backgrounds in VIVID WAVE—like “NOT YOUR IDOL”—are extremely GPU-intensive, driving GPU utilization up to around 95% and causing momentary drops to about 100 fps. This happens on Windows 11 too, so it’s simply a limitation of the Radeon 780M.

GITADORA

Drummania functionality has been tested on the following configurations:

Hardware: LENOVO ThinkCentre M715q
- CPU: AMD Ryzen 5 PRO 2400GE (4C / 3.2 - 3.8 GHz)
- GPU: AMD Radeon Vega 11 Integrated Graphics
- RAM: 8 GB
Audio: Onboard
MIDI Drums: Roland TD-1 (USB)
Proton: GE-Proton10-8

Game technical details

Click to expand the game technical details that I'm observiing when developing this tool

beatmania IIDX INFINTAS

Graphics API: Direct3D 9
Audio API: WASAPI (Shared Mode, Exclusive Mode), ASIO (Hidden feature)
- Requires 44100Hz sample rate
- Audio files are in WMAv2 format
- Media Foundation is used for decoding
Native resolution: 1920x1080
Maximum frame rate: 120 fps

SOUND VOLTEX EXCEED GEAR

Graphics API:
Audio API: WASAPI (Shared Mode, Exclusive Mode), ASIO, DirectSound
- Requires 44100Hz sample rate
Native resolution: 1920x1080
Maximum frame rate: 120 fps

GITADORA

Graphics API:
- Media Foundation for video decoding
Audio API: WASAPI (Shared Mode, Exclusive Mode)
Native resolution: 1920x1080
Maximum frame rate: 60 fps

References

mizztgc/konaste-linux - Another work for Konaste games on Linux that uses bash scripts and doesn't use Proton.

Name		Name	Last commit message	Last commit date
Latest commit History 83 Commits
.devcontainer		.devcontainer
.github/workflows		.github/workflows
.vscode		.vscode
src		src
tests		tests
workflows		workflows
.gitignore		.gitignore
.releaserc.json		.releaserc.json
AGENTS.md		AGENTS.md
LICENSE		LICENSE
README.md		README.md
deno.jsonc		deno.jsonc
deno.lock		deno.lock
hk.pkl		hk.pkl
mise.lock		mise.lock
mise.toml		mise.toml
version.json		version.json

Folders and files

Latest commit

History

Repository files navigation

Konamate: Running Konaste games on Linux

How it works

Prerequisites

Installation

Upgrading from Konaste

Minimal steps to launch the games

beatmania IIDX INFINTAS

SOUND VOLTEX EXCEED GEAR

GITADORA

Usage

konamate config

konamate ls

konamate <game> config

konamate <game> profile

konamate <game> associate

konamate <game> exec <...command>

konamate <game> run [url]

Tweaks for better performance

Enable ntsync

Use gamescope

Setup low latency audio with PipeWire

References

Use ASIO in INFINITAS

Troubleshooting

Locale issues

Launching the game fails

INIFNITAS failed to start with audio device error

INFIINITAS does not play sound

Development

Live SDVX end-to-end test

Verified Configurations

All games

beatmania IIDX INFINTAS

SOUND VOLTEX EXCEED GEAR

Alternative configuration for performance testing

GITADORA

Game technical details

beatmania IIDX INFINTAS

SOUND VOLTEX EXCEED GEAR

GITADORA

References

About

Topics

Resources

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages

`konamate config`

`konamate ls`

`konamate <game> config`

`konamate <game> profile`

`konamate <game> associate`

`konamate <game> exec <...command>`

`konamate <game> run [url]`