A fast GUI for Homebrew written in SwiftUI
A fast GUI for Homebrew written in SwiftUI
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.
I'd like to personally thank Dmitri Bouniol and Ben Carlsson for coming up with a way for self-compiled builds to bypass the license check.
Without them, it would be impossible to have a free self-compiled version of the app.
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 are not possible without Cork
Things that Cork makes easier
brew leaves
command, it is often unreliable, often not listing packages that should be included.Pre-compiled, always up-to-date versions are available from my Homebrew tap. You can get access to it in a few ways:
Linguist
role.Help Wanted
in the Issue Tracker.However, if you don't want to do any of the above, you can always compile Cork yourself. See below for instructions.
Do you run a blog, a magazine, make videos, or just make content about apps for fun? Get in touch at [email protected]!
I will provide you with the newest release and development version, answer any questions you have, and introduce you to Cork personally (and for free, or course), so you can focus on creating.
Compiling Cork is simple, as it does not have many dependencies. It uses Tuist to generate Xcode projects to speed up compilation.
Prerequisites:
Skip if you already have an Apple Developer account
Xcode β Settings
, and in the window that opens, click Accounts
. You can add your account thereManage Certificates...
Apple Development
Apple Development Certificates
, you can press Done
to close the account managerSkip if you already have Tuist and Mise installed
Cork uses Mise to prevent conflicts arising from mismatched Tuist versions across Macs. Mise is a tool similar to Homebrew, but offers some advantages for Tusit specifically, like the aforementioned version synchronization.
curl https://mise.run | sh
mise: run the following to activate mise in your shell:
.echo "eval \"\$(/Users/david/.local/bin/mise activate zsh)\"" >> "/Users/david/.zshrc"
[!CAUTION] Make sure to copy the command Mise itself gives you, and not the one I used above. This command is only valid for my Mac, and will not work on your machine.
mise
to your path using one of the following commands, depending on your shell.echo 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrc
echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc
echo '~/.local/bin/mise activate fish | source' >> ~/.config/fish/config.fish
[!TIP] zsh is the default macOS shell.
[!NOTE] If you don't know which shell you're running, use the command
echo $SHELL
. The last part of the output after the last slash is the name of your shell In my case, the output of the command is/bin/zsh
. This means my shell iszsh
mise install tuist
git clone https://github.com/buresdv/Cork.git && cd Cork && mise use [email protected] && tuist install && tuist generate --no-binary-cache
. Xcode will open the project.Cork
at the very top. It's the icon with the App Store logoSigning & Capabilities
at the topSigning
, switch the Team
dropdown to None
Signing β macOS
, switch the Signing Certificate
to Sign to Run Locally
Self-Compiled
in Xcode's toolbar.[!WARNING] If you don't select the correct Build Scheme, Cork will require you to put in a license.
Product β Archive
and wait for the building to finishDistribute App
Custom
, then click Next
in the bottom right of the popupCopy App
/Applications/
folder, and you're done!Cork is licensed under Commons Clause.
This means that Cork's source source is available and you can modify it, contribute to it etc., but you can't sell or distribute Cork or modified versions of it.
Moreover, you canβt distribute compiled versions of Cork without consulting me first. Compiling versions for your personal use is fine.