Support

Updated 23 August 2026

This page covers what you normally need to use BT Battery Notifier on a Mac and on Android. If what you are looking for is not here, write in — every message is read by a person.

Direct contact

developer@brorlandi.xyz

Answered within 2 business days. English, Portuguese or Spanish.

What the app does

BT Battery Notifier shows the battery level of the Bluetooth devices you have already paired, and tells you when one of them is running low or has disconnected. Wireless earbuds do not have a single battery — left, right and case — so the app treats each one as its own reading, with its own alert threshold.

Requirements

macOS 13.0 or later, on Apple Silicon or Intel.
Android 8.0 or later. The widget needs a home screen that accepts widgets, which is practically all of them.
At least one paired Bluetooth device that reports its own battery to the system.

On the Mac

I cannot find the app's window

It has no window and no Dock icon: it lives in the menu bar at the top of the screen, near the clock. Click the battery icon to open the device list; the gear button inside that list opens Settings.

If the icon is not there, the menu bar may be full — macOS hides the icons that do not fit. Quit another menu bar app, or free up room in System Settings › Menu Bar.

Permissions

The app asks for two permissions on first launch, and both are required:

Bluetooth — to see your paired devices and read their battery. Without it the list stays empty.
Notifications — for the disconnect and low battery alerts, which are the whole point of the app.

If you denied either one, you can grant it later:

Bluetooth: System Settings › Privacy & Security › Bluetooth, then switch on BT Battery Notifier.
Notifications: System Settings › Notifications › BT Battery Notifier, then turn on Allow notifications.

The "Finish setting up" banner inside the app disappears on its own once both are granted.

A device shows no percentage

The battery level is not computed by the app: the accessory itself reports it. Some Bluetooth devices simply never publish that value, and when they do not, neither the app nor macOS has anything to show. It is worth checking whether the same accessory shows a battery level in the system's own Bluetooth menu — if it does not appear there, it will not appear here.

Many accessories also report their battery only occasionally. The app keeps the last known reading and shows the time it arrived next to it, so you can tell how recent that number is.

Choosing what appears in the menu bar

In Settings each device has two checkboxes: Menu bar and Popup. The first controls whether it takes up room in the bar; the second, whether it appears in the list when you click the icon. Display mode lets you pick icon and percentage, icon only, or percentage only.

Archiving a device

Devices you do not want to track — a guest speaker, a rental car — can be archived with the button next to the name. They leave the menu bar and the list, and stop notifying. The Archived section at the bottom of Settings holds all of them, each with a Restore button.

Tuning the alerts

Notify low battery at whatever threshold you choose.
Show alert on screen for a warning that is harder to miss than a plain notification.
Always notify on disconnect, carrying the device's last known level.
Notify on connect, off by default.

Starting with the Mac

Launch at login in Settings registers the app at login. It can also be switched off in System Settings › General › Login Items.

Wrong icon on a device

The icon is inferred from the device type the accessory declares, and some declare something generic. Click the icon inside Settings and pick another from the list — headphones, earbuds, keyboard, mouse, trackpad, speaker, game controller and so on.

Uninstalling

Drag BT Battery Notifier from the Applications folder to the Trash. Settings and history live in the app's private container and go with it.

On Android

Nearby devices permission

The app needs Nearby devices to see what is already paired and read the battery. It does not scan for new devices and does not ask for location access. To grant it after denying: Settings › Apps › BT Battery Notifier › Permissions.

The widget is not updating

The widget refreshes on its own, with no permanent notification in the status bar. When it stops changing it is almost always the system's battery optimisation suspending the app: under Settings › Apps › BT Battery Notifier › Battery, choose Unrestricted. Opening the app forces an immediate reading.

Widget size and order

The widget grows by the cell: a narrow row shows four readings, a bigger block shows eight. In Settings you pick which components appear and drag the devices to reorder the list.

Galaxy Watch and other Wear OS devices

The watch reports its own battery through the app installed on your wrist, and the Wear OS tile shows the other devices. If the numbers on the watch go stale, open the app on the phone once to get the two talking again.

Privacy

Nothing leaves your device. There is no account, no server, no analytics, no ads and no network connection at all — the app has nowhere to send anything. The details are in the privacy policy (português).

Reporting a problem

Write to developer@brorlandi.xyz. It helps a lot to include:

The operating system and version — for example macOS 26.5 or Android 15.
The app version, shown at the top of Settings.
The model of the Bluetooth device involved.
What you expected and what happened instead.
A screenshot, if it is something visible on screen.

Refunds

Mac App Store purchases are processed by Apple, so refund requests go through reportaproblem.apple.com. Before that, write in — if it is something that can be fixed, it gets fixed.