bluebubbles-app

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:

• Google Play
• Snap Store
• Flathub
• Microsoft Store

---

Community

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

• Discord: discord.gg/6nrGRHT — the best place for support, feedback, and general chat
• Reddit: r/BlueBubbles
• Website: bluebubbles.app
• Documentation: docs.bluebubbles.app
• FAQ: bluebubbles.app/faq

---

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

	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.