Skip to content
/ Bark Public

Bark is an iOS App which allows you to push custom notifications to your iPhone

License

Notifications You must be signed in to change notification settings

Finb/Bark

Repository files navigation

English | 中文

Bark

Bark is a push notification tool app. It's free, simple, and secure, leveraging APNs without draining device battery.
Bark supports many advanced features of iOS notifications, including notification grouping, custom push icons, sounds, time-sensitive notifications, critical alerts, and more.
Additionally, Bark supports self-hosted servers and offers encrypted push notifications to ensure privacy and security.

Documentation

https://bark.day.app/#/en-us/

Feedback

Telegram

Usage

  1. Open the app and copy the test URL

  1. Modify the content and request this URL
You can send GET or POST requests, and you'll receive a push notification immediately upon success.

URL structure: The first part is the key, followed by three matches
/:key/:body 
/:key/:title/:body 
/:key/:category/:title/:body 

title: The push title, slightly larger than the body text 
body: The push content, use the newline character '\n' for line breaks 
category: Reserved for additional features, currently not open for use, just ignore it 
For POST requests, the parameter names are the same as above

Parameters

  • url
// Click on the push notification to jump to the specified URL
https://api.day.app/yourkey/url?url=https://www.google.com 
  • group
// Specify the push message group to view pushes by group.
https://api.day.app/yourkey/group?group=groupName
  • icon (supported on iOS 15 and above)
// Specify the push message icon
https://api.day.app/yourkey/icon?icon=http://day.app/assets/images/avatar.jpg
  • sound
// Specify the push message sound
https://api.day.app/yourkey/sound?sound=alarm
  • call
// Play sound repeatedly for 30 seconds
https://api.day.app/yourkey/call?call=1
  • ciphertext
// Encrypted push message
https://api.day.app/yourkey/ciphertext?ciphertext=
  • Time-sensitive notifications
// Set time-sensitive notifications
https://api.day.app/yourkey/时效性通知?level=timeSensitive

// Optional values 
// active: Default value when not set, the system will immediately display the notification by lighting up the screen. 
// timeSensitive: Time-sensitive notification, can be displayed during focus mode. 
// passive: Adds notification to the notification list without lighting up the screen.
  • Critical alerts
// Set critical alerts
https://api.day.app/yourkey/criticalAlert?level=critical

Critical alerts will ignore silent and do not disturb modes, always playing the notification sound and displaying on the screen.

Others