Install guide

Install Breather and open it the first time.

Breather is free and open source. Because it isn't notarized by Apple (that needs a paid developer account), macOS asks you to approve it once. Here are three ways to install it. The first two skip that step entirely.

Option 1 · Homebrew · easiest

$brew install --cask jals413/tap/breather

Breather's tap clears macOS's download quarantine as it installs, so it opens straight away. Don't have Homebrew? brew.sh.

Option 2 · One line in Terminal

$curl -fsSL https://jals413.github.io/breather/install.sh | bash

Downloads the latest release from GitHub, verifies its SHA-256 checksum, installs it to Applications, clears the quarantine and opens it. Read the script.

Option 3 · Download the DMG

Download and drag to Applications

Get Breather.dmg, open it, and drag Breather onto the Applications folder.

Open Breather. macOS stops it.

Double-click Breather in Applications. macOS shows a message like this one. Click Done.

“Breather” Not Opened

Apple could not verify “Breather” is free of malware that may harm your Mac or compromise your privacy.

DoneMove to Bin

Open Privacy & Security

Open System Settings → Privacy & Security, and scroll down to Security. You'll see a line about Breather. Click Open Anyway. It appears for about an hour after you try to open the app.

Privacy & Security
Security
“Breather” was blocked to protect your Mac. Open Anyway

Confirm

Click Open Anyway once more and enter your Mac password (or use Touch ID). Breather opens, and macOS remembers your choice. You won't be asked again.

Prefer Terminal?

This removes the download quarantine from Breather only. It doesn't change security settings for any other app.

$xattr -dr com.apple.quarantine /Applications/Breather.app

After it opens

Breather lives in your menu bar and your notch, so there's no Dock icon. The welcome screen lets you pick a rhythm and turn on Open at login. macOS may ask for permissions later, only when you turn on the features that need them: Bluetooth and Local Network for the iPhone link, and Automation if you enable website stats.

More questions? Read the FAQ.