https://github.com/aezizhu/chargetop
⚡️ The Premium Real-Time macOS Battery Monitor TUI. Visualize Health, Cycles, Wattage & Temp instantly in your terminal. Written in Go.
https://github.com/aezizhu/chargetop
battery-health battery-monitor chargetop cli cycle-count developer-tools go golang macos productivity system-monitoring terminal-app tui
Last synced: about 2 months ago
JSON representation
⚡️ The Premium Real-Time macOS Battery Monitor TUI. Visualize Health, Cycles, Wattage & Temp instantly in your terminal. Written in Go.
- Host: GitHub
- URL: https://github.com/aezizhu/chargetop
- Owner: aezizhu
- License: apache-2.0
- Created: 2025-12-11T03:36:10.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-11T15:39:49.000Z (6 months ago)
- Last Synced: 2025-12-11T20:53:39.745Z (6 months ago)
- Topics: battery-health, battery-monitor, chargetop, cli, cycle-count, developer-tools, go, golang, macos, productivity, system-monitoring, terminal-app, tui
- Language: Go
- Size: 23.4 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Chargetop 🔋
[中文文档](README_CN.md) | **English**
A high-performance, single-binary Terminal User Interface (TUI) application for monitoring your macOS battery status. Built with Go and Bubbletea.
## Features
- **Blazing Fast**: Native binary, instant startup, low memory footprint.
- **Real-time Monitoring**: Live updates of battery percentage and charging status.
- **Detailed Stats**: Cycle count, battery health, maximum capacity, wattage, and serial number.
- **Beautiful UI**: Modern, responsive terminal interface powered by Bubbletea.
## Installation
### Method 1: From Source (Go Required)
1. Clone the repository:
```bash
git clone https://github.com/aezizhu/chargetop.git
cd chargetop
```
2. Build the binary:
```bash
go build -o chargetop
```
3. Run:
```bash
./chargetop
```
### Method 2: Homebrew
```bash
brew tap aezizhu/chargetop
brew install chargetop
```
## Usage
- **Run (Homebrew)**: `chargetop`
- **Run (Source)**: `./chargetop`
- **Quit**: Press `q` or `Ctrl+C`
- **Refresh**: Press `r`
## Requirements
- macOS (tested on Sonoma/Ventura)
- Go 1.19+ (for building from source)