Skip to content

revoepko/astra

Repository files navigation

Astra

Astra

Astra is a lightweight macOS menu bar app for viewing estimated system power usage.

한국어

It focuses on a small local workflow:

  • current power estimate
  • today, this week, and this month energy usage
  • sleep, wake, and dark wake interval records
  • 5-second sample collection
  • 30-day local sample retention

Accuracy

macOS does not provide a public API for exact whole-device wattage on every Mac. Astra currently uses the SMC PSTR signal as a practical estimate and treats the result as an approximation.

Requirements

  • macOS 14.0+

Installation

Signed and notarized DMG builds are published through GitHub Releases. The source archives generated by GitHub are not the app distribution package.

More details are in docs/INSTALLATION.md.

Usage

Astra runs as a menu bar app. Click the menu bar item to open the popover and switch between current power, today, this week, and this month.

Local data is stored under:

~/Library/Application Support/Astra/

See docs/USAGE.md for the current app behavior.

Source

The app source is provided for review. This repository is not the full development workspace and is not intended to be built directly.

Build, test, signing, notarization, and release configuration is kept outside this public repository. Use the signed and notarized DMG from GitHub Releases for installation.

Documentation

Support

Astra is developed as a single-maintainer project and is provided as-is. Bug reports can be opened through GitHub Issues.

Pull requests and external contributions are not accepted at this time.

Security

Please do not report security issues through public GitHub Issues. See SECURITY.md.

License

Astra is released under the Apache License 2.0.

About

Lightweight Mac power estimates in the menu bar · built by Codex

Resources

License

Security policy

Stars

Watchers

Forks

Contributors

Languages