BlueBubbles + Beeper Cloud mautrix guide

This guide is no longer maintained, for an updated and maintained guide, see:
https://rentry.org/sv9t86x5








---------------------------
In-depth noob guide that builds off of: https://github.com/mautrix/imessage/tree/bluebubbles/imessage/bluebubbles

Pre-req:
Download BBCTL to a location somewhere: https://nightly.link/beeper/bridge-manager/workflows/go.yaml/main

In SSH/Terminal (a sudo command may ask for a password, use your mac's login password):
Install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

After homebrew is installed:
brew install go libolm libheif pkg-config pre-commit

Add bbctl download location to $PATH:
Method 1:
sudo cp /[path-to-bbctl-folder]/bbctl/ /usr/local/bin/
RESTART YOUR TERMINAL SESSION

Method 2:
sudo nano /etc/paths
Add a new line with the location of where you downloaded bbctl (i.e., /Users/username/Downloads/bbctldownloadfolder/), save and exit.
RESTART YOUR TERMINAL SESSION

After you have added to Path and restarted terminal session, go to the path where you downloaded bbctl:
chmod +x bbctl-macos-amd64 (update filename based on the binary that works with your hardware)
bbctl-macos-amd64 login
Login to your Beeper account

cd
git clone https://github.com/mautrix/imessage.git
cd imessage
pre-commit install
git checkout bluebubbles

Replace URL for bluebubbles_url (recommend using localhost instead of your cloudflare URL) and your BB password (note: some special characters (i.e., @, -, etc) may cause issues with the command running, either try adding " around the password or change it) for bluebubbles_password:
bbctl-macos-amd64 run --local-dev --param 'bluebubbles_url=http://localhost:1234' --param 'bluebubbles_password=BluEBuBblESPa$$word' --param 'imessage_platform=bluebubbles' sh-imessage

If you start seeing "DBG Received ping from BlueBubbles websocket component=bluebubbles" then you should be all set. New messages that you send or receive after that *should* show up in Beeper automatically. You will have to start NEW messages that are currently not in your Beeper chats in Bluebubbles (you cannot start new iMessage chats in Beeper if they don't already exist from the BlueBubbles bridge).

In the future, if you want to update the bridge:
ctrl+c to stop the bridge
git fetch
git pull
bbctl-macos-amd64 run --local-dev --param 'bluebubbles_url=http://localhost:1234' --param 'bluebubbles_password=BluEBuBblESPa$$word' --param 'imessage_platform=bluebubbles' sh-imessage

Want to start fresh and delete everything?
bbctl delete sh-imessage
Open Finder, at the top, click "Go", click "Home" and then delete the imessage folder (this is the bridge folder)
Then start from cd, git clone https://github.com/mautrix/imessage.git, etc

Follow this guide by @david to start this bridge on boot: https://pastebin.com/U4xesCWn

Questions?
In the Beeper Desktop App, click the Settings Gear (Cog) at the top, Join Matrix Room, near the top-ish right, click the drop-down and "Add new server"
Add a server: maunium.net
Find the iMessage Room: #imessage:maunium.net