CHANGELOG

What's new

keybars Pro 1.0 · coming

  • Alerts, builds, coding agents, System, Focus, Typing and Ambient modes
  • The marketplace, in the app and on keybars.app, with publishing from the app and the command line
  • keybars-pro, a command line for everything the app does

keybars Pro 0.7.1 · 11 November 2026

  • The forms and panels (reporting a problem, suggesting a feature, sharing, the first-run guide, the scene maker, the key finder and the licences) keep the keyboard inside them while open, and Esc closes them, as the system's own dialogs do
  • Fixes for a connection change lost when two were made at once, and a rare mix-up when the command line and the window changed settings together

keybars Pro 0.7.0 · 9 November 2026

  • On split boards from QMK (Corne, Sofle, Kyria, Lulu), all lights the thumb keys too and thumbs is the thumb cluster; the equaliser, CPU and Ambient cover them, and the preview draws them lit for picking in rules
  • After a crash, the next start offers to send a report of it, saying what went wrong and where, with anything private taken out; Not now puts it aside
  • keybars-pro settings import puts back everything settings export wrote, keeping this computer's audio source and keyboard
  • keybars-pro status says when a newer release is out
  • The app notices at once when OpenRGB quits, even with nothing playing, and picks the keyboard up again when it's back
  • Fixes for the window breaking with no other lighting software running or when the same event came twice in a second, a rare mix-up as the app started, and the Fedora package leaving an empty folder behind when removed

keybars Pro 0.6.0 · 6 November 2026

  • The keyboard preview draws the board as it is, staggered columns, thumb clusters and wide keys, for ZSA boards and the keyboards mapped from QMK
  • The window draws its own title bar in the page header, in the theme's colours; macOS keeps its traffic lights
  • A splash as the window opens, the logo's bars playing until the keyboard and audio are ready
  • keybars-pro map gen writes a keyboard's map from QMK's definition, and -save keeps it for the keyboard plugged in
  • Each connection has a quick setup and rules of your own, and packs update in place, keeping the rules you changed
  • Coding agents are set up on their own page, no longer also listed under Connections
  • A window closed to the tray costs nothing to draw, the preview slows while the computer is busy, and the app runs at low priority so builds and tests come first
  • The herdr plugin is now keybars-herdr in the marketplace
  • Fixes for keys left lit after quitting while the keyboard was dropping out, and the status pill sticking on an old step

keybars Pro 0.5.2 · 2 November 2026

  • A keyboard plugged back in is found again even when the audio system stops answering; starting to listen now gives up after 10 seconds instead of waiting for good
  • The log is kept on disk, and keybars-pro debug turns on more detailed logging or saves what the app is waiting on when it seems stuck

keybars Pro 0.5.1 · 2 November 2026

  • Merge confetti, Review nudges and the GitHub CI pack play for Forgejo and Codeberg too; to get the new rules, remove a pack and install it again from the marketplace
  • At the narrowest window, the header keeps the page's name and the On switch in view when an update is out
  • A folded sidebar marks a mode that came after your year of updates with an amber dot

keybars Pro 0.5.0 · 2 November 2026

  • Modes added after a licence's year of updates are marked New and stay off the keyboard until another year, and the app says which they are; everything you had keeps working
  • Activating a key whose updates end before this computer's key's is refused, so an old key from an email can't undo a renewal
  • keybars-pro licence renew opens the checkout for another year once yours is over, and keybars-pro status lists what's locked
  • Match the keyboard moves to the Equaliser, and picking bar colours turns it off
  • Lights come back on at the paused time after the computer sleeps, and stay lit through settings saves
  • Importing settings keeps this computer's audio and keyboard
  • QMK boards through OpenRGB use keybars' maps
  • The update check compares versions, not build dates
  • The Tokyo rain scene goes, as a copy of Neon rain
  • Fixes for a failed start that didn't start again once fixed, a rule's change lost when it changed in two places, key ranges by row, column and LED, Aider's notifications line on removing keybars, and keybars-pro engine ignoring saved maps

