Keychron K Pro / Q Pro macOS Battery Utility

About

This project adds Bluetooth battery reporting and backlight control for Keychron K Pro and Q Pro keyboards on macOS, which Keychron's firmware does not expose natively because the keyboard's Bluetooth chip reports no battery HID field and macOS has no generic fallback for it. It pairs a small QMK firmware patch with a macOS menu bar agent that shows battery level in the menu bar, Control Center and the system battery widget alongside devices like AirPods, and also adds lighting control. Tested on the K10 Pro.