---
name: "org.bluez.Battery"
section: "5"
platform: "linux"
package: "bluez-utils"
version: "5.87-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/org.bluez.Battery"
---

# org.bluez.Battery(5)

BlueZ D-Bus Battery API documentation

## Name

org.bluez.Battery - BlueZ D-Bus Battery API documentation

## Interface

- **Service**

  org.bluez

- **Interface**

  org.bluez.Battery1

- **Object path**

  \[variable prefix\]/{hci0,hci1,...}/dev\_{BDADDR}

### Properties

### byte Percentage \[readonly\]

The percentage of battery left as an unsigned 8-bit integer.

### string Source \[readonly, optional\]

Describes where the battery information comes from.

This property is informational only and may be useful for debugging purposes.

Providers from **[org.bluez.BatteryProvider(5)](/org.bluez.BatteryProvider/5.md)** may make use of this property to indicate where the battery report comes from (e.g. "HFP 1.7", "HID", or the profile UUID).
