Skip to content

Commit 572e8e7

Browse files
ThatStella7922gitbook-bot
authored andcommitted
GITBOOK-6: No subject
1 parent 74c78d9 commit 572e8e7

9 files changed

Lines changed: 41 additions & 19 deletions

File tree

175 KB
Loading
105 KB
Loading
159 KB
Loading
407 KB
Loading
429 KB
Loading

docs/README.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,10 @@ Welcome to the documentation for Battery Webhook. To get started, tap the **Intr
66
[introduction](docs/introduction/)
77
{% endcontent-ref %}
88

9-
10-
119
### Looking for something else?
1210

1311
* Battery Webhook on [ThatStella7922's Software site](https://software.thatstel.la/software/crossplatform-apps/battery-webhook)
1412
* Battery Webhook's [GitHub repository](https://github.com/ThatStella7922/battery-webhook)
1513
* Battery Webhook on [the App Store](https://apps.apple.com/us/app/battery-webhook/id6472404778)
1614

17-
This documentation is for Battery Webhook 1.1.
15+
This documentation is for Battery Webhook 1.2.

docs/docs/compatibility.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,20 @@ description: What will Battery Webhook run on?
66

77
Battery Webhook has been built from the ground up to take advantage of features available only in Apple's OSes, and requires one of these OSes at minimum:
88

9+
* macOS Ventura 13.0 or later
910
* iOS 15.0 or later
1011
* iPadOS 15.0 or later
11-
* watchOS 8 or later
12-
* macOS Ventura 13.0 or later
12+
* watchOS 8.0 or later
13+
* visionOS 1.0 or later
1314

1415
Additionally, Battery Webhook has some additional features only supported on more recent OS versions.
1516

16-
* Siri Shortcuts support
17-
* All macOS versions are supported
18-
* iOS 16.0 or later is required
19-
* iPadOS 16.0 or later is required
20-
* watchOS 9.0 or later is required
17+
* **Siri Shortcuts** support requires:
18+
* macOS Ventura 13.0 or later
19+
* iOS 16.0 or later 
20+
* iPadOS 16.0 or later
21+
* watchOS 9.0 or later
22+
* visionOS 1.0 or later
2123

2224
***
2325

docs/docs/supported-services/discord/further-configuring-battery-webhook.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ You'll notice that the **Settings** page in Battery Webhook has a few options we
1212

1313
**Show specified avatar image** and **Show specified pronoun** control whether Battery Webhook will send the avatar image/pronoun to the webhook.
1414

15-
**Send Device Name** and **Send Device Model** will control whether Battery Webhook will send your devices name/model to the webhook. These can be disabled if you would like greater privacy.
15+
**Send Device Name** and **Send Device Model** will control whether Battery Webhook will send your device's name/model to the webhook. These can be disabled if you would like greater privacy.
1616

1717
***
1818

docs/docs/supported-services/discord/setting-up-automations.md

Lines changed: 30 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,27 @@
22

33
### macOS
44

5-
Battery Webhook uses IOPowerManagement events and IOKit queries to directly talk to your Mac's hardware, which provides _highly_ power-efficient and fast automations.
5+
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.
66

77
To take advantage of automations on macOS, just open the app and toggle the desired events in the **Automations** section.
88

99
The automations will not be triggered if your configuration is invalid, so just ensure that it's valid before enabling them.
1010

11-
<figure><img src="../../../.gitbook/assets/image (1).png" alt=""><figcaption></figcaption></figure>
11+
<figure><img src="../../../.gitbook/assets/image (26).png" alt=""><figcaption></figcaption></figure>
1212

13-
### iOS and iPadOS
13+
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.
1414

15-
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 depends on the app's configuration being valid, so ensure you've configured it properly before using the action.
15+
<figure><img src="../../../.gitbook/assets/image (27).png" alt=""><figcaption></figcaption></figure>
16+
17+
Just head into **Settings**, scroll down and choose the options you'd like.
18+
19+
{% hint style="success" %}
20+
Hiding the main window and dock icon + automatically launching Battery Webhook when logging in is **highly** recommended if you use automations.
21+
{% endhint %}
22+
23+
### iOS, iPadOS and visionOS
24+
25+
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.
1626

1727
<figure><img src="../../../.gitbook/assets/image (15).png" alt="" width="375"><figcaption></figcaption></figure>
1828

@@ -22,14 +32,26 @@ When set up with Shortcuts Automations, you can report battery info as seen on t
2232

2333
<figure><img src="../../../.gitbook/assets/image (17).png" alt="" width="188"><figcaption></figcaption></figure>
2434

25-
Let's get started setting it up. Open the **Shortcuts** app, then switch to the **Automations tab**. Tap **New Automation**, then open the **Charger** personal automation. Ensure it **Runs Immediately**, 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.
35+
***
36+
37+
Let's get started setting it up. Open the **Shortcuts** app, then switch to the **Automations tab**.
38+
39+
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**.\
40+
![](<../../../.gitbook/assets/image (24).png>)
41+
42+
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.\
43+
![](<../../../.gitbook/assets/image (25).png>)
44+
45+
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**.
2646

27-
For the next one, create another **Charger** personal automation, but ensure that **When** is _only_ set to **Is Disconnected**, and that **Run Immediately** is checked. Tap **Next**, add the **Send Battery Info** action and enable **Report that the device was unplugged** as well as disabling **Show When Run**.
47+
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**.
2848

29-
Last one. Create a **Battery Level** personal automation and change it to trigger at exactly **100%**. Again, ensure it **Runs Immediately.** Tap **Next** and add the **Send Battery Info** action, then enable **Report that the device reached full charge** as well as disabling **Show When Run**.
49+
{% hint style="warning" %}
50+
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.
51+
{% endhint %}
3052

3153
Once you've set the automations up, they should appear like below:
3254

3355
<figure><img src="../../../.gitbook/assets/image (19).png" alt="" width="375"><figcaption></figcaption></figure>
3456

35-
At this point, plug in/unplug/let your device hit 100% and Battery Webhook will automatically send the batteyr 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
57+
At this point, plug in/unplug/let your device hit 100% and Battery Webhook will automatically send the batteyr 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.

0 commit comments

Comments
 (0)