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. This tool automates the registration of URL schemes in Linux desktop environments and provides a command wrapper for launching games with the necessary environment variables.

Prerequisites

Modern Linux distribution with a desktop environment
- Required: systemd-cat, desktop-file-install, xdg-open
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
If ImageMagick is installed, use it to generate icons for the games.

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/konaste-x86_64-unknown-linux-gnu ~/.local/bin/konaste
chmod +x ~/.local/bin/konaste

or install it with ubi.

ubi -p atty303/konaste-linux -e konaste -i ~/.local/bin

Minimal steps to launch the games

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=konaste-sink node.description=Konaste 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:

konaste infinitas config --env.PROTONPATH=GE-Proton10-9 --env.PULSE_SINK=konaste-sink
konaste 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:

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

Run the following command to associate the URL scheme with the game:

konaste infinitas associate

Run the following command to open the login page in your browser:

konaste infinitas run

After logging in, click the ゲーム起動 button to launch the game launcher.
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:

konaste sdvx config --env.PROTONPATH=GE-Proton10-9 --env.PULSE_SINK=konaste-sink
konaste 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:

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

Run the following command to associate the URL scheme with the game:

konaste sdvx associate

Run the following command to open the login page in your browser:

konaste sdvx run

GITADORA

Click to expand the steps

Run the following command to configure the wine prefix:

konaste gitadora config --env.PROTONPATH=GE-Proton10-9 --env.PULSE_SINK=konaste-sink
konaste 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:

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

Run the following command to associate the URL scheme with the game:

konaste gitadora associate

Run the following command to open the login page in your browser:

konaste gitadora run

After logging in, click the ゲーム起動 button to launch the game.

Usage

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

`konaste 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/konaste/games.json file. Format of the game definition file is as defaultGames in the src/games.ts.

`konaste <game> config`

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

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

`konaste <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.

konaste infinitas profile: Lists the available profiles for the game.
konaste infinitas profile --default: Unsets the default profile. If no profile is set as default, selection will be prompted when launching.
konaste infinitas profile <name> --command <command>: Creates or updates a profile with the specified name and command.
konaste infinitas profile <name> --delete: Deletes the specified profile.
konaste infinitas profile <name> --default: Sets the specified profile as the default profile.

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.).

`konaste <game> associate`

This command registers the URL scheme for the specified game in the desktop environment. It allows you to launch the game from the browser.

`konaste <game> exec <...command>`

This command executes the specified command with configured environment variables.

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

`konaste <game> run [url]`

This command opens the login URL in your default web browser if no URL is provided.

And this is executed by the URL scheme registered by the associate command. It will execute the command specified in the selected profile.

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:

konaste 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:

konaste 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:

konaste 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 = "Konaste Loopback"
      audio.position = [ FL FR ]
      capture.props = {
        node.name = "konaste-sink"
        media.class = "Audio/Sink"
        node.description = "Konaste Sink"
        device.description = "Konaste 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 = "konaste-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:

konaste 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.

konaste 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 hk install --mise to install the git hooks for formatting and linting.

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

deno install -A --global -n konaste --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.

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 68 Commits
.devcontainer		.devcontainer
.github/workflows		.github/workflows
.vscode		.vscode
src		src
workflows		workflows
.gitignore		.gitignore
.mise.toml		.mise.toml
.releaserc.json		.releaserc.json
LICENSE		LICENSE
README.md		README.md
deno.jsonc		deno.jsonc
deno.lock		deno.lock
hk.pkl		hk.pkl
version.json		version.json

License

atty303/konamate

Folders and files

Latest commit

History

Repository files navigation

Running konaste games on Linux

How it works

Prerequisites

Installation

Minimal steps to launch the games

beatmania IIDX INFINTAS

SOUND VOLTEX EXCEED GEAR

GITADORA

Usage

konaste ls

konaste <game> config

konaste <game> profile

konaste <game> associate

konaste <game> exec <...command>

konaste <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

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

License

Uh oh!

Stars

Watchers

Forks

Releases 20

Uh oh!

Languages

`konaste ls`

`konaste <game> config`

`konaste <game> profile`

`konaste <game> associate`

`konaste <game> exec <...command>`

`konaste <game> run [url]`