xDarkzx/GigChain-Keys

Free, open-source live rig for keyboard players: your VST3 sounds, setlists and chord charts, a song timeline with live controls, a stage-ready Perform mode and practice warm-ups. Windows, macOS and Linux.

C++

3

234 commits

updated Oct 10, 2026

See the code

See what people are saying

SourceMessageScoreDate

I'm a keys player and wanted MainStage on Windows, so I built a free, open-source one (r/SideProject)

Hey all. I play keys, and the go-to app for running your sounds live (MainStage) is Mac only. The Windows options are either paid or not really built for keyboard players, so I started building my own: GigChain Keys. It's free and open source (GPLv3), and runs on Windows, Mac and Linux. What it…

3

Oct 9, 2026

README

GigChain Keys

Your whole keyboard rig on stage: sounds, setlist, chord charts and practice, in one free app.

Latest release Downloads Windows macOS Linux Stage: alpha Build License: GPL v3

Download · Getting started · User guide · Get help · What's new · ♥ Sponsor


GigChain Keys is a live-performance host for keyboard players, in the spirit of MainStage and Gig Performer. It plays the VST3 instruments and effects already on your computer, keeps every song of the night in a setlist with its own sounds, shows each song's chords and lyrics big enough to read from the keys, and turns those chords into notes falling onto a keyboard so you can practise them.

It is free, with no adverts, no licence keys and no nag screens. It is open source too, under the GPL.

[!IMPORTANT] Public alpha: testers wanted. GigChain Keys is in early testing. It works and is played on real rigs, but it has not yet met the wide range of computers, audio interfaces, keyboards and plugins out there. Features and setlist files may still change between versions, and you may meet bugs. Please try it at home and in rehearsal before trusting it on a gig, keep copies of your setlists, and tell us what works and what breaks. Your feedback decides what gets fixed and built next.

Edit mode: a song's chart with its flow and sections, and the keyboard

Download

SystemDownloadNotes
Windows 10 / 11 (64-bit)Installer (GigChainKeys-<version>-x64-setup.exe)Recommended. Installs for you or for everyone, upgrades in place, uninstalls from Apps & features.
Portable zip (GigChainKeys-<version>-x64-portable.zip)No install: unzip anywhere (a USB stick, too) and run GigChainKeys.exe.
macOS 13+ (Apple Silicon)Disk image (GigChainKeys-<version>-arm64.dmg)Less tested than Windows: Mac reports are especially welcome. See First start on a Mac below.
Linux (64-bit)AppImage (GigChainKeys-<version>-x86_64.AppImage)One file for most distributions (Ubuntu 22.04+, Fedora, Arch, Mint…): make it executable and run it.
.deb (gigchain-keys_<version>_amd64.deb)Ubuntu, Debian, Mint, Pop!_OS: double-click to install. Adds a menu entry and opens .gigchain setlists.

All versions, with their release notes, are on the Releases page.

About code signing

During the alpha, the Windows installer and the macOS app are not code-signed. Code-signing certificates carry a yearly cost, and they will be added as the project grows and community interest and sponsorship make that possible. Until then, Windows and macOS show a one-time warning on first start; the steps below get past it. The builds are made from the source in this repository by its public build scripts, and every release lists the SHA-256 checksum of each file (SHA256SUMS.txt), so you can check your download is the genuine one:

Get-FileHash .\GigChainKeys-0.1.0-x64-setup.exe -Algorithm SHA256   # Windows (PowerShell)
shasum -a 256 GigChainKeys-0.1.0-arm64.dmg                          # macOS (Terminal)
sha256sum GigChainKeys-0.3.0-x86_64.AppImage                         # Linux

First start on Linux

AppImage: make it executable, then run it (or double-click it in your file manager):

chmod +x GigChainKeys-*-x86_64.AppImage
./GigChainKeys-*-x86_64.AppImage

(If it says "FUSE" is missing, install libfuse2, or run it with --appimage-extract-and-run.)

.deb: sudo apt install ./gigchain-keys_*_amd64.deb, then start GigChain Keys from your menu or type gigchain-keys. Remove it with sudo apt remove gigchain-keys.

