Skip to content

Installation

Roy Padina edited this page Oct 24, 2026 · 2 revisions

Installation

Requirements

  • macOS 14 Sonoma or later
  • Apple Silicon or Intel (universal app)
  • An ntfy topic on ntfy.sh (free, no account) or on a self-hosted server

Homebrew

brew install --cask roypadina/tap/ntfybar

First launch

NtfyBar releases are self-signed with a stable identity, so permissions survive updates (not notarized, so first launch still needs Open Anyway). macOS may block it the first time. Do one of these:

  • Right-click NtfyBar in /Applications and choose Open.

  • Or run once:

    xattr -dr com.apple.quarantine "/Applications/NtfyBar.app"

macOS asks for notification permission on first launch. Allow it. See Permissions.

Update

NtfyBar has no auto-update and never checks for updates. Update with Homebrew:

brew upgrade --cask ntfybar

Build from source

See Building from source.

Uninstall

If you turned on Launch at login, switch it off first in Settings › General. Then:

brew uninstall --cask ntfybar

To remove your data too (~/Library/Application Support/NtfyBar/):

brew uninstall --zap --cask ntfybar

Next: Usage.

Clone this wiki locally