Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thebarbican19/BatteryBoi
The battery app your Mac's been dreaming about behind your back.
https://github.com/thebarbican19/BatteryBoi
battery-monitor macos menubar menubar-app
Last synced: 3 months ago
JSON representation
The battery app your Mac's been dreaming about behind your back.
- Host: GitHub
- URL: https://github.com/thebarbican19/BatteryBoi
- Owner: thebarbican19
- License: gpl-3.0
- Created: 2023-08-08T21:25:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-11T22:13:28.000Z (10 months ago)
- Last Synced: 2024-05-02T06:09:48.515Z (7 months ago)
- Topics: battery-monitor, macos, menubar, menubar-app
- Language: Swift
- Homepage: https://batteryboi.ovatar.io/
- Size: 9.7 MB
- Stars: 825
- Watchers: 10
- Forks: 20
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- Mac-Menubar-Megalist - BatteryBoi
README
[](https://www.gnu.org/licenses/gpl-3.0)
[]()
[]()
[]()
[](https://twitter.com/batteryboiapp)
# 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](https://twitter.com/mistermeenr)) 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](https://github.com/thebarbican19/BatteryBoi/discussions/62)**
## How (to Install)
#### Manual Download
1. You can install the app by downloading the [latest released .DMG file](https://github.com/thebarbican19/BatteryBoi/releases/). 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](https://github.com/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)](https://twitter.com/mistermeenr/status/1643378900313964544?s=20)
## Localization
**BatteryBoi** has been Localized into the following languages, either by way of auto-translation or by direct translation by the community.
#### Verified
- 🇬🇧 [English](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/en.lproj/LocalizableMain.strings)
- 🇯🇵 [Japanese](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/ja.lproj/LocalizableMain.strings) (Provided by [@fus1ondev](https://github.com/fus1ondev))
- 🇷🇺 [Russian](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/ru.lproj/LocalizableMain.strings) (Provided by [Alexey Petraky @ko-oler](https://github.com/ko-oler))
- 🇳🇱 [Dutch](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/nl.lproj/LocalizableMain.strings) (Provided by [@joostiphone](https://github.com/joostiphone))
- 🇹🇷 [Turkish](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [Soner Kalonya @kalonya](https://github.com/kalonya))
- 🇨🇳 [Chinese (Simplified)](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [Desmoed Richtofen @Shane1119](https://github.com/Shane1119))
- 🇹🇼 [Chinese (Traditional)](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [Desmoed Richtofen @Shane1119](https://github.com/Shane1119))
- 🇸🇰 [Slovenian](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [@drodmantras](https://github.com/drodmantras))
- 🇸🇰 [Slovak](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [@Svec-Tomas](https://github.com/Svec-Tomas))
- 🇻🇳 [Vietnamese](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/vi.lproj/LocalizableMain.strings) (Provided by [Hieu Huynh @hieuhuynh93](https://github.com/hieuhuynh93))
- 🇪🇸 [Spanish](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/es.lproj/LocalizableMain.strings) (Provided by [@David C](https://github.com/davidcafor))
- 🇩🇪 [German](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/de.lproj/LocalizableMain.strings) (Provided by [Hendrik Erz @nathanlesage](https://github.com/nathanlesage))
- 🇰🇷 [Korean](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/ko.lproj/LocalizableMain.strings) (Provided by [YiGeon @YiGeon](https://github.com/YiGeon))
- 🇫🇷 [French](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/fr.lproj/LocalizableMain.strings) (Provided by [Ben Wayne](https://github.com/))
- 🇮🇹 [Italian](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/it.lproj/LocalizableMain.strings) (Provided by [Francesco @katullo11](https://github.com/katullo11))
#### Unverified/Auto-Translated
- 🇵🇹 [Portuguese (Traditional)](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/pt-PT.lproj/LocalizableMain.strings)
- 🇧🇷 [Portuguese (Brazil)](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/pt-BR.lproj/LocalizableMain.strings)
**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](https://crowdin.com/project/batteryboi?already_accepted=16003147)
## Roadmap
With continued support, I will be adding...
- [X] **🔋 Battery Replacement**
- [x] **🚀 Login at Launch**
- [x] **👴🏻 Support for macOS Monterey & Big Sur (v11)**
- [ ] **🟡 System Colour Alerts & Charging Icon**
- [ ] **🪫 Low Power Mode Toggle** (Suggested by [@Crear12](https://github.com/Crear12))
- [x] **🇲🇽 Multiple Language Support** (Helo Translate for your local language here https://github.com/thebarbican19/BatteryBoi/issues/12)
- [x] **⬇️ Sparkle Integration**
- [x] **🚨 Improved Alerts**
- [x] **🏝️ A Dynamic Island-Style Modal with Sexy Indicator**
- [ ] **☀️ Light Mode**
- [x] **🔉 Sound Effects**
- [ ] **🎨 Customisation View** Funding Goal: **$500**
- [ ] **🔉 Sound Effects (Toggle)**
- [ ] **⚙️Display (Toggle)**
- [ ] **👁️Hide/Show Menu Bar Toggle**
- [ ] **☀️Light/Dark Mode Toggle**
- [ ] **📈 More Stats**
- [x] **↗️ Move and Snap to Position**
- [x] **⚙️ App Preferences**
- [ ] **🎧 Bluetooth Device Support**
- [ ] **Custom Notifications**
- [x] **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](https://github.com/thebarbican19/EnalogSwift).
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](https://sprintdock.app) 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.
- [🇯🇵 Apple CH](https://applech2.com/archives/20230831-batteryboi-for-macbook-battery.html)
- [🇩🇪 iFun](https://www.ifun.de/batteryboi-zeigt-die-restliche-akku-laufzeit-in-der-menueleiste-215907/)