Bluetooth Battery Meter

Currently supported on Gnome Versions:

Supported: 43, 44, 45, 46, 47, 48

Deprecated: 42

Bluetooth Battery Meter is a Gnome Extension featuring indicator icons in system tray, serving as meter for Bluetooth device battery levels and providing detailed battery levels via icon/text in the Bluetooth quick settings menu.

Important Notes


  • Certain Bluetooth devices report battery levels in different increments.
  • One would expect a continuous discharge reading like 100, 99, 98, 97… down to 0.
  • However manufacturers often design devices to report in specific increments.
  • Some devices may report battery levels in increments of 5 (e.g., 100, 95, 90, 85… to 0)
  • Some devices may report battery levels in increments of 10 (e.g., 100, 90, 80, 70… to 0)
  • Some devices may report battery levels in increments of 20 (e.g., 100, 80, 60, 40… to 0)
  • For Quick settings percentage displayed in text (when enabled), might observe battery level stuck at a percentage example 100% for a while and later suddenly drop down to 80%, if designed for increment of 20%.


Features:

Core Functions (Default Operation Mode)

  • Displays battery level (text/icon) reported by BlueZ in the system tray indicator and Bluetooth popup menu.

  • Configurable indicator style: battery bar or dots.

  • Customizable battery bar and dot colors.

  • Shows indicator for non-battery Bluetooth devices (e.g., keyboard, mouse) to reflect connection status.

  • Option to disable battery reporting per device.

  • Option to choose different icons for each Bluetooth device.

UPower Devices (Optional Mode)

  • When enabled, displays battery level in the system tray for non-Bluetooth UPower devices (e.g., Logitech Lightspeed keyboard/mouse).

  • Option to select a custom icon for the indicator.

  • Configurable indicator style: battery bar or dots.

  • Customizable battery bar and dot colors.

Enhanced Device Mode (Optional Mode - Requires Python Script)

  • The extension uses a built-in Python script to enhance battery reporting and device control. It communicates with supported devices using:

    • Socket-based interface for devices like AirPods/Beats to retrieve battery levels and control features such as ANC.

    • D-Bus GATT Battery Service (BAS) for standard Bluetooth devices that expose battery information via the GATT protocol.

  • Provides additional UI widgets to display battery levels and control features such as ANC:

    • Message Tray notifications

    • Panel Button

    • On-hover details

    • Multiple indicator mode