battls

Crates.iobattls
lib.rsbattls
version0.1.0
created_at2026-01-17 22:45:50.436496+00
updated_at2026-01-17 22:45:50.436496+00
descriptionA simple CLI utility that lists your battery information
homepagehttps://github.com/dantehemerson/battls
repositoryhttps://github.com/dantehemerson/battls
max_upload_size
id2051365
size77,494
Dante Calderon (dantehemerson)

documentation

README

battls 🔋

Latest Release Build Status Crates.io License

A simple CLI utility that lists your battery information.

battls screenshot

Features ✨

  • 📦 Beautiful box-style terminal UI
  • 📊 Battery info clearly formatted for quick reading
  • 🔋 Multiple battery support (e.g., ThinkPad T480 with dual batteries)
  • 🦀 Built with Rust for better performance

Requirements

  • Linux system with battery support
  • Rust (latest stable version)

Installation

Packages

Linux

  • Arch Linux: yay -S battls
  • Packages in Alpine, Debian & RPM formats

Binaries

From source

Make sure you have a working Rust environment (Rust 1.70 or higher is recommended). See the install instructions.

Compiling battls is easy, simply run:

git clone https://github.com/dantehemerson/battls.git
cd battls
cargo build --release

Usage

Simply run the executable:

battls

How It Works

  1. Reads battery data from Linux sysfs (/sys/class/power_supply/BAT*)
  2. Parses status, capacity, manufacturer, cycle count, and other metrics
  3. Renders a formatted box-style UI to the terminal

Testing

Run the test suite:

cargo test

License

Feedback

Got some feedback or suggestions? Please open an issue or drop me a note!

Commit count: 16

cargo fmt