/McBrew

A fast GUI for Homebrew written in SwiftUI

Primary LanguageSwift

McBrew

A fast GUI for Homebrew written in SwiftUI. This is my personal spin on the awesome version from buresdv. Adding in features and redesigning the look to fit more of my needs. Also using this as a learning opportunity for Swift as I'm new to it.

Changes from the fork

  • Revamped dashboard
  • Button to go back to dashboard
  • Split out some of the toolbar buttons to upgrade brew and packages independently if desired
  • Analytics toggle on card
  • Brew version on dash
  • Brew health on dash
  • Package/tap icons
  • Show formulae/cask/tap count in sidebar and menu bar
  • This fork leans more towards UI changes rather than functionality

Screenshots

Dashboard

Screenshot 2023-03-17 at 4 05 59 PM Screenshot 2023-03-17 at 4 06 04 PM

Packages

Screenshot 2023-03-17 at 4 06 25 PM Screenshot 2023-03-17 at 4 06 54 PM

Maintenance

Screenshot 2023-03-17 at 4 07 02 PM Screenshot 2023-03-17 at 4 07 17 PM

Settings

Screenshot 2023-03-17 at 4 07 32 PM Screenshot 2023-03-17 at 4 07 56 PM Drop

Getting McBrew

Pre-compiled, always up-to-date versions are available from my releases page. (See compilation instructions below)

You'll need to run this before opening the app as I don't have a paid developer account:

sudo xattr -r -d com.apple.quarantine "PATH_TO_APP"

Compiling McBrew

Compiling McBrew is simple, as it does not have many dependencies.

Prerequisites:

  • macOS Ventura or newer
  • Xcode 14.2 or newer
  • Git
  • An Apple Developer accout. You don't need a paid one! Even a free one works perfectly

Instructions:

Before you begin

  1. Enroll your account in the developer program at https://developer.apple.com/
  2. Install Xcode
  3. Add your Developer account to Xcode. To do so, in the Menu bar, click Xcode → Settings, and in the window that opens, click Accounts. You can add your account there
  4. After you add your account, it will appear in the list of Apple IDs on the left od the screen. Select your account there
  5. At the bottom of the screen, click Manage Certificates...
  6. On the bottom left, click the + icon and select Apple Development
  7. When a new item appears in the list called Apple Development Certificates, you can press Done to close the account manager

Compiling McBrew

  1. Clone this repo using git clone https://github.com/alienator88/McBrew.git && cd McBrew && open .
  2. Double-click McBrew.xcodeproj. Xcode should open the project
  3. Wait until all the dependencies are resolved. It should take a couple minutes at most
  4. In the Menu Bar, click Product → Archive and wait for the building to finish
  5. A new window will open. From the list of McBrew rows, select the topmost one, and click Distribute App
  6. Click Copy App
  7. Open the resulting folder. You'll see an app called McBrew. Drag McBrew to your /Applications/ folder, and you're done!

Thanks

Much appreciation for the original, Cork, from https://github.com/buresdv

License

McBrew is licensed under Commons Clause.

This means that McBrew open-source and you can do whatever you want with McBrew's source, like modifying it, contributing to it etc., but you can't sell McBrew or modified versions of it.