Search packages, repositories and app categories

GitHub repositoryBlueBubblesApp/bluebubbles-app

BlueBubbles

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

BlueBubbles project cover
Stars
1.4K
Forks
359
Last push (UTC)
Nov 8, 2026
Project status
Active

Original README

English project snapshot. Visit GitHub for the latest content.

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

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.

BlueBubbles GitHub avatar
GitHub author

BlueBubbles ↗

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

LanguagesDartKotlinC++Inno SetupCMakePowerShellSwiftHTMLCAIDLShellRubyPythonCSSJavaScriptObjective-C

Categories

Flutter dependencies

Dependencies used

Dependency list 163 items

App categories

Rankings

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