Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/InventiveRhythm/fluXis/llms.txt

Use this file to discover all available pages before exploring further.

Getting fluXis running on your machine is straightforward. The easiest path is through Steam, which handles installation, automatic updates, and library management in one place. If you prefer to manage the game manually — or if you are on a system without Steam — you can download a pre-built release archive directly from GitHub. Both methods give you the same game binary; the only difference is how updates are delivered.

System Requirements

Before installing, make sure your machine meets the minimum requirements. fluXis is built on osu!framework, which targets modern desktop hardware and relies on OpenGL for rendering.
ComponentMinimumRecommended
OSWindows 10, macOS 12, Ubuntu 20.04Latest stable release
CPUDual-core 2 GHzQuad-core 3 GHz
RAM4 GB8 GB
GPUOpenGL 3.3 compatibleDedicated GPU with 2 GB VRAM
Storage500 MB (game) + map librarySSD recommended
RuntimeNo extra runtime needed (Steam / standalone builds are self-contained)
The standalone GitHub release bundles the .NET 8 runtime, so you do not need to install the .NET SDK separately just to play. The SDK is only required if you intend to build from source.
Steam is the primary distribution channel for fluXis. It provides one-click installation, automatic delta updates, and cloud save support.
1

Open the fluXis Steam page

Visit the fluXis store page at https://store.steampowered.com/app/3440100/fluXis/. You will need a free Steam account. If you do not have one yet, click Login on the Steam website and follow the account-creation flow.
2

Click Play Game / Install

On the store page, click the green Play Game button (or Install if you are viewing it inside the Steam client). Steam will prompt you to choose an installation directory and begin downloading the game.
3

Wait for the download to complete

Download size varies by version but is typically under 200 MB for the base game. Your existing map library and skin files are stored separately in your user data folder and are not affected by game updates.
4

Launch fluXis

Once installation is complete, click Play in your Steam library. On first launch fluXis will perform a brief setup — choosing your data directory and configuring audio offset — before dropping you into the main menu.
Enable Steam Cloud in the game’s properties to back up your scores, settings, and keybindings. This is especially useful if you play on multiple machines.

Method 2 — GitHub Releases

If you prefer a standalone installation, every tagged release is published as a downloadable archive on GitHub.
1

Go to the Releases page

Navigate to https://github.com/InventiveRhythm/fluXis/releases. The latest stable release is always listed at the top of the page.
2

Download the archive for your platform

Under Assets, download the archive that matches your operating system. See the GitHub releases page for the current asset names — they are listed directly under each release.
3

Extract the archive

Extract the downloaded archive to a folder of your choice. On Windows you can right-click and select Extract All. On macOS and Linux, use your system’s archive tool or the tar command with the filename shown on the releases page, for example:
tar -xzf <downloaded-archive>.tar.gz -C ~/Games/fluXis
4

Run the executable

Inside the extracted folder, launch the game:
  • Windows — double-click fluXis.Desktop.exe
  • macOS — open fluXis.Desktop.app (you may need to allow it under System Settings → Privacy & Security on first run)
  • Linux — run ./fluXis.Desktop from a terminal, or create a .desktop shortcut
5

Update manually when new releases drop

GitHub releases do not auto-update. Check the releases page periodically and repeat the download-and-extract process to update. Your data folder (stored separately from the game binary) is preserved between updates.
On Linux, ensure your graphics drivers support OpenGL 3.3 or later. Proprietary NVIDIA drivers and Mesa 22+ for AMD/Intel both satisfy this requirement. If the game fails to launch, check the terminal output for an OpenGL version error.

Importing Maps from Other Games

After installing fluXis you can immediately populate your library by importing maps from osu!, Quaver, and Stepmania. Go to Settings → Plugins inside the game and use the import section to point fluXis at the relevant game’s song folder. fluXis will convert and index the maps automatically so they appear in your song select.

Build docs developers (and LLMs) love