A system tray app to monitor the battery level of ZMK-based keyboards, built with Tauri v2.

• Display battery level for:
  • Both central and peripheral sides of split keyboards
  • Multiple keyboards simultaneously
• Supports macOS and Windows
• (Options)
  • Push notifications when
    • Keyboard battery level is low
    • Keyboard is connected/disconnected
  • Auto start at login
  • Switch between light and dark themes

powershell -ExecutionPolicy Bypass -Command "iex (irm 'https://raw.githubusercontent.com/kot149/zmk-battery-center/main/scripts/install_win.ps1')"

View install script

This requires admin privileges. If you don't have admin privileges, manually install with *-setup.exe in Releases.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/kot149/zmk-battery-center/main/scripts/install_mac.sh)"

View install script

Download the binary/installer and install manually from Releases.

If you worry about security, you can build the app yourself from source code. See Development section for more details.

On macOS, the app is blocked from opening as it is not signed. Allow the app to open by either:

• Open System Settings > Privacy & Security > Security and click Open Anyway.
• Or, run the following command in the terminal to remove the app from quarantine:

  sudo xattr -d com.apple.quarantine /Applications/zmk-battery-center.app

  Typically it's located at /Applications/zmk-battery-center.app, but change it to the actual path if it's not there.

• Ensure your keyboard is connected to your computer via Bluetooth.
• Confirm your keyboard firmware includes the following ZMK configuration options:

  CONFIG_BT_BAS=y
  CONFIG_ZMK_BATTERY_REPORTING=y
  
  # For split keyboards:
  CONFIG_ZMK_SPLIT_BLE_CENTRAL_BATTERY_LEVEL_FETCHING=y
  CONFIG_ZMK_SPLIT_BLE_CENTRAL_BATTERY_LEVEL_PROXY=y
  

  See the ZMK Documentation about Bluetooth and about battery for more details.
• On macOS, make sure Bluetooth permission is granted to the app.

Window position may be misaligned if the OS has problems handling multiple monitors or you are using vertical taskbar on Windows.

You can manually move the window to the correct position to address this issue.

1. Right click the tray icon
2. Click Control > Manual window positioning in the menu
3. Now you can grab the top of the window to move it to any position you like

1. Install Bun
2. Install Rustup
3. Clone this repo

   git clone https://github.com/kot149/zmk-battery-center.git
   cd zmk-battery-center

4. Install frontend dependencies

   bun install

5. Run in development mode

   bun tauri dev

6. Build for production

   bun tauri build

   • If build fails, try cleaning the build cache

     cd src-tauri
     cargo clean
     cd ..

   • Specify the target platform with --target option. If omitted, the app will be built for the current platform.

     # for macOS arm64
     bun tauri build --target aarch64-apple-darwin
     
     # for macOS x86_64
     bun tauri build --target x86_64-apple-darwin

You can also build using GitHub Actions.

• ZMK PR #1243, #2045 — Implementation and discussion for split battery reporting over BLE GATT
• zmk-ble: Proof-of-concept system tray app for macOS (not compatible with latest macOS)
• Mighty-Mitts: System tray app for macOS
• zmk-split-battery: System tray app for Windows
• zmkBATx: System tray app for Linux
• ZmkBatteryClient: Waybar custom module