Skip to content

cameronaaron/bluebubbles-app

 
 

Repository files navigation

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, certficate by SignPath Foundation

License

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

About

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

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages