← Back to home

Changelog

Release history for shokz-battery

v1.2.2 January 19, 2026

Added

  • Stale data warnings — gentle reminders when Shokz Connect isn't running or data is outdated

v1.2.1 January 19, 2026

Added

  • Low battery warning at 20% — because "I didn't hear you, my headset died" is not a valid excuse in meetings

v1.2.0 January 16, 2026

Added

  • Compact mode (--compact) for single-line output, ideal for menu bar apps like xbar/SwiftBar

v1.1.0 January 16, 2026

Added

  • CHANGELOG.md for tracking version history
  • Changelog page on GitHub Pages (docs/changelog.html)
  • Changelog section on main documentation page
  • /release Claude skill for automated version releases

v1.0.0 January 15, 2025

Added

  • Initial release of shokz-battery
  • Battery level display with visual bar and estimated remaining time
  • Audio mode detection (USB 48kHz, Bluetooth 44kHz, HFP 16kHz)
  • Device information: model, firmware, EQ mode, voice language, multipoint status
  • JSON output for scripting and automation (--json)
  • Watch mode for continuous monitoring (--watch)
  • Verbose mode for detailed device info (-v)
  • Raw output mode (--raw)
  • Support for all Shokz headsets using Loop120 USB dongle
  • Homebrew installation via brew install roelvangils/tap/shokz-battery
  • GitHub Pages documentation site