FLUTTER ECOSYSTEM

BlueBubblesApp/bluebubbles-app

A cross-platform app ecosystem, bringing iMessage to Android, PC (Windows, Linux, & even macOS), and Web!

BlueBubbles project cover
Stars
1.4K
Forks
321
Last push (UTC)
Sep 30, 2026
Project status
Active
BlueBubbles GitHub avatar
GITHUB Organization

BlueBubbles ↗

BlueBubbles is an ecosystem of apps bringing iMessage to Android, Windows, and Linux

LanguagesDartKotlinC++Inno SetupCMakePowerShellSwiftHTMLCShellRubyPythonCSSJavaScriptObjective-C

Technical topics

Related packages and examples

Dependencies used

Dependency list 163 items

App categories

Rankings

Original README

English project snapshot. Visit GitHub for the latest content.

Expand / collapse project README

BlueBubbles

BlueBubbles is an open-source, cross-platform ecosystem of apps that brings iMessage to Android, Windows, Linux, and the web. Send messages, media, reactions, and more — all from your non-Apple devices.

Note: BlueBubbles requires a Mac running the BlueBubbles Server and an active Apple ID. A macOS virtual machine on Windows or Linux works as well.


Features

Core Messaging
  • Send and receive iMessages, SMS, and MMS
  • View and send tapbacks, stickers, and emoji reactions
  • Full support for read receipts and delivered timestamps
  • Threaded replies (requires macOS 11+)
  • Create new chats and group conversations
  • Mute or archive conversations
  • Share your location
Customization
  • Robust theming engine with light and dark mode support
  • Choose between iOS, Material, or Samsung-style UI skins
  • Extensive settings to personalize your experience
  • Full cross-platform support — message from Android, Linux, Windows, and macOS
Private API Features

With optional Private API setup, you can unlock deeper iMessage integration:

  • Send and receive typing indicators in real time
  • Send tapbacks, subject lines, message effects, and replies
  • Automatically mark chats as read on your Mac
  • Rename group chats and manage participants

Private API features require additional configuration. See the Private API setup guide for instructions.


Screenshots

Chat List Message View Private API Features
https://raw.githubusercontent.com/BlueBubblesApp/bluebubbles-app/master/screenshots/Samsung%20Galaxy%20S10%2B%20Prism%20Black%20-%20imessage_framed.png https://raw.githubusercontent.com/BlueBubblesApp/bluebubbles-app/master/screenshots/Samsung%20Galaxy%20S10+%20Prism%20Black%20-%20messaging_framed.png https://raw.githubusercontent.com/BlueBubblesApp/bluebubbles-app/master/screenshots/Samsung%20Galaxy%20S10+%20Prism%20Black%20-%20privateAPI_framed.png

Getting Started

  1. Download and install the BlueBubbles Server on your Mac: Server releases
  2. Download the BlueBubbles client app for your platform: Client releases
  3. Follow the installation guide to connect everything together

The client is also available on:


Community

We have an active and welcoming community. Come say hello, get help, or follow along with development:


Contributing

Contributions are always welcome. Whether it's fixing a bug, improving performance, or adding a new feature — we appreciate the help.

Before getting started, please read CONTRIBUTING.md for setup instructions and code conventions.

To report a bug or request a feature, open an issue on GitHub. Please search before opening a new ticket.


Donating

BlueBubbles is free and open-source, maintained entirely by volunteers. If you find the project valuable, consider supporting its development:

bluebubbles.app/donate


Sponsors

signpath Free code signing on Windows provided by SignPath.io, certificate by SignPath Foundation

License

BlueBubbles is released under the terms of the LICENSE file in this repository.