BlueBubbles Private API
GitHubWebsiteDiscord
Search
⌃K
Links

Intro and Background

Info on how the Private API bundle was created, what functions it uses, how to contribute, and more.

Background

We initially created the helper bundle with the goal of allowing BlueBubbles clients to be able to see and send typing indicators, as well as to send reactions. Over time, the helper project has grown to support the following:
  1. 1.
    Send reactions
  2. 2.
    Send and receive typing indicators
  3. 3.
    Mark chats read on the server Mac
  4. 4.
    Mark chats unread on the server Mac (requires MacOS 13+)
  5. 5.
    Rename group chats
  6. 6.
    Add / remove participants from group chats
  7. 7.
    Leave group chat
  8. 8.
    Update group chat photo (requires MacOS 11+)
  9. 9.
    Send messages
  10. 10.
    Send replies (requires MacOS 11+)
  11. 11.
    Send message effects
  12. 12.
    Send message with subject
  13. 13.
    Send mentions
  14. 14.
    Update pinned chats on the server Mac (requires MacOS 11, higher versions are currently unsupported)
  15. 15.
    Edit messages (requires MacOS 13+)
  16. 16.
    Unsend messages (requires MacOS 13+)
  17. 17.
    Check user focus status (requires MacOS 12+)
  18. 18.
    Force notify a message (requires MacOS 12+)
  19. 19.
    Retrieve Digital Touch and Handwritten message previews (requires MacOS 11+)
  20. 20.
    Create chats
  21. 21.
    Delete chats
  22. 22.
    Delete messages
  23. 23.
    Check user iMessage and FaceTime status

Supported Devices & Platforms

The bundle has been tested on MacOS 10.13 (High Sierra) - MacOS 13 (Ventura). It could work on higher or lower MacOS versions, but we do not know for sure.
The bundle supports both Intel and Apple Silicon Macs.
Next
Installation
Last modified 1mo ago