Sound goes through PulseAudio or PipeWire (or JACK, chosen in Settings); Linux VST3 plugins are found in ~/.vst3 and /usr/lib/vst3.

First start on Windows

Windows SmartScreen may say "Windows protected your PC". Click More info, then Run anyway. This happens once.

First start on a Mac

The app is not notarized by Apple yet. Open the disk image, drag GigChain Keys to Applications, and open it once. When macOS refuses, go to System Settings → Privacy & Security and click Open Anyway.

What you need

  • Instruments: any VST3 instruments and effects. GigChain Keys finds them in the usual VST3 folders by itself. No instruments yet? These free ones cover pianos, synths and pads:

    InstrumentWhat it gives youGet it
    Splice INSTRUMENT (LABS)Pianos, pads, strings and more: Spitfire's LABS sounds. Free with a Splice account.splice.com
    Surge XTA big synth: hundreds of pads, leads, basses and keys. Open source.surge-synthesizer.github.io
    VitalA modern synth with lush pads and leads. Free version with an account.vital.audio
    DexedClassic 80s electric pianos, bells and basses (a DX7). Open source.asb2m10.github.io/dexed
    Salamander Grand PianoA sampled concert grand, in the free sfizz player.sfzinstruments.github.io

    The app shows the same list (Help > Get free instruments). They are the makers' own downloads, not part of GigChain Keys.

  • A MIDI keyboard (USB or a MIDI interface). A sustain pedal, knobs and pads are used when present.

  • An audio interface is recommended for low latency (ASIO on Windows). Your computer's own sound works too.

What it does

🎹 Plays your pluginsHosts VST3 instruments and effects with their own windows. Every sound in the setlist is loaded up front, so switching songs is instant, and held notes and reverb tails ring on across the change.
🎚️ A real mixerLogic-style channel strips: instrument, effects, pan, fader, meters, mute and solo. A master strip with its own effects, and a safety limiter before your speakers.
🎼 Splits, layers and knobsKey zones, transpose and velocity layers per instrument. Right-click any fader, pan knob or plugin setting and learn a knob, fader or pedal on your keyboard for it. Expression, mod wheel, breath and sustain go straight to the instruments.
🎛️ Works with your keyboardIts Play, Stop, ◀◀ ▶▶, Loop and Click buttons work by themselves when it speaks MIDI Start/Stop, MMC or Mackie Control (the DAW mode of Korg nanoKONTROL, M-Audio, Arturia, Novation, Akai…); any other button is learned in one press.
📜 SetlistsAll the night's songs in one file, in order. Change songs with the keyboard, a pedal or a pad. Undo for every edit.
📝 Chord chartsPaste a song from any chord website and each chord lands on its word. Edit it where you read it, like cells: a chord box over every word to type into, words changed in place, chords dragged from word to word.
🎹 How to play a chordForgot one on stage? Tap it: a keyboard with a dot on each key to press (left and right hand), its notes by name, and its inversions. Keep the one you like for the song.
🔀 Sections that change the soundEvery instrument plays together (layers), or one at a time. Each part of the chart (verse, chorus, solo…) can pick which instruments play, and they change by themselves as the song goes.
⏱️ The song's timelinePress Play (Space, your keyboard's Play button, or a pedal) and the song runs at its tempo along its flow (Verse 1 → Chorus → Verse 2 → Chorus ×3…): sounds change at each part, the chord lights in the chart. Live controls land on the bar line: next part, repeat it, loop it, stop at its end.
🎤 Perform modeFull screen, built for the stage and for touch screens: the chart big and clear, big Play, Next part and Loop part buttons, the song's parts as tiles (tap one to go there), nothing you can knock by accident.
🔁 Loop stationRecord a loop of any instrument, in time with the song, and layer on top: street-performer style, from buttons on your keyboard.
🎓 Practice modeThe song's chords fall onto a keyboard as glowing notes, YouTube-piano style. Listen, Play along, or Wait for me, slowed down and looped. The left hand plays the bass, an octave, root and fifth or the full chord; the right hand smooth, in root position or in your chosen inversions.
🔥 Warm-upsA daily warm-up at your level (Beginner, Intermediate, Pro): each exercise right hand, left hand, then both, the finger to use on every note. Every run scored (notes, timing, evenness, hands together) with one tip; three clean runs raise the tempo, and passing a level opens the next.
🥁 Tempo, click and backing tracksA tempo per song, tap tempo, a click, MIDI clock in and out, and a backing track (WAV, MP3, FLAC…) per song.
🛟 Built not to failPlugins are scanned in a separate process; a plugin that crashes while loading is switched off next time; an unplugged keyboard or audio interface comes back by itself.

