4 releases

0.2.3 Jun 23, 2020
0.2.2 Jun 22, 2020
0.2.1 Jun 20, 2020
0.2.0 May 8, 2020

#7 in #blink

MIT license

36KB
255 lines

cellrs

Latest Version Latest Version Minimum rustc version Apache 2.0 OR MIT licensed

Classic Screenshot

cellrs (pronounced "cellars") is a terminal-based battery indicator written in Rust.

Overview

  • cellrs displays a battery which resizes with the size of the terminal.
  • The battery contains "cells" that scale to the current battery level. These cells are colour-coded based on the percentage of the battery.
  • A status line is displayed below the battery showing numerical percentage and charging status.
  • Optionally, some cells will blink when the battery is charging.
  • The first four indexed batteries can be selected.

Platforms

Supported platforms/versions are generally based on battery.

  • Linux 2.6.39+
  • MacOS 10.10+
  • Windows 7+
  • FreeBSD
  • DragonFlyBSD

Prerequisites

  • There are no specific prerequisites for using cellrs.
  • For developers, Rust, including cargo.

Dependencies

Install/Build

There are a few ways you can get and use cellrs.

  • Install from crates.io. Requires cargo.

    cargo install cellrs
    
  • Download a release binary from GitLab and put it somewhere in your $PATH.

  • Build from source. Requires cargo.

    git clone https://gitlab.com/leglesslamb/cellrs.git
    cd cellrs
    make install
    

Usage

usage : cellrs

Command-Line Arguments

    -b [width]  Set custom blink-width [16-bit unsigned] (defaults to 1).
    -h          Display this help message.
    -[1-4]      Select battery index. The right-most option will override.
                Index-out-of-bounds will default index to 0.

Key Commands

    b       Cycle through the blink-width value.
                If your custom blink-width was 1 or unset, it will cycle
                through {1, <max-width>, 0, ...}. Otherwise, it will
                cycle through {<custom-width>, <max-width>, 0, ...}.
    q       Quit cellrs.
    [1-4]   Switch between up to the first four indexed batteries.
                Index-out-of-bounds will default index to 0.

Development/Pages

  • Homepage
  • GitLab
    • Working issues and Merge Requests (MRs) are reviewed.
    • Bug reports and feature requests are preferred.
  • GitHub (Mirror)
    • Bug reports and feature requests are accepted.
  • crates.io.

Acknowledgements

Dependencies

~2.2–3MB
~51K SLoC