Lissy93/Brewfile

My list of *nix packages to be installed on MacOS via Homebrew, for the ultimate dev setup

Getting Started

To get started, install Homebrew, then just download the Brewfile to ~/.Brewfile, make any desired changes, and run brew bundle --global to install the listed packages. Done 🍻

Alternatively, there's a guided install process, which can be initiated with:

bash <(curl -s https://lissy93.github.io/Brewfile/install.sh)

[!NOTE] To keep track of your own personal package list fork this repo
And don't forget to replace [lissy93] with your own username!

About Homebrew

Homebrew is an unofficial package manager for MacOS, that makes installing, updating and managing user applications easier.

It only ever installs packages within it's prefix, but then symlinks them to the appropriate place on disk. And since it's just Git and Ruby underneath, it's easy to modify to your liking, and roll back changes if necissary.

Homebrew is used via the terminal, with the brew command, but there is an unofficial GUI, Cakebrew. For more infomation, take a look at the Documentation.

Understanding the Brewfile

The Brewfile defines a list of packages, that you'd like to install on your system.

It includes several keywords, like brew, cask, tap, mas, etc - this is explained in detail in the terminology section of the docs. But in short: Lines which start with brew are packages that are installed via their pre-compiled binaries. Where as casks are applications that require an installer (typically GUI apps). Taps just add additional repositories, and are used when an app's formula isn't published to the main Homebrew repo. And mas is a plugin that enables you to install apps from the Apple App Store from within your Brewfile.

Package List

The following packages will be installed, with the aim to setup a fully-featured development machine.

Bigger Picture

The Brewfile is really useful to incorporate into your dotfiles, or for quickly setting up new machines. You can see how I am using this in Lissy93/Dotfiles. Other package managers have similar features. For example, here's the scripts I use to manage my package list for Arch, Debian, Alpine and MacOS.

Contributing

Contributions are welcome :) If you're new to GitHub, see the documentation for a step-by-step guide on how to submit edits to projects.

Changes to the Brewfile should be made up-stream, directly into Lissy93/Dotfiles (in Brewfile), which will then be automatically synced to this repo.

License

[!NOTE]

For licenses for each package listed here, see their websites (linked to above).

Lissy93/Brewfile is licensed under MIT © Alicia Sykes 2022.
^{For information, see TLDR Legal > MIT}

The MIT License (MIT)
Copyright (c) Alicia Sykes <[email protected]> 

Permission is hereby granted, free of charge, to any person obtaining a copy 
of this software and associated documentation files (the "Software"), to deal 
in the Software without restriction, including without limitation the rights 
to use, copy, modify, merge, publish, distribute, sub-license, and/or sell 
copies of the Software, and to permit persons to whom the Software is furnished 
to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included install 
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANT ABILITY, FITNESS FOR A
PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

© Alicia Sykes 2022-23
Licensed under MIT

^{Thanks for visiting :)}