Battery

Library for querying system battery information.
A Java 8+ JNI wrapper for the starship battery crate.

Usage

To get started create a Manager instance and query it for information:

try (Manager manager = Manager.create()) {
    for (Battery battery : manager.batteries()) {
        // Query battery for its information here
        Optional<Duration> timeToEmpty = battery.timeToEmpty();
    }
}

For more detailed information consult the documentation attached to all types in the api package.

Installation

The library can be installed from the releases repository on maven.lostluma.net in two variants:

• default: Downloads, validates, and caches the dynamic library on demand. Saves bandwidth and disk space.
• bundled: Contains the dynamic library for all platforms. Recommended if first application startup may be offline.

Releases starting with version 2.0.0 are signed using PGP key 831BD989D1B19DBF15DB58A6D99A97B69E896870.

---

The dynamic library comes prebuilt for the following platforms:

	aarch64	amd64	riscv64	loongarch64
Linux	yes	yes	yes	yes
MacOS	yes	yes
Windows	yes	yes

For running on other platforms see the Behavior Customization section below.

Behavior Customization

Some library behavior may be controlled using system properties or the Library utility class:

• battery.natives.cache.dir: Use a different storage location for cached files
• battery.natives.download: Controls automatic backing library download for the default variant
• battery.natives.path: Provide your own build of the backing library for usage on more platforms

Values overwritten using system properties will take precedence over those set via the Library class.