{"id":13753339,"url":"https://github.com/thebarbican19/BatteryBoi","last_synced_at":"2025-05-09T20:35:34.921Z","repository":{"id":187084715,"uuid":"676285889","full_name":"thebarbican19/BatteryBoi","owner":"thebarbican19","description":"The battery app your Mac's been dreaming about behind your back.","archived":true,"fork":false,"pushed_at":"2024-01-11T22:13:28.000Z","size":10167,"stargazers_count":846,"open_issues_count":33,"forks_count":20,"subscribers_count":10,"default_branch":"main","last_synced_at":"2024-11-16T05:32:47.035Z","etag":null,"topics":["battery-monitor","macos","menubar","menubar-app"],"latest_commit_sha":null,"homepage":"https://batteryboi.ovatar.io/","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thebarbican19.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"thebarbican19"}},"created_at":"2023-08-08T21:25:26.000Z","updated_at":"2024-11-01T22:24:48.000Z","dependencies_parsed_at":"2023-09-25T03:57:32.146Z","dependency_job_id":"3c81e1ed-87e2-4d81-ae0a-3b403aac2403","html_url":"https://github.com/thebarbican19/BatteryBoi","commit_stats":null,"previous_names":["thebarbican19/batteryboi"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thebarbican19%2FBatteryBoi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thebarbican19%2FBatteryBoi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thebarbican19%2FBatteryBoi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thebarbican19%2FBatteryBoi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thebarbican19","download_url":"https://codeload.github.com/thebarbican19/BatteryBoi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253321880,"owners_count":21890486,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["battery-monitor","macos","menubar","menubar-app"],"created_at":"2024-08-03T09:01:20.501Z","updated_at":"2025-05-09T20:35:29.884Z","avatar_url":"https://github.com/thebarbican19.png","language":"Swift","funding_links":["https://github.com/sponsors/thebarbican19"],"categories":["Swift","System Status"],"sub_categories":["Local System Status"],"readme":"\n![BatteryBoi Promo image](https://pub-3d59231d7ecc43e7af32a82026f9e071.r2.dev/BatteryBoi%20Poster.jpg)\n\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n![GitHub Sponsors](https://img.shields.io/github/sponsors/thebarbican19)\n[![Github All Releases](https://img.shields.io/github/downloads/thebarbican19/BatteryBoi/total.svg)]()\n![GitHub contributors](https://img.shields.io/github/contributors/thebarbican19/BatteryBoi)\n[![Swift Version](https://img.shields.io/badge/Swift-5.x-orange.svg)]()\n[![MacOS Version](https://img.shields.io/badge/Supported%20Version-v11.0,%20v12.0,%20v13.0,%20v14.0+-orange)]()\n[![Twitter](https://img.shields.io/badge/Follow%20BatteryBoiApp-black)](https://twitter.com/batteryboiapp)\n\n\n# BatteryBoi - A Battery Indicator to Rule Them All!\n**BatteryBoi** is a **replacement Battery Indicator for the MacOS Menu Bar**. \u003cbr\u003e\u003cbr\u003e\n\n## Why\nThe 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. \n\n\u003cbr\u003e\nHowever, 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\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\u003cbr\u003e\n\n## News! News! News! - Version 3.0 \u0026 the iOS App\nAfter 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. \n\u003cbr\u003e\n\n**See the full post about it all [here](https://github.com/thebarbican19/BatteryBoi/discussions/62)**\n\n\u003cbr\u003e\u003cbr\u003e\n\n## How (to Install)\n\n#### Manual Download\n1. 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.**\n2. Open/mount the DMG file and drag BatteryBoi into the Applications Folder. And that's it!\n3. You can hide the default battery icon by going to **System Preferences** \u003e **Control Center** \u003e **Battery** \u003e **Show in Menu Bar**\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n#### Homebrew\nYou can install BatteryBoi via Homebrew thanks to the contribution from [Marcus Kannicht](https://github.com/kannicht). `$ brew install batteryboi`\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n### Works On...\n**BatteryBoi** runs on **both Intel \u0026 Silicon (M1 \u0026 M2)** for the following MacOS versions\n- 11.0 (Big Sur)\n- 12.0 (Monterey)\n- 13.0 (Ventura)\n- 14.0 (Sonoma)\n- 15.0 [(Big Chungus)](https://twitter.com/mistermeenr/status/1643378900313964544?s=20)\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n## Localization\n**BatteryBoi** has been Localized into the following languages, either by way of auto-translation or by direct translation by the community.\n\n#### Verified\n- 🇬🇧 [English](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/en.lproj/LocalizableMain.strings)\n- 🇯🇵 [Japanese](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/ja.lproj/LocalizableMain.strings) (Provided by [@fus1ondev](https://github.com/fus1ondev))\n- 🇷🇺 [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))\n- 🇳🇱 [Dutch](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/nl.lproj/LocalizableMain.strings) (Provided by [@joostiphone](https://github.com/joostiphone))\n- 🇹🇷 [Turkish](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [Soner Kalonya @kalonya](https://github.com/kalonya))\n- 🇨🇳 [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))\n- 🇹🇼 [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))\n- 🇸🇰 [Slovenian](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [@drodmantras](https://github.com/drodmantras))\n- 🇸🇰 [Slovak](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/tr.lproj/LocalizableMain.strings) (Provided by [@Svec-Tomas](https://github.com/Svec-Tomas))\n- 🇻🇳 [Vietnamese](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/vi.lproj/LocalizableMain.strings) (Provided by [Hieu Huynh @hieuhuynh93](https://github.com/hieuhuynh93))\n- 🇪🇸 [Spanish](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/es.lproj/LocalizableMain.strings) (Provided by [@David C](https://github.com/davidcafor))\n- 🇩🇪 [German](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/de.lproj/LocalizableMain.strings) (Provided by  [Hendrik Erz @nathanlesage](https://github.com/nathanlesage))\n- 🇰🇷 [Korean](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/ko.lproj/LocalizableMain.strings) (Provided by  [YiGeon @YiGeon](https://github.com/YiGeon))\n- 🇫🇷 [French](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/fr.lproj/LocalizableMain.strings) (Provided by  [Ben Wayne](https://github.com/))\n- 🇮🇹 [Italian](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/it.lproj/LocalizableMain.strings) (Provided by  [Francesco @katullo11](https://github.com/katullo11))\n\n\n\n#### Unverified/Auto-Translated\n- 🇵🇹 [Portuguese (Traditional)](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/pt-PT.lproj/LocalizableMain.strings)\n- 🇧🇷 [Portuguese (Brazil)](https://github.com/thebarbican19/BatteryBoi/tree/main/BatteryBoi/Other/Localization/pt-BR.lproj/LocalizableMain.strings)\n\n\u003cbr\u003e\n\n**If you would like to help by verifying your native language, or if it is not yet on the list, add it!**\n\nYou can do this on our [Crowdin Translation Page](https://crowdin.com/project/batteryboi?already_accepted=16003147)\n\n\n\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n## Roadmap\nWith continued support, I will be adding...\n\n- [X] **🔋 Battery Replacement**\n- [x] **🚀 Login at Launch**\n- [x] **👴🏻 Support for macOS Monterey \u0026 Big Sur (v11)**\n- [ ] **🟡 System Colour Alerts \u0026 Charging Icon**\n- [ ] **🪫 Low Power Mode Toggle** (Suggested by [@Crear12](https://github.com/Crear12))\n- [x] **🇲🇽 Multiple Language Support** (Helo Translate for your local language here https://github.com/thebarbican19/BatteryBoi/issues/12)\n- [x] **⬇️ Sparkle Integration**\n- [x] **🚨 Improved Alerts**\n- [x] **🏝️ A Dynamic Island-Style Modal with Sexy Indicator**\n- [ ] **☀️ Light Mode**\n- [x] **🔉 Sound Effects**\n- [ ] **🎨 Customisation View** Funding Goal: **$500**\n    - [ ] **🔉 Sound Effects (Toggle)**\n    - [ ] **⚙️Display (Toggle)**\n    - [ ] **👁️Hide/Show Menu Bar Toggle**\n    - [ ] **☀️Light/Dark Mode Toggle**\n\n- [ ] **📈 More Stats**\n- [x] **↗️ Move and Snap to Position**\n- [x] **⚙️ App Preferences**\n- [ ] **🎧 Bluetooth Device Support**\n    - [ ] **Custom Notifications**\n    - [x] **Quick View**\n    - [ ] **Add to Menu Bar**\n\n- [ ] **⌨️ Custom Keyboard Shortcuts**\n- [ ] **⌨️ Custom IF/THEN Triggers** (at 10%, lower the brightness to 0.3) \n- [ ] **📱 iOS/iPad App (Bidirectional Syncing of Battery Information)** \n- [ ] **🧳 SMJobBless Helper Command Line**\n\n\u003cbr\u003eIdeas are welcome. \n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n## Q\u0026A\n**Q.** Is the app GDPR compliment?\u003cbr\u003e\n**A.** BatteryBoi does not collect, store, process, or transfer any personal information as defined by Article 4, Section 1 of the GDPR\n\u003cbr\u003e\u003cbr\u003e\n**Q.** Does this app steal my data? \u003cbr\u003e\n**A.** The app **only logs installs** with [Enalog](https://github.com/thebarbican19/EnalogSwift). \u003cbr\u003e\u003cbr\u003e\u0026ensp;\u0026ensp;\u0026ensp;The information captured in this logging event is... \u003cbr\u003e\u003cbr\u003e\u0026ensp;\u0026ensp;\u0026ensp; - **Device Architecture (Silicon or Intel)** \u003cbr\u003e\n\u0026ensp;\u0026ensp;\u0026ensp; - **MacOS Version Number**\u003cbr\u003e\n\u0026ensp;\u0026ensp;\u0026ensp; - **System Locale (ISO Country Code)** \u003cbr\u003e\n\u0026ensp;\u0026ensp;\u0026ensp; - **Theme (Dark/Light Mode)**. \n\u003cbr\u003e\u003cbr\u003e\n**Q.** What about Personal Data? \u003cbr\u003e\n**A.** No personal data or anything that can be remotely attributed to your person is collected, stored, processed, or transferred. \n\u003cbr\u003e\u003cbr\u003e\n**Q.** Did you make any other sweet sweet apps I can try? \u003cbr\u003e\n**A.** Yeah, [SprintDock](https://sprintdock.app) is my masterpeice. Check it out!\n\u003cbr\u003e\u003cbr\u003e\n**Q.** The estimated time does not show up. Why? \u003cbr\u003e\n**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. \n\u003cbr\u003e\u003cbr\u003e\n**Q.** Can I revert back to the old MacOS Battery Indicator?\u003cbr\u003e\n**A.** Yes! Go to **System Preferences** \u003e **Control Center** \u003e **Battery** \u003e **Show in Menu Bar** and toggle it on. \n\u003cbr\u003e\u003cbr\u003e\n**Q.** Is there support for 3rd Party Devices?\u003cbr\u003e\n**A.** Devices that are connected (via Bluetooth) now show up with their battery level (if available) in BatteryBoi.\n\u003cbr\u003e\u003cbr\u003e\n**Q.** Some Bluetooth devices don't show the Battery Level. Why?\u003cbr\u003e\n**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.\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n## BatteryBoi In the Media\nHere's a list of places BatteryBoi has been featured across the web and across the world. \n- [🇯🇵 Apple CH](https://applech2.com/archives/20230831-batteryboi-for-macbook-battery.html)\n- [🇩🇪 iFun](https://www.ifun.de/batteryboi-zeigt-die-restliche-akku-laufzeit-in-der-menueleiste-215907/)\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthebarbican19%2FBatteryBoi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthebarbican19%2FBatteryBoi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthebarbican19%2FBatteryBoi/lists"}