Skip to content

A system tray app for instant battery percentage, color-coded status, and notifications. Simplify your battery monitoring.

Notifications You must be signed in to change notification settings

a-s-akash/battery-stats

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

battery-stats

A system tray app for instant battery percentage, color-coded status, and notifications. Simplify your battery monitoring.

Description:

The project is a system tray application that provides real-time information about your computer's battery status. It uses the PyQt5 library for the graphical user interface and integrates with system resources and notifications. The application displays a battery icon in the system tray, and the icon's color and text change dynamically based on the battery's charge level and power status. Additionally, it notifies the user when the battery is fully charged or reaches a critically low level. Users can access an "QUIT" option from the system tray menu to close the application. The project offers a convenient way for users to monitor their laptop's battery status and receive important notifications, helping them manage their device's power more effectively. When you hover over the icon in the system tray, this application provides at-a-glance information about your laptop's battery status. It clearly indicates whether your battery is 'Gaining' (charging) or 'Draining' (discharging), ensuring you stay informed about the current power situation. Right-clicking on the icon in the system tray allows you to access a menu, providing an option to quit the app.

Key Features:

Real-time battery percentage display in the system tray.

Dynamic color and text changes based on the battery's status.

Notifications for full charge and critically low battery.

Offers a simple system tray interface for ease of use.

Different Status:

When your battery percent is less than 10: [definitely you need to plug in]

less_than_10 (RED color)

When your battery percent is less than 30: [its the safer zone to plug in]

less_than_30 (ORANGE color)

When your battery percent is more than 30: [for battery percent 30-100]

more_than_30 (GREEN color)

While plugged in: [remains same color for all battery level when plugged in]

while_plugged (BLUE color)

Get Notified when your battery fully charged: [you may unplug the charger]

when_fully_charged

Get Notified when your battery level is low: [Useful to prevent from shutting down]

low (it's better to plugin at this point)

critical (it's must to plugin)

Tooltip text: [shows the battery status with percentage]

gaining

draining (on hover the icon)

Quit the App: [Right-click on the icon to open the menu]

exit (choose quit to shut the app)

Additional Files:

Includes "runner.bat" and "RunScript.vbs" for running the Python program seamlessly without the console, providing an app-like experience.

To run the app, all the necessary files must be placed in a single folder, and you should execute "RunScript.vbs" each time instead of directly running the Python file.

To ensure automatic startup of this application every time you boot your PC, simply place the RunScript.vbs file in the startup folder, located at 'C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup'

About

A system tray app for instant battery percentage, color-coded status, and notifications. Simplify your battery monitoring.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages