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](https://docs.bluebubbles.app/helper-bundle/installation) for instructions.

---

## Screenshots

<table>
  <tr>
    <td align="center">Chat List</td>
    <td align="center">Message View</td>
    <td align="center">Private API Features</td>
  </tr>
  <tr>
    <td><img src="https://raw.githubusercontent.com/BlueBubblesApp/bluebubbles-app/master/screenshots/Samsung%20Galaxy%20S10%2B%20Prism%20Black%20-%20imessage_framed.png" width=270></td>
    <td><img src="https://raw.githubusercontent.com/BlueBubblesApp/bluebubbles-app/master/screenshots/Samsung%20Galaxy%20S10+%20Prism%20Black%20-%20messaging_framed.png" width=270></td>
    <td><img src="https://raw.githubusercontent.com/BlueBubblesApp/bluebubbles-app/master/screenshots/Samsung%20Galaxy%20S10+%20Prism%20Black%20-%20privateAPI_framed.png" width=270></td>
  </tr>
</table>

---

## Getting Started

1. Download and install the **BlueBubbles Server** on your Mac: [Server releases](https://github.com/BlueBubblesApp/BlueBubbles-Server/releases)
2. Download the **BlueBubbles client app** for your platform: [Client releases](https://github.com/BlueBubblesApp/blueBubbles-app/releases)
3. Follow the [installation guide](https://bluebubbles.app/install/) to connect everything together

The client is also available on:

- [Google Play](https://play.google.com/store/apps/details?id=com.bluebubbles.messaging)
- [Snap Store](https://snapcraft.io/bluebubbles)
- [Flathub](https://flathub.org/apps/app.bluebubbles.BlueBubbles)
- [Microsoft Store](https://www.microsoft.com/store/productId/9P3XF8KJ0LSM)

---

## Community

We have an active and welcoming community. Come sa