50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
<div align="center">
|
|
|
|
<img src="asset/BrewBar_icon.png" width="128" alt="BrewBar's logo">
|
|
|
|
# BrewBar
|
|
|
|
### A macOS menu bar app that monitors Homebrew updates and lets you upgrade packages directly from the tray.
|
|
|
|
</div>
|
|
|
|
## Features
|
|
|
|
- 🔄 Periodic update checks — configurable from 30 minutes to 24 hours, or any custom interval
|
|
- 📋 Outdated package list with versions (`wget 1.21 → 1.22`), one-click single upgrades
|
|
- 📦 Upgrade All, with an optional confirmation dialog
|
|
- 🤖 Optional auto-upgrade, separately configurable for formulae and casks
|
|
- 👀 Self-updating casks (`--greedy`) included in checks, can be disabled
|
|
- 🔔 Optional notification when new updates appear
|
|
- 🔢 Optional outdated count next to the menu bar icon
|
|
- 🔑 Native password dialog naming the app when an upgrade needs admin rights
|
|
- 📜 Log window with the full brew output
|
|
- ⚙️ Launch at login
|
|
|
|
## Install
|
|
|
|
```sh
|
|
brew tap maxsoch/brewbar https://forgejo.socheleau.fr/maxsoch/BrewBar.git
|
|
brew install --cask maxsoch/brewbar/brewbar
|
|
xattr -dr com.apple.quarantine /Applications/BrewBar.app
|
|
```
|
|
|
|
The `xattr` line is needed because the app is not notarized — without it,
|
|
Gatekeeper blocks the app on any Mac that didn't build it. Repeat it after
|
|
upgrades.
|
|
|
|
**Requires:** macOS 13+ (Ventura) and [Homebrew](https://brew.sh).
|
|
|
|
## Build from source
|
|
|
|
```sh
|
|
git clone https://forgejo.socheleau.fr/maxsoch/BrewBar.git
|
|
cd BrewBar
|
|
xcodebuild -project BrewBar.xcodeproj -scheme BrewBar -configuration Release -destination "platform=macOS" build SYMROOT=build
|
|
open build/Release/BrewBar.app
|
|
```
|
|
|
|
No dependencies — plain AppKit, no SPM/CocoaPods/Carthage.
|
|
|
|
Releases are documented in [RELEASING.md](RELEASING.md).
|