Perform mode: the song playing, big Play, Next part and Loop part buttons, the parts as tiles and the chart
Perform: the song plays along its parts; Next part and Loop part land on the bar line.

Right-click a fader: MIDI Learn the volume
Right-click a fader, a pan knob or the master: MIDI Learn, then turn a knob on your keyboard.

Practice mode: the chords falling onto a keyboard

A warm-up: five fingers from C with both hands, the finger to use on each falling note A warm-up run's score: three stars, every note right, 5 ms from the beat
Warm-ups: the finger for every note, then the score.

How to play a chord: E/D# with a dot on each key to press

Getting started

  1. Download and install GigChain Keys, then start it.
  2. Open Settings (top right) and choose your audio device and MIDI keyboard.
  3. Click New setlist, then + Song.
  4. Open the Instruments tab on the left and double-click an instrument. Play!
  5. Paste the song's chords into the Chart tab, then try Perform and Practice.

The Getting started page walks through it step by step. Inside the app, press F1 (or click Help) at any time.

Documentation

The user guide is built into the app (Help → User guide, or F1) and is also here on GitHub:

The user guide inside the app

Help and support

Support the project

GigChain Keys is free and stays free: no adverts, no paid version, no keys. If it helps your gigs, a donation keeps it going. It pays for the time to fix and build things, and the first goal is code-signing certificates, so Windows and macOS install GigChain Keys without a warning.

Sponsor GigChain Keys on GitHub

One-off or monthly, any amount, through GitHub Sponsors. Thank you!

Versions

GigChain Keys uses numbered versions. Each release lists what is new and what was fixed in the changelog and on the Releases page.

