flipperzero-firmware-wPlugins/MACOS_GUIDE.md

macOS compile guide by deafbed,

• Updated by @eltonalvess, and @tonywald

Tested with M1 Macbook Air, macOS Monterey (12.4)

⬆️ Update

• Tested with M1 Macbook Pro, macOS Ventura (13.4, 22F66) [06-06-2023]
• Tested with M1 Macbook Air, macOS Sonoma (14.1.2) [12-27-2023]

FROM THE BEGINNING

Install qFlipper

• qFlipper can be found on the App Store or you can download it from https://flipperzero.one/update

---

Install the Homebrew application

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Open Terminal.app or iTerm.app and run source ~/.bashrc of if you are using zsh the command should be source ~/.zshrc (It will refresh enviroment variables that Homebrew creates).

To have sure that Brew was installed sucessfully then run

brew help it should output something like this:

---

Download the source code of the firmware

To clone the repository, just run the command below:

git clone --recursive https://github.com/RogueMaster/flipperzero-firmware-wPlugins.git

It will download the latest build files from the github repository (in your prefered folder)

Inside the source code folder (flipperzero-firmware-wPlugins) run the follow command:

chmod u+x buildRelease.sh

This command will give permission to execute the Shell Script (.sh).

---

Install the necessary prerequisites

Go to the downloaded firmware folder

cd flipperzero-firmware-wPlugins

Next, we run the following command to download the remaining requirements:

brew bundle --verbose

If you get the error Homebrew Bundle failed! 1 Brewfile dependency failed to install., try running brew install --cask gcc-arm-embedded. You can verify that this fixes the error by running brew bundle --verbose again.

---

Compile

To compile the source code just run the following command inside the root folder.

./buildRelease.sh

😴 It will start to compile, be patient it take a while!

---

The output files

If everything goes well it will appear some 3 files in the root folder like the image below:

---

Updating using qFlipper

1. Connect the Flipper Zero to your pc.

2. Click in Install from File
3. Select the compiled firmware file created on the root folder i.e RM0606-0922-0.84.3-36d65f3.tgz

4. Click Install.

---

If everything worked, your Flipper should be recognized and the firmware version should match the github commit shown here:

https://github.com/RogueMaster/flipperzero-firmware-wPlugins