Setting up automations
Last updated
Last updated
Battery Webhook on macOS uses IOPowerManagement events and IOKit queries to directly talk to your Mac's hardware, which provides highly power-efficient and fast automations.
To take advantage of automations on macOS, just open the app and toggle the desired events in the Automations section.
The automations will not be triggered if your configuration is invalid, so just ensure that it's valid before enabling them.
Battery Webhook on macOS also supports launching itself when you log in, showing a Menu Bar Extra for quick and easy control, and hiding the main window + dock icon for a cleaner experience.
Just head into Settings, scroll down and choose the options you'd like.
Hiding the main window and dock icon + automatically launching Battery Webhook when logging in is highly recommended if you use automations.
On these platforms, Battery Webhook uses the Shortcuts Automations feature built into the Shortcuts app. As such, we add the Send Battery Info action to Shortcuts. This action requires a valid configuration in the app.
With the action, you can report to the webhook that you've plugged in, unplugged or fully charged your device.
When set up with Shortcuts Automations, you can report battery info as seen on the Introduction page:
Now for an important note about the Send Battery Info action. In the Shortcuts app, you may see two versions of the action (Standard and Legacy), and which one you should use depends on what OS your device is running.
iOS 16 or later, iPadOS 16 or later, or visionOS
Use the Standard variant, it's built on a modern framework and is slightly more efficient.
iOS 15 or older, or iPadOS 15 or older
Use the Legacy variant, as the Standard variant is not supported on these older OSes and will not appear in the Shortcuts app.
Now that you know which variant to use, we can start! Open the Shortcuts app, then switch to the Automations tab.
For the next one, create another Charger personal automation. Ensure that When is only set to "Is Disconnected", Run Immediately is checked and Notify When Run is turned off. Tap Next, add the Send Battery Info action, enable Report that the device was unplugged and disable Show When Run.
Last one. Create a Battery Level personal automation and change it to trigger at exactly 100%. Again, ensure that Runs Immediately is checked and Notify When Run is turned off. Tap Next and add the Send Battery Info action, enable Report that the device reached full charge and disable Show When Run.
If you forget to disable Notify When Run or Show When Run when setting up any of the above automations, you may see notifications on your device when plugging in, unplugging or fully charging your device. Disabling these means that no notifications will be shown.
Note that the Notify When Run option is not available on iOS 15.4 or older, or iPadOS 15.4 or older (this is an Apple limitation), so you will get a notification from the Shortcuts app when automations are triggered.
Once you've set the automations up, they should appear like below:
At this point, plug in/unplug/let your device hit 100% and Battery Webhook will automatically send the battery info according to your configuration. If there's a configuration error, the Shortcuts app will let you know so you that can fix it in Battery Webhook.
Tap New Automation, then select the Charger personal automation. Make sure that When is set to "Is Connected", Run Immediately is selected and Notify When Run is turned off, then tap Next.
Tap New Blank Automation and add Battery Webhook's Send Battery Info action. Make sure to enable Report that the device was plugged in and that Show When Run is off, then press Done to create it.
