# batmon

[![Latest Version](https://img.shields.io/crates/v/battop.svg)](https://crates.io/crates/battop)
[![Packaging status](https://repology.org/badge/tiny-repos/battop.svg)](https://repology.org/project/battop/versions)
[![dependency status](https://deps.rs/crate/battop/0.2.4/status.svg)](https://deps.rs/crate/battop/0.2.4)
![Apache 2.0 licensed](https://img.shields.io/badge/license-Apache%202.0-blue.svg)

`batmon` is an interactive viewer, similar to `top`, `htop` and other *top utilities, but about the batteries installed in your notebook.

It was forked of <https://github.com/svartalf/rust-battop>.

![Screenshot](./assets/screenshot.png)

## Features

 * Cross-platform (Linux, MacOS, FreeBSD and DragonflyBSD are supported and Windows is [on the way](https://github.com/svartalf/rust-battop/issues/5))
 * Supports multiple batteries in case your notebook have them
 * It is free
 * Usually it just works!

`batmon` is backed by a Rust crate [battery](https://crates.io/crates/starship_battery) which provides unified cross-platform information about system batteries.
[Check it out](https://github.com/starship/rust-battery), if you want to gather the same information for your application!

## Installation

[![Packaging status](https://repology.org/badge/vertical-allrepos/batmon.svg)](https://repology.org/project/batmon/versions)

### Arch linux

Install package from [AUR](https://aur.archlinux.org/packages/batmon/) with your favorite AUR helper:

```
$ yay -S batmon
```

### From sources

Clone the repo and run

```
$ cargo build --release
```

### Other

Prebuilt binaries for Linux, FreeBSD and MacOS can be downloaded from the [GitHub releases page](https://github.com/6543/batmon/releases).

## Usage

Simply running the `batmon` command in your terminal should do the thing.

Left and right arrows can be used to switch between different system batteries (if available).

Run the `batmon -h` command to see the additional available options.