StageVersionsWhat it means
Alpha (now)0.1, 0.2…Open testing. Features still arriving and changing; feedback shapes them.
Betalater 0.xFeature-complete for 1.0; polishing and fixing.
Stable1.0 and upReady to rely on for gigs; setlist files stay compatible.
VersionStatus
0.3.0Alpha: Linux AppImage and .deb; you move the song (Perform's Play, Next part, Loop part, made for touch screens); MIDI Learn and keyboard transport buttons; instruments named for their sound; Practice warm-ups
0.2.2Alpha: free instruments to get, from the app (pianos, synths, pads)
0.2.1Alpha: the song's timeline with live controls; instruments all together or one at a time; keyboard shortcuts for the stage
0.2Alpha: the chart edited as cells, chord diagrams, the song's flow and steadier chord follow, Practice hand styles
0.1First public alpha: Windows 10/11; macOS (Apple Silicon)

What is coming next is in the roadmap: bundled free instruments, a tablet remote for the music stand, melody and intro practice, and more.

For developers

GigChain Keys is written in C++20 with Qt 6 (QML) and hosts plugins with the Steinberg VST3 SDK; audio and MIDI go through RtAudio and RtMidi.

Everyone taking part is expected to follow the code of conduct.

License and credits

GigChain Keys is free software: you can share and change it under the terms of the GNU General Public License, version 3 or later (LICENSE).

It is built with:

The full notices ship with the app (THIRD-PARTY-NOTICES.txt).

VST is a registered trademark of Steinberg Media Technologies GmbH. ASIO is a trademark of Steinberg Media Technologies GmbH. MainStage, Logic and Gig Performer are trademarks of their owners; GigChain Keys is not affiliated with them.

audio
chord-charts
cpp20
keyboard
keyboardist
linux
live-music
live-performance
macos
mainstage-alternative
midi
music
qml
qt6
setlist
synthesizer
vst3
vst-host
windows
worship-music

xDarkzx/GigChain-Keys

Free, open-source live rig for keyboard players: your VST3 sounds, setlists and chord charts, a song timeline with live controls, a stage-ready Perform mode and practice warm-ups. Windows, macOS and Linux.

C++

3

234 commits

updated Oct 10, 2026

See the code

See what people are saying

SourceMessageScoreDate

I'm a keys player and wanted MainStage on Windows, so I built a free, open-source one (r/SideProject)

Hey all. I play keys, and the go-to app for running your sounds live (MainStage) is Mac only. The Windows options are either paid or not really built for keyboard players, so I started building my own: GigChain Keys. It's free and open source (GPLv3), and runs on Windows, Mac and Linux. What it…

3

Oct 9, 2026

README

GigChain Keys

Your whole keyboard rig on stage: sounds, setlist, chord charts and practice, in one free app.

Latest release Downloads Windows macOS Linux Stage: alpha Build License: GPL v3

Download · Getting started · User guide · Get help · What's new · ♥ Sponsor


GigChain Keys is a live-performance host for keyboard players, in the spirit of MainStage and Gig Performer. It plays the VST3 instruments and effects already on your computer, keeps every song of the night in a setlist with its own sounds, shows each song's chords and lyrics big enough to read from the keys, and turns those chords into notes falling onto a keyboard so you can practise them.

It is free, with no adverts, no licence keys and no nag screens. It is open source too, under the GPL.

[!IMPORTANT] Public alpha: testers wanted. GigChain Keys is in early testing. It works and is played on real rigs, but it has not yet met the wide range of computers, audio interfaces, keyboards and plugins out there. Features and setlist files may still change between versions, and you may meet bugs. Please try it at home and in rehearsal before trusting it on a gig, keep copies of your setlists, and tell us what works and what breaks. Your feedback decides what gets fixed and built next.

Edit mode: a song's chart with its flow and sections, and the keyboard

Download

SystemDownloadNotes
Windows 10 / 11 (64-bit)Installer (GigChainKeys-<version>-x64-setup.exe)Recommended. Installs for you or for everyone, upgrades in place, uninstalls from Apps & features.
Portable zip (GigChainKeys-<version>-x64-portable.zip)No install: unzip anywhere (a USB stick, too) and run GigChainKeys.exe.
macOS 13+ (Apple Silicon)Disk image (GigChainKeys-<version>-arm64.dmg)Less tested than Windows: Mac reports are especially welcome. See First start on a Mac below.
Linux (64-bit)AppImage (GigChainKeys-<version>-x86_64.AppImage)One file for most distributions (Ubuntu 22.04+, Fedora, Arch, Mint…): make it executable and run it.
.deb (gigchain-keys_<version>_amd64.deb)Ubuntu, Debian, Mint, Pop!_OS: double-click to install. Adds a menu entry and opens .gigchain setlists.

All versions, with their release notes, are on the Releases page.

About code signing

During the alpha, the Windows installer and the macOS app are not code-signed. Code-signing certificates carry a yearly cost, and they will be added as the project grows and community interest and sponsorship make that possible. Until then, Windows and macOS show a one-time warning on first start; the steps below get past it. The builds are made from the source in this repository by its public build scripts, and every release lists the SHA-256 checksum of each file (SHA256SUMS.txt), so you can check your download is the genuine one:

Get-FileHash .\GigChainKeys-0.1.0-x64-setup.exe -Algorithm SHA256   # Windows (PowerShell)
shasum -a 256 GigChainKeys-0.1.0-arm64.dmg                          # macOS (Terminal)
sha256sum GigChainKeys-0.3.0-x86_64.AppImage                         # Linux

First start on Linux

AppImage: make it executable, then run it (or double-click it in your file manager):

chmod +x GigChainKeys-*-x86_64.AppImage
./GigChainKeys-*-x86_64.AppImage

(If it says "FUSE" is missing, install libfuse2, or run it with --appimage-extract-and-run.)

.deb: sudo apt install ./gigchain-keys_*_amd64.deb, then start GigChain Keys from your menu or type gigchain-keys. Remove it with sudo apt remove gigchain-keys.

Sound goes through PulseAudio or PipeWire (or JACK, chosen in Settings); Linux VST3 plugins are found in ~/.vst3 and /usr/lib/vst3.

First start on Windows

Windows SmartScreen may say "Windows protected your PC". Click More info, then Run anyway. This happens once.

First start on a Mac

The app is not notarized by Apple yet. Open the disk image, drag GigChain Keys to Applications, and open it once. When macOS refuses, go to System Settings → Privacy & Security and click Open Anyway.

What you need

  • Instruments: any VST3 instruments and effects. GigChain Keys finds them in the usual VST3 folders by itself. No instruments yet? These free ones cover pianos, synths and pads:

    InstrumentWhat it gives youGet it
    Splice INSTRUMENT (LABS)Pianos, pads, strings and more: Spitfire's LABS sounds. Free with a Splice account.splice.com
    Surge XTA big synth: hundreds of pads, leads, basses and keys. Open source.surge-synthesizer.github.io
    VitalA modern synth with lush pads and leads. Free version with an account.vital.audio
    DexedClassic 80s electric pianos, bells and basses (a DX7). Open source.asb2m10.github.io/dexed
    Salamander Grand PianoA sampled concert grand, in the free sfizz player.sfzinstruments.github.io

    The app shows the same list (Help > Get free instruments). They are the makers' own downloads, not part of GigChain Keys.

  • A MIDI keyboard (USB or a MIDI interface). A sustain pedal, knobs and pads are used when present.

  • An audio interface is recommended for low latency (ASIO on Windows). Your computer's own sound works too.

What it does

🎹 Plays your pluginsHosts VST3 instruments and effects with their own windows. Every sound in the setlist is loaded up front, so switching songs is instant, and held notes and reverb tails ring on across the change.
🎚️ A real mixerLogic-style channel strips: instrument, effects, pan, fader, meters, mute and solo. A master strip with its own effects, and a safety limiter before your speakers.
🎼 Splits, layers and knobsKey zones, transpose and velocity layers per instrument. Right-click any fader, pan knob or plugin setting and learn a knob, fader or pedal on your keyboard for it. Expression, mod wheel, breath and sustain go straight to the instruments.
🎛️ Works with your keyboardIts Play, Stop, ◀◀ ▶▶, Loop and Click buttons work by themselves when it speaks MIDI Start/Stop, MMC or Mackie Control (the DAW mode of Korg nanoKONTROL, M-Audio, Arturia, Novation, Akai…); any other button is learned in one press.
📜 SetlistsAll the night's songs in one file, in order. Change songs with the keyboard, a pedal or a pad. Undo for every edit.
📝 Chord chartsPaste a song from any chord website and each chord lands on its word. Edit it where you read it, like cells: a chord box over every word to type into, words changed in place, chords dragged from word to word.
🎹 How to play a chordForgot one on stage? Tap it: a keyboard with a dot on each key to press (left and right hand), its notes by name, and its inversions. Keep the one you like for the song.
🔀 Sections that change the soundEvery instrument plays together (layers), or one at a time. Each part of the chart (verse, chorus, solo…) can pick which instruments play, and they change by themselves as the song goes.
⏱️ The song's timelinePress Play (Space, your keyboard's Play button, or a pedal) and the song runs at its tempo along its flow (Verse 1 → Chorus → Verse 2 → Chorus ×3…): sounds change at each part, the chord lights in the chart. Live controls land on the bar line: next part, repeat it, loop it, stop at its end.
🎤 Perform modeFull screen, built for the stage and for touch screens: the chart big and clear, big Play, Next part and Loop part buttons, the song's parts as tiles (tap one to go there), nothing you can knock by accident.
🔁 Loop stationRecord a loop of any instrument, in time with the song, and layer on top: street-performer style, from buttons on your keyboard.
🎓 Practice modeThe song's chords fall onto a keyboard as glowing notes, YouTube-piano style. Listen, Play along, or Wait for me, slowed down and looped. The left hand plays the bass, an octave, root and fifth or the full chord; the right hand smooth, in root position or in your chosen inversions.
🔥 Warm-upsA daily warm-up at your level (Beginner, Intermediate, Pro): each exercise right hand, left hand, then both, the finger to use on every note. Every run scored (notes, timing, evenness, hands together) with one tip; three clean runs raise the tempo, and passing a level opens the next.
🥁 Tempo, click and backing tracksA tempo per song, tap tempo, a click, MIDI clock in and out, and a backing track (WAV, MP3, FLAC…) per song.
🛟 Built not to failPlugins are scanned in a separate process; a plugin that crashes while loading is switched off next time; an unplugged keyboard or audio interface comes back by itself.

Perform mode: the song playing, big Play, Next part and Loop part buttons, the parts as tiles and the chart
Perform: the song plays along its parts; Next part and Loop part land on the bar line.

Right-click a fader: MIDI Learn the volume
Right-click a fader, a pan knob or the master: MIDI Learn, then turn a knob on your keyboard.

Practice mode: the chords falling onto a keyboard

A warm-up: five fingers from C with both hands, the finger to use on each falling note A warm-up run's score: three stars, every note right, 5 ms from the beat
Warm-ups: the finger for every note, then the score.

How to play a chord: E/D# with a dot on each key to press

Getting started

  1. Download and install GigChain Keys, then start it.
  2. Open Settings (top right) and choose your audio device and MIDI keyboard.
  3. Click New setlist, then + Song.
  4. Open the Instruments tab on the left and double-click an instrument. Play!
  5. Paste the song's chords into the Chart tab, then try Perform and Practice.

The Getting started page walks through it step by step. Inside the app, press F1 (or click Help) at any time.

Documentation

The user guide is built into the app (Help → User guide, or F1) and is also here on GitHub:

The user guide inside the app

Help and support

Support the project

GigChain Keys is free and stays free: no adverts, no paid version, no keys. If it helps your gigs, a donation keeps it going. It pays for the time to fix and build things, and the first goal is code-signing certificates, so Windows and macOS install GigChain Keys without a warning.

