Skip to content
This repository has been archived by the owner on Sep 19, 2024. It is now read-only.

thebarbican19/BatteryBoi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

BatteryBoi Promo image

License: GPL v3 GitHub Sponsors Github All Releases GitHub contributors Swift Version MacOS Version Twitter

BatteryBoi - A Battery Indicator to Rule Them All!

BatteryBoi is a replacement Battery Indicator for the MacOS Menu Bar.

Why

The battery icon really needed an indicator for how much time is left in terms of minutes and hours. So as a fun evening project, I (Mojito Joe) built it.


However, because of popular demand, the scope of this project has expanded significantly to be a full-fledged, open-source, completely free battery app giving you beautiful notifications and insights into your battery, and even your connected Bluetooth devices



News! News! News! - Version 3.0 & the iOS App

After crossing 20k downloads, I am happy to launch not only some huge updates coming to Version 3.0, but also the release of the BatteryBoi iOS and iPadOS apps. Plus much more.

See the full post about it all here



How (to Install)

Manual Download

  1. You can install the app by downloading the latest released .DMG file. This contains an executable version of the app - you do not need to Xcode to run this.
  2. Open/mount the DMG file and drag BatteryBoi into the Applications Folder. And that's it!
  3. You can hide the default battery icon by going to System Preferences > Control Center > Battery > Show in Menu Bar


Homebrew

You can install BatteryBoi via Homebrew thanks to the contribution from Marcus Kannicht. $ brew install batteryboi




Works On...

BatteryBoi runs on both Intel & Silicon (M1 & M2) for the following MacOS versions

  • 11.0 (Big Sur)
  • 12.0 (Monterey)
  • 13.0 (Ventura)
  • 14.0 (Sonoma)
  • 15.0 (Big Chungus)




Localization

BatteryBoi has been Localized into the following languages, either by way of auto-translation or by direct translation by the community.

Verified

Unverified/Auto-Translated


If you would like to help by verifying your native language, or if it is not yet on the list, add it!

You can do this on our Crowdin Translation Page




Roadmap

With continued support, I will be adding...

  • ๐Ÿ”‹ Battery Replacement

  • ๐Ÿš€ Login at Launch

  • ๐Ÿ‘ด๐Ÿป Support for macOS Monterey & Big Sur (v11)

  • ๐ŸŸก System Colour Alerts & Charging Icon

  • ๐Ÿชซ Low Power Mode Toggle (Suggested by @Crear12)

  • ๐Ÿ‡ฒ๐Ÿ‡ฝ Multiple Language Support (Helo Translate for your local language here #12)

  • โฌ‡๏ธ Sparkle Integration

  • ๐Ÿšจ Improved Alerts

  • ๐Ÿ๏ธ A Dynamic Island-Style Modal with Sexy Indicator

  • โ˜€๏ธ Light Mode

  • ๐Ÿ”‰ Sound Effects

  • ๐ŸŽจ Customisation View Funding Goal: $500

    • ๐Ÿ”‰ Sound Effects (Toggle)
    • โš™๏ธDisplay (Toggle)
    • ๐Ÿ‘๏ธHide/Show Menu Bar Toggle
    • โ˜€๏ธLight/Dark Mode Toggle
  • ๐Ÿ“ˆ More Stats

  • โ†—๏ธ Move and Snap to Position

  • โš™๏ธ App Preferences

  • ๐ŸŽง Bluetooth Device Support

    • Custom Notifications
    • Quick View
    • Add to Menu Bar
  • โŒจ๏ธ Custom Keyboard Shortcuts

  • โŒจ๏ธ Custom IF/THEN Triggers (at 10%, lower the brightness to 0.3)

  • ๐Ÿ“ฑ iOS/iPad App (Bidirectional Syncing of Battery Information)

  • ๐Ÿงณ SMJobBless Helper Command Line


Ideas are welcome.




Q&A

Q. Is the app GDPR compliment?
A. BatteryBoi does not collect, store, process, or transfer any personal information as defined by Article 4, Section 1 of the GDPR

Q. Does this app steal my data?
A. The app only logs installs with Enalog.

โ€‚โ€‚โ€‚The information captured in this logging event is...

โ€‚โ€‚โ€‚ - Device Architecture (Silicon or Intel)
โ€‚โ€‚โ€‚ - MacOS Version Number
โ€‚โ€‚โ€‚ - System Locale (ISO Country Code)
โ€‚โ€‚โ€‚ - Theme (Dark/Light Mode).

Q. What about Personal Data?
A. No personal data or anything that can be remotely attributed to your person is collected, stored, processed, or transferred.

Q. Did you make any other sweet sweet apps I can try?
A. Yeah, SprintDock is my masterpeice. Check it out!

Q. The estimated time does not show up. Why?
A. Estimated time until battery depletion is calculated by the System. Sometimes this information just isn't available. When it isn't, it will fall back on the Battery Percentage.

Q. Can I revert back to the old MacOS Battery Indicator?
A. Yes! Go to System Preferences > Control Center > Battery > Show in Menu Bar and toggle it on.

Q. Is there support for 3rd Party Devices?
A. Devices that are connected (via Bluetooth) now show up with their battery level (if available) in BatteryBoi.

Q. Some Bluetooth devices don't show the Battery Level. Why?
A. BatteryBoi uses System Information to get this information, if it's not in here the device simply may not offer this information or it isn't supported.




BatteryBoi In the Media

Here's a list of places BatteryBoi has been featured across the web and across the world.