Intro and Background
Info on the BlueBubbles server app
The server is primarily coded in TypeScript. Our first official stable release was published in August 2021 after extensive closed alpha and open beta testing since August 2020.
The server uses AppleScript to perform simple functions like sending messages & attachments and creating chats, and polls the
chat.dbdatabase to see when new messages come in. We provide extra functionality in the form of the Private API bundle (docs linked in the sidebar), which uses native Objective-C to communicate with iMessage itself and access much deeper functions.
Any macOS device running El Capitan and higher, with iMessage activated successfully.
macOS VMs are also compatible, however you must be able to use iMessage (this involves some work with spoofing your hardware to seem like a real Mac inside the VMX file). See Running a macOS VM for more details.
If you'd like the most stable experience, we recommend going with Catalina or Big Sur.
We appreciate y'all!