Skip to main content

A system-tray battery monitor with a battery-selection window.

Project description

battery-tray

A small Linux system-tray battery monitor, built on sevaht-gui.

  • A tray icon shows the selected battery's charge as a colour-graded battery glyph (green → red) with charge/charging state in the tooltip.
  • Left-click (or the tray menu's Configure…) opens a window to pick which battery to monitor and set the refresh interval; both are saved under sevaht/battery-tray.
  • Desktop notifications (via notify-send) fire when the charge level or charging state changes.
  • If no system tray is available, the window simply runs on its own.

Running

$ battery-tray            # start in the tray (window hidden)
$ battery-tray --show     # start with the window open

Configuring from the CLI

These update the saved config and exit (handy for scripts/keybinds); the running app picks the same values up from config:

$ battery-tray --list-batteries       # show detected batteries and exit
$ battery-tray --battery BAT0         # set the monitored battery by name
$ battery-tray --select-battery       # choose interactively from a list
$ battery-tray --set-poll-seconds 10  # set the refresh interval (1-3600s)

Reads battery state from /sys/class/power_supply (Linux only).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

battery_tray-1.0.0.tar.gz (12.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

battery_tray-1.0.0-py3-none-any.whl (14.1 kB view details)

Uploaded Python 3

File details

Details for the file battery_tray-1.0.0.tar.gz.

File metadata

  • Download URL: battery_tray-1.0.0.tar.gz
  • Upload date:
  • Size: 12.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for battery_tray-1.0.0.tar.gz
Algorithm Hash digest
SHA256 674d7d4f1baa1e406852fc9e81124f7ac4696f7a9c7e0c57109a2d1c9ed92d7f
MD5 be734815eedbbffc888ff8ef63628424
BLAKE2b-256 bc7b1fa1697846e2819dacf28c474dce3d1b955221d08596c55e6326d422530c

See more details on using hashes here.

Provenance

The following attestation bundles were made for battery_tray-1.0.0.tar.gz:

Publisher: release.yml on sevaht/battery-tray

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file battery_tray-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: battery_tray-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 14.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for battery_tray-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 79f5f566f6ac529f35ea868a71e199e038bd171e0a172838e0db76deb09b198d
MD5 258eeb3042fc9a195862a31c36753164
BLAKE2b-256 7fac78f693dd4bb28b7cfdbe79f380209a895f3e4578c03b3af6c0d5e2ef3f4a

See more details on using hashes here.

Provenance

The following attestation bundles were made for battery_tray-1.0.0-py3-none-any.whl:

Publisher: release.yml on sevaht/battery-tray

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page