/Cork

A fast GUI for Homebrew written in SwiftUI

Primary LanguageSwift

Cork

A fast GUI for Homebrew written in SwiftUI

Mastodon Link Mastodon Link

Special Thanks

I'd like to personally thank Seb Jachec for implementing a system for getting real-time outputs of Brew commands.

Without his contribution, many of the processes that depend on real-time outputs, such as installation, uninstallation and updating of packages, would be impossible.

Advantages of Cork

Cork is not just an interface for Homebrew. It has many features that are either very hard to accomplish using Homebrew alone, or straight-up not possible.

Things that Cork makes easier

  • Listing of installed packages. Cork has its own way of loading packages, which is around 10 times faster than the Homebrew implementation.
  • Knowing which packages you installed intentionally, and which packages wwere installed only as dependencies. While somewhat possible with the brew leaves command, it is often unreliable, often not listing packages that should be included.
  • Updating of only selected packages. Again, while possible with Homebrew alone, Cork makes it so easy you wouldn't believe it is not this simple in Homebrew itself.
  • Showing you exactly which packages a package is a dependency of. Super annoying in Homebrew, effortless with Cork.
  • And many other features! Just try Cork out and try finding them all 😉

Things that are not possible without Cork

  • Clearing of cached downloads.
  • Updating packages from the Menu Bar without having Cork open.
  • Seeing this much info about a package in one convenient location.
  • Tagging packages. This is a Cork-only feature that lets you mark any number of packages you'd like to keep track of.

Getting Cork

Pre-compiled, always up-to-date versions are available from my Homebrew tap, which you get access to by donating 5€/month. You can donate through Ko-Fi or GitHub Sponsors.

However, as Cork is open source, you can always compile it from source for free. See below for instructions.

Screenshots

Main Window

Start Page

Package Info

Package Info Package Info - Full-size Caveats Package Info - Minimized Caveats

Tap Info

Tap Info - Casks Only Tap Info - Formulae and Casks

Install Package

Install Package Install Package - Fetching Dependencies Install Package - Installing Dependencies

Add Taps

Tap Taps

Brew Maintenance

Brew Maintenance Brew Maintenance Results

Compiling Cork

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

Prerequisites:

  • macOS Ventura or newer
  • Xcode 14.2 or newer
  • Git

Instructions:

Before you begin

Skip if you already have an Apple Developer account

  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 Cork

  1. Clone this repo using git clone https://github.com/buresdv/Cork.git && cd Cork && open .
  2. Double-click Cork.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 Cork rows, select the topmost one, and click Distribute App
  6. Click Copy App
  7. Open the resulting folder. You'll see an app called Cork. Drag Cork to your /Applications/ folder, and you're done!

License

Cork is licensed under Commons Clause.

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