V1.0.0 STABLE OUT NOW

PLAY YOUR KEYBOARD
LIKE A SYMPHONY

An adrenaline-fueled, 10-lane rhythm experience designed for mechanical keyboards. Tap, hold, and slide to the beat while crafting your own masterpieces with our overpowered level creator.

GET CLIENT LEARN CHARTING
INTERACTIVE WEB SYNTH PREVIEW
PRESS Q-W-E-R-T-Y-U-I-O-P ON YOUR KEYBOARD TO PLAY!
Q
W
E
R
T
Y
U
I
O
P

ENGINE OVERVIEW

Experience a state-of-the-art rhythm engine engineered for timing precision and visual brilliance.

✎

Place As You Go Mode

Our overpowered editor lets you capture notes dynamically during playback. Hit the keys in real-time, auto-stretch hold notes, and craft pro-grade maps in minutes.

⏺

FFmpeg Audio Converter

Native integration built to transcode WAV and MP3 imports into high-fidelity OGG files. Seamless, fast, and optimized directly within the editor environment.

☁

Supabase Cloud Sync

Log in once, save locally, and let our persistent data managers reconcile your progression, custom maps, and profile parameters automatically with the cloud.

⭐

Up to 20-Star Ratings

From simple cozy melodies to hyper-dense, complex 9-minute streams, our rating system scales up to 20 stars to challenge even the absolute fastest players.

COMMUNITY CREATIONS

Search, download, and compete on the absolute most challenging custom charts uploaded by members.

🏆 CREATOR LEADERBOARD

📊 ENGINE REALTIME STATS

Total Members 3,492
Uploaded Charts 841
Stars Handed Out 182K

CHOOSE YOUR STAGE

Download the client launcher for Windows or browse the open-source repository.

RECOMMENDED
❖

Windows Client Installer

Fully bundled build featuring Godot 4 high-fidelity rendering, native input polling, and local session persistence. Includes automated game updates.

Size: 42.4 MB • Format: .msi DOWNLOAD FOR WINDOWS
PORTABLE
⚡

Windows Standalone ZIP

No installer required. Simply download the compressed level editor client, extract the contents, double click the executable, and jump straight into mapping.

Size: 39.8 MB • Format: .zip DOWNLOAD STANDALONE

SYSTEM SPECIFICATIONS

MINIMUM REQUIREMENTS

  • OS: Windows 10/11 64-bit
  • Processor: Dual Core 2.0 GHz
  • Memory: 4 GB RAM
  • Graphics: DX11 compatible GPU (Intel HD 500+)
  • Storage: 200 MB free space

RECOMMENDED

  • OS: Windows 11 64-bit
  • Processor: Quad Core 3.0 GHz+
  • Memory: 8 GB RAM
  • Graphics: Dedicated GPU (GTX 1050 / RX 560)
  • Keyboard: N-Key Rollover (NKRO) Mechanical

Getting Started

Welcome to Keyboard Symphony, a rhythm adventure crafted strictly for mechanical and high-refresh keyboard layouts. Unlike standard 4-key rhythm systems, Keyboard Symphony leverages a full 10-lane grid matching your keyboard's home/top row keys.

To begin playing, download the desktop client launcher, register a new player profile (or log in offline), and load up the default levels or import custom community charts.

NOTE: Ensure your mechanical keyboard supports N-Key Rollover (NKRO) to play chords requiring 5+ simultaneous keys accurately.

Keyboard Bindings

The standard layout utilizes the top row of alphabetical keys. These map chronologically to the 10 game lanes moving from left to right:

Q
W
E
R
T
Y
U
I
O
P

Additionally, lanes 11 and 12 are reserved for screen camera shakes, lighting drops, and specialty environmental particle effects. These lanes do not require key bindings during active play; they are handled automatically by the rhythm rendering pipeline when the visualizer notes pass the active hitbar.

Creator Level Editor

Unleash your inner beat creator with our Level Editor. Inside the editor dashboard, you can import level assets, set your BPM timings, and configure complex grid configurations.

Key Editor Shortcuts:

  • Left Click: Select a note to enter Edit Mode, or click an empty space in edit mode to toggle Spawn Mode.
  • Right Click: Remove/delete notes instantly from the active grid.
  • Space: Toggle song playback (Play/Stop).
  • Mouse Scroll: Vertically zoom or scroll the note timeline.

Place As You Go Mode (PAYGM)

Recording complex streams manually can be tedious. PAYG Mode allows creators to record their chart in real-time:

  1. Click the ⏺ RECORD (PAYG) button on the editor sidebar.
  2. A 3-second countdown will trigger, letting you prep your hands.
  3. The playback playhead starts moving. Tap keys in rhythm to place single beat notes.
  4. Hold a key down for longer than 0.5 beats to automatically stretch it into a glowing Hold Note until you release the key!

Audio Formats & FFmpeg Integration

To avoid playback stutters, Keyboard Symphony enforces strict OGG audio requirements. If you select a `.mp3` or `.wav` song to map:

  1. The editor automatically prompts: "The selected audio is not in OGG format. Would you like the game to convert/rename it to .ogg automatically?"
  2. Clicking Yes: Invokes the local system's FFmpeg engine synchronously to transcode the file: ffmpeg -y -i input.mp3 -c:a libvorbis -qscale:a 5 output.ogg
  3. Clicking No: Discards the import entirely to ensure timing integrity.

Cloud Integration & Sync

Keyboard Symphony features a fully automated, offline-first backend powered by Supabase Auth & Database APIs:

  • Local Session Encryption: Stores user JWT credentials securely using AES-256 local configuration.
  • SyncManager Reconciliation: Whenever you launch the game or complete a level, the game checks your local timestamp against the database and cloud syncs your stars, member stats, XP levels, and custom charts automatically.