https://github.com/rhettbull/chargemon

Simple macOS StatusBar app to remind you to unplug your laptop when sufficiently charged
https://github.com/rhettbull/chargemon

battery laptop macos python rumps statusbar statusbarutil utility

Last synced: 3 months ago
JSON representation

Simple macOS StatusBar app to remind you to unplug your laptop when sufficiently charged

• Host: GitHub
• URL: https://github.com/rhettbull/chargemon
• Owner: RhetTbull
• License: mit
• Created: 2021-11-26T19:35:52.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-09-03T16:28:54.000Z (over 1 year ago)
• Last Synced: 2024-08-03T09:05:18.672Z (6 months ago)
• Topics: battery, laptop, macos, python, rumps, statusbar, statusbarutil, utility
• Language: Python
• Homepage:
• Size: 1020 KB
• Stars: 8
• Watchers: 5
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ChargeMon

Simple macOS StatusBar app to monitor battery charge status and remind you to unplug your Mac when the battery is sufficiently charged

# Overview

Very simple app -- can toggle between alert or notification.

![StatusBar screenshot](statusbar.png)

Settings:

- Alert: Shows a dialog box when the battery is sufficiently charged

- Notification: Shows a notification when the battery is sufficiently charged

- Pause: Pauses the app until you toggle it back on

- Snooze: Snooze alerts for 15 minutes

- About: Shows the About dialog

Sample alert:

![Alert screenshot](alert.png)

## Installation

- clone the repo

- cd into the repo directory

- create a virtual environment and activate it

- python3 -m pip install -r requirements.txt

- python3 setup.py py2app

- Copy dist/chargemon.app to /Applications

## Notes

Doesn't work with python 3.10 as [rumps](https://github.com/jaredks/rumps) is currently not compatible with 3.10.

Actually, I was able to build this with python 3.11 so the problem with [rumps](https://github.com/jaredks/rumps) may have been fixed in the latest release.

If building with [pyenv](https://github.com/pyenv/pyenv) installed python, you'll need to build the python with framework support: 

`env PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install -v 3.9.11`

## Credits

Inspired by this [tweet](https://twitter.com/mathsppblog/status/1462706686058246151) by [@mathsppblog](https://twitter.com/mathsppblog).

## License

MIT License

# See Also

[iBatteryStats](https://github.com/saket13/iBatteryStats) - a similar idea with many more features