Sponsor GigChain Keys on GitHub

One-off or monthly, any amount, through GitHub Sponsors. Thank you!

Versions

GigChain Keys uses numbered versions. Each release lists what is new and what was fixed in the changelog and on the Releases page.

StageVersionsWhat it means
Alpha (now)0.1, 0.2…Open testing. Features still arriving and changing; feedback shapes them.
Betalater 0.xFeature-complete for 1.0; polishing and fixing.
Stable1.0 and upReady to rely on for gigs; setlist files stay compatible.
VersionStatus
0.3.0Alpha: Linux AppImage and .deb; you move the song (Perform's Play, Next part, Loop part, made for touch screens); MIDI Learn and keyboard transport buttons; instruments named for their sound; Practice warm-ups
0.2.2Alpha: free instruments to get, from the app (pianos, synths, pads)
0.2.1Alpha: the song's timeline with live controls; instruments all together or one at a time; keyboard shortcuts for the stage
0.2Alpha: the chart edited as cells, chord diagrams, the song's flow and steadier chord follow, Practice hand styles
0.1First public alpha: Windows 10/11; macOS (Apple Silicon)

What is coming next is in the roadmap: bundled free instruments, a tablet remote for the music stand, melody and intro practice, and more.

For developers

GigChain Keys is written in C++20 with Qt 6 (QML) and hosts plugins with the Steinberg VST3 SDK; audio and MIDI go through RtAudio and RtMidi.

Everyone taking part is expected to follow the code of conduct.

License and credits

GigChain Keys is free software: you can share and change it under the terms of the GNU General Public License, version 3 or later (LICENSE).

It is built with:

The full notices ship with the app (THIRD-PARTY-NOTICES.txt).

VST is a registered trademark of Steinberg Media Technologies GmbH. ASIO is a trademark of Steinberg Media Technologies GmbH. MainStage, Logic and Gig Performer are trademarks of their owners; GigChain Keys is not affiliated with them.

audio
chord-charts
cpp20
keyboard
keyboardist
linux
live-music
live-performance
macos
mainstage-alternative
midi
music
qml
qt6
setlist
synthesizer
vst3
vst-host
windows
worship-music