Skip to content

feat(notifications): add Bark push support#1097

Merged
jotka merged 1 commit into
Finsys:mainfrom
undirectlookable:feature/notification-bark
Jun 6, 2026
Merged

feat(notifications): add Bark push support#1097
jotka merged 1 commit into
Finsys:mainfrom
undirectlookable:feature/notification-bark

Conversation

@undirectlookable

Copy link
Copy Markdown

Add Bark as a supported Apprise notification protocol. Resolves #1095

Supported URL formats:

Bark notifications are sent with POST JSON payloads containing the device key, title, and body. The notification settings modal now lists Bark examples in the Apprise URL placeholder and support text.

Proposed change

Closes #(issue or discussion)

Type of change

  • Bug fix: non-breaking change which fixes an issue.
  • New feature / Enhancement: non-breaking change which adds functionality.
  • Breaking change: fix or feature that would cause existing functionality to not work as expected.
  • Other. Please explain:

Add Bark as a supported Apprise notification protocol.

Supported URL formats:
- bark://bark_key uses the official Bark server at https://api.day.app/
- bark://host/bark_key uses a custom Bark server over HTTP
- barks://host/bark_key uses a custom Bark server over HTTPS

Bark notifications are sent with POST JSON payloads containing the device key, title, and body. The notification settings modal now
lists Bark examples in the Apprise URL placeholder and support text.
@CLAassistant

CLAassistant commented May 25, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@radoeka

radoeka commented May 25, 2026

Copy link
Copy Markdown

Don't forget to update the Dockhand manual.
Dunno if the reference to bark can be added as link/reference to https://github.com/Finb/Bark.

Suggestion: add the link https://github.com/Finb/Bark to the comments in the code as well? File: src/lib/server/notifications.ts line 445?

@undirectlookable

Copy link
Copy Markdown
Author

Don't forget to update the Dockhand manual.

@radoeka Could you tell me where the document repository is? I can't find it. I've tried searching within this project, on the Finsys homepage, and even globally on GitHub. 😅

@radoeka

radoeka commented May 26, 2026

Copy link
Copy Markdown

I can't :( I assume it is an in house/private repository.
Perhaps mention the parts that should get an update, but I think I provided these above already.

Question: would you be able to implement #1099 (Apprise Signal Messenger Integration) too (it is using a rest api)?

@jotka

jotka commented Jun 6, 2026

Copy link
Copy Markdown
Contributor

@undirectlookable thanks, goes out in 1.0.32

@radoeka i will update the manual and implement Signal in #1099

@jotka jotka merged commit b7a8cca into Finsys:main Jun 6, 2026
1 check passed
@jotka

jotka commented Jun 6, 2026

Copy link
Copy Markdown
Contributor

A few small follow-ups I layered on top so it covers the common Apprise/Bark patterns end to end:

  • Multi-devicebark://host/k1/k2/k3 now works and posts to Bark's device_keys batch field. Matches what Apprise users coming from the upstream bark:// scheme expect.
  • Query params?sound=, ?level=, ?group=, ?icon=, ?url=, ?badge=, ?copy=, ?volume=, ?ttl=, ?call=, ?autoCopy=, ?isArchive=, ?action=, ?subtitle=, ?category=. Numeric ones get parsed; the rest pass through verbatim.
  • Level mappinginfo → active, warning → timeSensitive, error → critical by default; explicit ?level= in the URL still wins.
  • Response check — Bark returns HTTP 200 even when code != 200 (e.g. invalid device key). Added the JSON parse so wrong keys actually surface as failures.

Manual section updated too with the URL formats + a small table for the Bark-specific query params.

Crediting you in the v1.0.33 changelog entry. Thanks again!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request] Add notification apprise channel: Bark

4 participants