keybars Pro 0.4.0 · 29 October 2026

  • Notify is now Alerts, and keybars-pro notify is keybars-pro alert; move your rules from "notify" to "alerts" in settings.json, and set coding agents up again
  • The sidebar groups its pages into Lighting, Alerts and Developer, and setup or Settings can leave pages out
  • Connections, coding agents and the event log move to Developer tools, which turns on by itself when an alert comes from outside System
  • The Equaliser opens on five settings, with the rest under All settings
  • The rule editor folds its painting tools, timing and rarer effects away until asked for
  • Switches for System's alerts, on System and at the top of Alerts
  • Devices folds its numbers away while nothing's wrong
  • Connecting GitHub, Codeberg or any webhook needs Pro, and the relay checks the licence; update to add a service, as earlier copies can't
  • Clearer marketplace scenes, and painted scenes can be shared
  • map[Easier to read and to use with a screen reader:deeper accent colours in the light theme, and the preview's keys, status icons and meters labelled]
  • Fixes for menu descriptions and setup's cards not wrapping, a sheet's close button, and a hidden page showing while its mode plays

keybars Pro 0.3.0 · 28 October 2026

  • One thing plays on the keyboard at a time (the equaliser, CPU cores, an Ambient scene or Typing), switched from the header or keybars-pro play
  • Shows what's playing, from the system's media session
  • A first-run guide that checks the keyboard and the sound
  • The frame rate drops by itself when the keyboard or computer can't keep up, and a warning shows when other lighting software could change the keys
  • Every Notify effect plays for a time, its own unless a rule or light -for picks one, and any effect can repeat until cleared
  • A clearer rule editor and Notify page, with more ways to pick a rule's keys and keys two rules share marked; a tried rule plays alone
  • Back and forward through the window's pages, and transitions between pages, themes and dialogs
  • Weather scenes come out for now
  • Fixes for keys left lit, a replugged keyboard not found again, the Linux tray's menu, and Ambient's list of installed scenes

keybars Pro 0.2.0 · 21 October 2026

  • Downloads for Windows and macOS (Apple silicon and Intel) beside Linux
  • A tray menu to switch mode, scene and theme, or turn the lights off for a while
  • Weather scenes for Ambient, from Open-Meteo
  • Make your own Ambient scene frame by frame, change a scene's colours, and share them
  • Seven new Ambient scenes, and 24 more looks and Ambient items in the marketplace
  • The keyboard crossfades when a scene or mode changes
  • Notify keeps a history of the last 100 events, with missed ones marked
  • The timer moves to a Focus and timers page
  • Report a problem or suggest a feature from the app
  • The sidebar folds to icons; App settings sit in two columns on a wide window
  • Fixes for flicker when the keyboard source changes, and for settings edited in two places at once

keybars 0.5.8 · 8 November 2026

  • For importers, an OpenRGB device says when OpenRGB quits, even while nothing is being sent (Device.OnLost), so an app can show it reconnecting at once

keybars 0.5.7 · 8 November 2026

  • keybars gen -json gives the LEDs of the keys a map leaves out, a split board's thumb cluster and inner column, so they can be lit by name; the built-in boards' shapes have them too

keybars 0.5.6 · 5 November 2026

  • keybars find writes the map itself as you say where each lit key sits (ROW COL, or 5 4-7 for a wide key), printing it or saving it with -o; b goes back an LED, g N jumps to one, q or Ctrl-C stops and keeps what's placed, and ? lists the commands
  • LEDs already passed stay dim green, and OpenRGB keyboards show how far through their LEDs you are
  • keybars find retries a key that didn't light, refuses to run in the background, and checks its flags before connecting
  • For importers, qmk.Read fetches a keyboard's definition, rgb.Parse reads a colour and a board from QMK has its shape

keybars 0.5.5 · 3 November 2026

  • Flags are checked before keybars connects, so a bad one isn't hidden behind a missing Keymapp or OpenRGB, and NaN, negative or out-of-range values are refused
  • A command after the flags (keybars -v test) or a stray word is an error instead of running the bars
  • Two keybars start at once launch only one, so stop can't leave one running
  • keybars start explains -stdin, which it can't give input to, and an early exit with nothing logged
  • A map with an LED twice warns, maps and the settings file may start with a byte order mark, and -stdin frames may have spaces
  • keybars gen doesn't look up a mistyped local file on QMK and GitHub

keybars 0.5.4 · 1 November 2026

  • QMK boards through OpenRGB (Keychron, GMMK, Drop, Corne, Sofle, Kyria and more) use keybars' maps from QMK in place of OpenRGB's matrix, which can lean the bars or stack a split board's halves
  • keybars maps -backend openrgb -save saves what OpenRGB reports for each device, serial numbers masked, to attach to a keyboard report
  • Tested against OpenRGB 1.0 itself, with its debug keyboards

keybars 0.5.3 · 1 November 2026

  • keybars test reports a keyboard that stops answering instead of exiting quietly, and keybars find tells the last LED from a keyboard that has gone
  • Homebrew's formula points at keybars.app

keybars 0.5.2 · 1 November 2026

  • Licence notices credit QMK for the keyboard maps, and include Go's own licence

keybars 0.5.1 · 21 October 2026

  • A missing or crashed cava is reported at once instead of hanging, and run exits with its error
  • Keymapp and QMK requests time out, so a stalled one can't hang keybars
  • Out-of-range -fps, -smooth and -gain are refused; stop only signals keybars itself

keybars 0.5.0 · 19 October 2026

  • Key maps for the Planck EZ and 21 popular QMK keyboards, generated from QMK's own definitions
  • OpenRGB boards without a layout fall back to those maps
  • Licence notices list the same way on every machine

keybars 0.4.0 · 15 October 2026

  • Skips keybars Pro's settings in a shared config file
  • The green bars logo

keybars 0.3.0 · 14 October 2026

  • OpenRGB backend for keyboards other than ZSA's
  • Follows the keyboard when OpenRGB's device list changes
  • Ships third-party licence notices

keybars 0.2.0 · 13 October 2026

  • Releases with GoReleaser, and a Homebrew formula in the tap
  • Start and stop with a config file; a version command
  • Name cava's capture device with -source
  • Generate keyboard maps from QMK definitions

keybars 0.1.0 · 11 October 2026

  • Music as bars on a ZSA keyboard, through cava and Keymapp
  • Green bars with peak dots, and -gain to reach higher