├── .github ├── CODE_OF_CONDUCT.md ├── README.md └── funding.yml ├── Brewfile ├── LICENSE └── guided-install.sh /.github/CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Covenant Code of Conduct 2 | 3 | ## Our Pledge 4 | 5 | We as members, contributors, and leaders pledge to make participation in our 6 | community a harassment-free experience for everyone, regardless of age, body 7 | size, visible or invisible disability, ethnicity, sex characteristics, gender 8 | identity and expression, level of experience, education, socio-economic status, 9 | nationality, personal appearance, race, religion, or sexual identity 10 | and orientation. 11 | 12 | We pledge to act and interact in ways that contribute to an open, welcoming, 13 | diverse, inclusive, and healthy community. 14 | 15 | ## Our Standards 16 | 17 | Examples of behavior that contributes to a positive environment for our 18 | community include: 19 | 20 | * Demonstrating empathy and kindness toward other people 21 | * Being respectful of differing opinions, viewpoints, and experiences 22 | * Giving and gracefully accepting constructive feedback 23 | * Accepting responsibility and apologizing to those affected by our mistakes, 24 | and learning from the experience 25 | * Focusing on what is best not just for us as individuals, but for the 26 | overall community 27 | 28 | Examples of unacceptable behavior include: 29 | 30 | * The use of sexualized language or imagery, and sexual attention or 31 | advances of any kind 32 | * Trolling, insulting or derogatory comments, and personal or political attacks 33 | * Public or private harassment 34 | * Publishing others' private information, such as a physical or email 35 | address, without their explicit permission 36 | * Other conduct which could reasonably be considered inappropriate in a 37 | professional setting 38 | 39 | ## Enforcement Responsibilities 40 | 41 | Community leaders are responsible for clarifying and enforcing our standards of 42 | acceptable behavior and will take appropriate and fair corrective action in 43 | response to any behavior that they deem inappropriate, threatening, offensive, 44 | or harmful. 45 | 46 | Community leaders have the right and responsibility to remove, edit, or reject 47 | comments, commits, code, wiki edits, issues, and other contributions that are 48 | not aligned to this Code of Conduct, and will communicate reasons for moderation 49 | decisions when appropriate. 50 | 51 | ## Scope 52 | 53 | This Code of Conduct applies within all community spaces, and also applies when 54 | an individual is officially representing the community in public spaces. 55 | Examples of representing our community include using an official e-mail address, 56 | posting via an official social media account, or acting as an appointed 57 | representative at an online or offline event. 58 | 59 | ## Enforcement 60 | 61 | Instances of abusive, harassing, or otherwise unacceptable behavior may be 62 | reported to the community leaders responsible for enforcement at 63 | Alicia Sykes . 64 | All complaints will be reviewed and investigated promptly and fairly. 65 | 66 | All community leaders are obligated to respect the privacy and security of the 67 | reporter of any incident. 68 | 69 | ## Enforcement Guidelines 70 | 71 | Community leaders will follow these Community Impact Guidelines in determining 72 | the consequences for any action they deem in violation of this Code of Conduct: 73 | 74 | ### 1. Correction 75 | 76 | **Community Impact**: Use of inappropriate language or other behavior deemed 77 | unprofessional or unwelcome in the community. 78 | 79 | **Consequence**: A private, written warning from community leaders, providing 80 | clarity around the nature of the violation and an explanation of why the 81 | behavior was inappropriate. A public apology may be requested. 82 | 83 | ### 2. Warning 84 | 85 | **Community Impact**: A violation through a single incident or series 86 | of actions. 87 | 88 | **Consequence**: A warning with consequences for continued behavior. No 89 | interaction with the people involved, including unsolicited interaction with 90 | those enforcing the Code of Conduct, for a specified period of time. This 91 | includes avoiding interactions in community spaces as well as external channels 92 | like social media. Violating these terms may lead to a temporary or 93 | permanent ban. 94 | 95 | ### 3. Temporary Ban 96 | 97 | **Community Impact**: A serious violation of community standards, including 98 | sustained inappropriate behavior. 99 | 100 | **Consequence**: A temporary ban from any sort of interaction or public 101 | communication with the community for a specified period of time. No public or 102 | private interaction with the people involved, including unsolicited interaction 103 | with those enforcing the Code of Conduct, is allowed during this period. 104 | Violating these terms may lead to a permanent ban. 105 | 106 | ### 4. Permanent Ban 107 | 108 | **Community Impact**: Demonstrating a pattern of violation of community 109 | standards, including sustained inappropriate behavior, harassment of an 110 | individual, or aggression toward or disparagement of classes of individuals. 111 | 112 | **Consequence**: A permanent ban from any sort of public interaction within 113 | the community. 114 | 115 | ## Attribution 116 | 117 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], 118 | version 2.0, available at 119 | https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. 120 | 121 | Community Impact Guidelines were inspired by [Mozilla's code of conduct 122 | enforcement ladder](https://github.com/mozilla/diversity). 123 | 124 | [homepage]: https://www.contributor-covenant.org 125 | 126 | For answers to common questions about this code of conduct, see the FAQ at 127 | https://www.contributor-covenant.org/faq. Translations are available at 128 | https://www.contributor-covenant.org/translations. 129 | -------------------------------------------------------------------------------- /.github/README.md: -------------------------------------------------------------------------------- 1 | 2 |

Lissy93/Brewfile

3 |

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

4 |

5 | 6 | 7 | 8 |

9 | 10 | 11 | ## Getting Started 12 | 13 | 14 | 15 | To get started, install [Homebrew](https://docs.brew.sh/Installation), then just download the [`Brewfile`](https://github.com/Lissy93/Brewfile/blob/master/Brewfile) to `~/.Brewfile`, make any desired changes, and run `brew bundle --global` to install the listed packages. Done 🍻 16 | 17 | --- 18 | 19 | Alternatively, there's a guided install process, which can be initiated with: 20 | 21 | ```bash 22 | bash <(curl -s https://lissy93.github.io/Brewfile/install.sh) 23 | ``` 24 | 25 |

26 | 27 | Brewfile automated installation script 28 | 29 |

30 | 31 | > [!NOTE] 32 | > To keep track of your own personal package list [fork](https://github.com/Lissy93/Brewfile/fork) this repo
33 | > And don't forget to replace [lissy93] with your own username! 34 | 35 | --- 36 | 37 | ## About Homebrew 38 | 39 | [Homebrew](https://brew.sh/) is an unofficial package manager for MacOS, that makes installing, updating and managing user applications easier. 40 | 41 | 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. 42 | 43 | Homebrew is used via the terminal, with the `brew` command, but there is an unofficial GUI, [Cakebrew](https://github.com/brunophilipe/Cakebrew). For more infomation, take a look at the [Documentation](https://docs.brew.sh/). 44 | 45 | --- 46 | 47 | ## Understanding the Brewfile 48 | 49 | The Brewfile defines a list of packages, that you'd like to install on your system. 50 | 51 | It includes several keywords, like `brew`, `cask`, `tap`, `mas`, etc - this is explained in detail in the [terminology](https://docs.brew.sh/Manpage#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. 52 | 53 | --- 54 | 55 | ## Package List 56 | 57 | The following packages will be installed, with the aim to setup a fully-featured development machine. 58 | 59 |
60 | Click to expand full package list ↕️ 61 | 62 | > **Note**: _Be sure to remove anything that you do not need before installing._ 63 | 64 | ### Command Line 65 | 66 |
67 | CLI Essentials 68 | 69 | - [`git`](https://git-scm.com/) - Version controll 70 | - [`neovim`](https://neovim.io/) - Text editor 71 | - [`ranger`](https://ranger.github.io/) - Directory browser 72 | - [`tmux`](https://github.com/tmux/tmux/wiki) - Term multiplexer 73 | 74 |
75 | 76 |
77 | CLI Basics 78 | 79 | - [`aria2`](https://github.com/aria2/aria2) - Resuming download util _(better wget)_ 80 | - [`bat`](https://github.com/sharkdp/bat) - Output highlighting _(better cat)_ 81 | - [`ctags`](https://github.com/universal-ctags/ctags) - Indexing of file info + headers 82 | - [`diff-so-fancy`](https://github.com/so-fancy/diff-so-fancy) - Readable file compares _(better diff)_ 83 | - [`entr`](https://eradman.com/entrproject/) - Run command whenever file changes 84 | - [`duf`](https://github.com/muesli/duf) - Get info on mounted disks _(better df)_ 85 | - [`exa`](https://github.com/ogham/exa) - Listing files with info _(better ls)_ 86 | - [`exiftool`](https://exiftool.org/) - Reading and writing exif metadata 87 | - [`fdupes`](https://github.com/jbruchon/jdupes) - Duplicate file finder 88 | - [`fzf`](https://github.com/junegunn/fzf) - Fuzzy file finder and filtering 89 | - [`hyperfine`](https://github.com/sharkdp/hyperfine) - Benchmarking for arbitrary commands 90 | - [`jq`](https://github.com/stedolan/jq) - JSON parser 91 | - [`most`](https://www.jedsoft.org/most/) - Multi-window scroll pager _(better less)_ 92 | - [`procs`](https://github.com/dalance/procs) - Advanced process viewer _(better ps)_ 93 | - [`ripgrep`](https://github.com/BurntSushi/ripgrep) - Searching within files _(better grep)_ 94 | - [`rsync`](https://rsync.samba.org/) - Fast, incremental file transfer 95 | - [`scc`](https://github.com/boyter/scc) - Count lines of code _(better cloc)_ 96 | - [`sd`](https://github.com/chmln/sd) - RegEx find and replace _(better sed)_ 97 | - [`thefuck`](https://github.com/nvbn/thefuck) - Auto-correct miss-typed commands 98 | - [`tldr`](https://github.com/tldr-pages/tldr) - Community-maintained docs _(better man)_ 99 | - [`tree`](https://gitlab.com/OldManProgrammer/unix-tree) - Directory listings as tree 100 | - [`trash-cli`](https://github.com/andreafrancia/trash-cli) - Record + restore removed files 101 | - [`watch`](https://gitlab.com/procps-ng/procps) - Run commands periorically 102 | - [`xsel`](https://github.com/kfish/xsel) - Copy paste access to X clipboard 103 | - [`zoxide`](https://github.com/ajeetdsouza/zoxide) - Easy navigation _(better cd)_ 104 | 105 |
106 | 107 |
108 | CLI Monitoring and Performance Apps 109 | 110 | - [`bandwhich`](https://github.com/imsnif/bandwhich) - Bandwidth utilization monitor 111 | - [`ctop`](https://github.com/bcicen/ctop) - Container metrics and monitoring 112 | - [`bpytop`](https://github.com/aristocratos/bpytop) - Resource monitoring _(like htop)_ 113 | - [`glances`](https://github.com/nicolargo/glances) - Resource monitor + web and API 114 | - [`gping`](https://github.com/orf/gping) - Interactive ping tool, with graph 115 | - [`ncdu`](https://dev.yorhel.nl/ncdu) - Disk usage analyzer and monitor _(better du)_ 116 | - [`speedtest-cli`](https://github.com/sivel/speedtest-cli) - Command line speed test utility 117 | 118 |
119 | 120 |
121 | CLI Productivity Apps 122 | 123 | - [`browsh`](https://github.com/browsh-org/browsh) - CLI web browser 124 | - [`buku`](https://github.com/jarun/buku) - Bookmark manager 125 | - [`cmus`](https://github.com/cmus/cmus) - Music browser / player 126 | - [`khal`](https://github.com/pimutils/khal) - Calendar client 127 | - [`mutt`](https://gitlab.com/muttmua/mutt) - Email client 128 | - [`newsboat`](https://github.com/newsboat/newsboat) - RSS / ATOM news reader 129 | - [`rclone`](https://github.com/rclone/rclone) - Manage cloud storage 130 | - [`task`](https://github.com/GothenburgBitFactory/taskwarrior) - Todo + task management 131 | 132 |
133 | 134 |
135 | CLI Dev Suits 136 | 137 | - [`httpie`](https://httpie.io/) - HTTP / API testing testing client 138 | - [`lazydocker`](https://github.com/jesseduffield/lazydocker) - Full Docker management app 139 | - [`lazygit`](https://github.com/jesseduffield/lazygit) - Full Git managemtne app 140 | 141 |
142 | 143 |
144 | CLI External Sercvices 145 | 146 | - [`ngrok`](https://ngrok.com/) - Reverse proxy for sharing localhost 147 | - [`tmate`](https://github.com/tmate-io/tmate) - Share a terminal session via internet 148 | - [`asciinema`](https://asciinema.org/) - Recording + sharing terminal sessions 149 | - [`navi`](https://github.com/denisidoro/navi) - Browse, search, read cheat sheets 150 | 151 |
152 | 153 |
154 | CLI Fun 155 | 156 | - [`cowsay`](https://github.com/piuccio/cowsay) - Have an ASCII cow say your message 157 | - [`figlet`](http://www.figlet.org/) - Output text as big ASCII art text 158 | - [`lolcat`](https://github.com/busyloop/lolcat) - Make console output raibow colored 159 | - [`neofetch`](https://github.com/dylanaraps/neofetch) - Show system data and ditstro info 160 | 161 |
162 | 163 | ### Software Development 164 | 165 |
166 | Development Apps 167 | 168 | - [Android Studio](https://developer.android.com/studio/) - IDE for Android development 169 | - [Boop](https://github.com/IvanMathy/Boop) - Test transformation tool _(MacOS Only)_ 170 | - [iterm2](https://iterm2.com/) - Better terminal emulator _(MacOS Only)_ 171 | - [Postman](https://www.postman.com/) - HTTP API testing app 172 | - [Sourcetree](https://www.sourcetreeapp.com/) - Git visual client _(MacOS Only)_ 173 | - [Virtual Box](https://www.virtualbox.org/) - VM management console 174 | - [VS Code](https://code.visualstudio.com/) - Code editor 175 | 176 |
177 | 178 |
179 | Development Langs, Compilers, Package Managers and SDKs 180 | 181 | - `docker` - Containers 182 | - `gcc` - GNU C++ compilers 183 | - `go` - Compiler for Go Lang 184 | - `gradle` - Build tool for Java 185 | - `lua` - Lua interpreter 186 | - `luarocks` - Package manager for Lua 187 | - `node` - Node.js 188 | - `nvm` - Switching node versions 189 | - `openjdk` - Java development kit 190 | - `python` - Python interpriter 191 | - `rust` - Rust language 192 | - `android-sdk` - Android software dev kit 193 | 194 |
195 | 196 |
197 | Development Utils 198 | 199 | - [`gh`](https://cli.github.com/) - Interact with GitHub PRs, issues, repos 200 | - [`scrcpy`](https://github.com/Genymobile/scrcpy) - Display and control Andrdroid devices 201 | - [`terminal-notifier`](https://github.com/julienXX/terminal-notifier) - Trigger Mac notifications from terminal _(MacOS Only)_ 202 | - [`tig`](https://jonas.github.io/tig/) - Text-mode interface for git 203 | - [`ttygif`](https://github.com/icholy/ttygif) - Generate GIF from terminal commands + output 204 | 205 |
206 | 207 |
208 | Network and Security Testing 209 | 210 | - [`bettercap`](https://www.bettercap.org/) - Network, scanning and moniroting 211 | - [`nmap`](https://nmap.org/) - Port scanning 212 | - [`wrk`](https://github.com/giltene/wrk2) - HTTP benchmarking 213 | - [`burp-suite`](https://portswigger.net/burp) - Web security testing 214 | - [`metasploit`](https://www.metasploit.com/) - Pen testing framework 215 | - [`owasp-zap`](https://owasp.org/www-project-zap/) - Web app security scanner 216 | - [`wireshark`](https://www.wireshark.org/) - Network analyzer + packet capture 217 | 218 |
219 | 220 |
221 | Security Utilities 222 | 223 | - [`bcrypt`](https://bcrypt.sourceforge.net/) - Encryption utility, using blowfish 224 | - [`clamav`](https://www.clamav.net/) - Open source virus scanning suite 225 | - [`git-crypt`](https://www.agwa.name/projects/git-crypt/) - Transparent encryption for git repos 226 | - [`lynis`](https://cisofy.com/lynis/) - Scan system for common security issues 227 | - [`openssl`](https://www.openssl.org/) - Cryptography and SSL/TLS Toolkit 228 | - [`rkhunter`](https://rkhunter.sourceforge.net/) - Search / detect potential root kits 229 | - [`veracrypt`](https://www.veracrypt.fr/code/VeraCrypt/) - File and volume encryption 230 | 231 |
232 | 233 | ### Desktop Applications 234 | 235 |
236 | Creativity 237 | 238 | - [Audacity](https://www.audacityteam.org/) - Multi-track audio editor and recording 239 | - [Blender](https://www.blender.org/) - 3D modelling, rendering and sculpting 240 | - [Cura](https://ultimaker.com/software/ultimaker-cura) - 3D Printing software, for slicing models 241 | - [DarkTable](https://www.darktable.org/) - Organize and bulk edit photos (similar to Lightroom) 242 | - [Dia](https://wiki.gnome.org/Apps/Dia) - Versatile diagramming tool, useful for UML 243 | - [Gimp](https://www.gimp.org/) - Image and photo editing application 244 | - [HandBrake](https://handbrake.fr/) - For converting video from any format to a selection of modern codecs 245 | - [InkScape](https://inkscape.org/) - Digital drawing/ illustration 246 | - [OBS Studio](https://obsproject.com/) - Streaming and screencasting 247 | - [Shotcut](https://www.shotcut.org/) - Video editor 248 | - [Synfig Studio](https://www.synfig.org/) - 2D animation 249 | 250 |
251 | 252 |
253 | Media 254 | 255 | - [Calibre](https://calibre-ebook.com/) - E-Book reader 256 | - [Spotify](https://spotify.com) - Propietary music streaming 257 | - [Transmission](https://transmissionbt.com/) - Torrent client 258 | - [VLC](https://www.videolan.org/vlc/) - Media player 259 | - [Pandoc](https://pandoc.org/) - Universal file converter 260 | - [Youtube-dl](https://youtube-dl.org/) - YouTube video downloader 261 | 262 |
263 | 264 |
265 | Personal Applications 266 | 267 | - [1Password](https://1password.com/) - Password manager _(proprietary)_ 268 | - [Tresorit](https://tresorit.com/) - Encrypted file backup _(proprietary)_ 269 | - [Standard Notes](https://standardnotes.com/) - Encrypted synced notes 270 | - [Signal](https://www.signal.org) - Link to encrypted mobile messenger 271 | - [Ledger Live](https://www.ledger.com/ledger-live) - Crypto hardware wallet manager 272 | - [ProtonMail-Bridge](https://proton.me/mail/bridge) - Decrypt ProtonMail emails 273 | - [ProtonVPN](https://protonvpn.com/) - Client app for ProtonVPN 274 | 275 |
276 | 277 |
278 | Browsers 279 | 280 | - [Firefox](https://www.mozilla.org/en-GB/firefox/) 281 | - [Chromium](https://github.com/ungoogled-software/ungoogled-chromium) 282 | - [Tor](https://www.torproject.org/) 283 | 284 |
285 | 286 | ### MacOS Apps 287 | 288 |
289 | MacOS Mods and Imrovments 290 | 291 | - `alt-tab` - Much better alt-tab window switcher 292 | - `anybar` - Custom programatic menubar icons 293 | - `copyq` - Clipboard manager _(cross platform)_ 294 | - `espanso` - Live text expander _(cross-platform)_ 295 | - `finicky` - Website-specific default browser 296 | - `hiddenbar` - Hide / show annoying menubar icons 297 | - `iproute2mac` - MacOS port of netstat and ifconfig 298 | - `lporg` - Backup and restore launchpad layout 299 | - `m-cli` - All in one MacOS management CLI app 300 | - `mjolnir` - Util for loading Lua automations 301 | - `openinterminal` - Finder button, opens directory in terminal 302 | - `popclip` - Popup options for text on highlight 303 | - `raycast` - Spotlight alternative 304 | - `shottr` - Better screenshot utility 305 | - `skhd` - Hotkey daemon for macOS 306 | - `stats` - System resource usage in menubar 307 | - `yabai` - Tiling window manager 308 | 309 |
310 | 311 |
312 | 313 | --- 314 | 315 | ## Bigger Picture 316 | 317 | The Brewfile is really useful to incorporate into your dotfiles, or for quickly setting up new machines. 318 | You can see how I am using this in [Lissy93/Dotfiles](https://github.com/Lissy93/dotfiles). 319 | Other package managers have similar features. For example, [here's the scripts](https://github.com/Lissy93/dotfiles/tree/master/scripts/installs) I use to manage my package list for Arch, Debian, Alpine and MacOS. 320 | 321 | --- 322 | 323 | ## Contributing 324 | 325 | Contributions are welcome :) 326 | If you're new to GitHub, see the [documentation](https://docs.github.com/en/get-started/quickstart/contributing-to-projects) for a step-by-step guide on how to submit edits to projects. 327 | 328 | Changes to the Brewfile should be made up-stream, directly into [Lissy93/Dotfiles](https://github.com/lissy93/dotfiles) (in [`Brewfile`](https://github.com/Lissy93/dotfiles/blob/master/scripts/installs/Brewfile)), which will then be automatically synced to this repo. 329 | 330 | --- 331 | 332 | ## License 333 | 334 | > [!NOTE] 335 | > > For licenses for each package listed here, see their websites _(linked to [above](#package-list))_. 336 | 337 | > _**[Lissy93/Brewfile](https://github.com/Lissy93/Brewfile)** is licensed under [MIT](https://github.com/Lissy93/Brewfile/blob/HEAD/LICENSE) © [Alicia Sykes](https://aliciasykes.com) 2022._
338 | > For information, see TLDR Legal > MIT 339 | 340 |
341 | Expand License 342 | 343 | ``` 344 | The MIT License (MIT) 345 | Copyright (c) Alicia Sykes 346 | 347 | Permission is hereby granted, free of charge, to any person obtaining a copy 348 | of this software and associated documentation files (the "Software"), to deal 349 | in the Software without restriction, including without limitation the rights 350 | to use, copy, modify, merge, publish, distribute, sub-license, and/or sell 351 | copies of the Software, and to permit persons to whom the Software is furnished 352 | to do so, subject to the following conditions: 353 | 354 | The above copyright notice and this permission notice shall be included install 355 | copies or substantial portions of the Software. 356 | 357 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, 358 | INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANT ABILITY, FITNESS FOR A 359 | PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 360 | HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 361 | OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 362 | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 363 | ``` 364 | 365 |
366 | 367 | --- 368 | 369 | 370 |

371 | © Alicia Sykes 2022-23
372 | Licensed under MIT
373 |
374 | Thanks for visiting :) 375 |

376 | 377 | 378 | 390 | -------------------------------------------------------------------------------- /.github/funding.yml: -------------------------------------------------------------------------------- 1 | github: lissy93 2 | custom: ['https://notes.aliciasykes.com/tip'] 3 | -------------------------------------------------------------------------------- /Brewfile: -------------------------------------------------------------------------------- 1 | ############################################################# 2 | # ~/.Brewfile - Software Installs for MacOS # 3 | # # 4 | # List of packages to be installed / updated via Homebrew # 5 | # Apps are sorted by category, and arranged alphabetically # 6 | # Be sure to delete / comment out anything you do not need # 7 | # Usage, run: $ brew bundle --global --file $HOME/.Brewfile # 8 | # Source GH repository: https://github.com/lissy93/Brewfile # 9 | # See brew docs for more info: https://docs.brew.sh/Manpage # 10 | # # 11 | # License: MIT © Alicia Sykes 2022 # 12 | ############################################################# 13 | 14 | # Options 15 | cask_args appdir: '~/Applications', require_sha: true 16 | 17 | # Taps 18 | tap 'homebrew/bundle' 19 | tap 'homebrew/core' 20 | tap 'homebrew/services' 21 | tap 'blacktop/tap' 22 | tap 'browsh-org/homebrew-browsh' 23 | tap 'espanso/espanso' 24 | tap 'jesseduffield/lazygit' 25 | tap 'koekeishiya/formulae' 26 | tap 'kdash-rs/kdash' 27 | 28 | ############################################################# 29 | # Command Line # 30 | ############################################################# 31 | 32 | # CLI Essentials 33 | brew 'git' # Version controll 34 | brew 'neovim' # Text editor 35 | brew 'ranger' # Directory browser 36 | brew 'tmux' # Term multiplexer 37 | 38 | # CLI Basics 39 | brew 'aria2' # Resuming download util (better wget) 40 | brew 'bat' # Output highlighting (better cat) 41 | brew 'broot' # Interactive directory navigation 42 | brew 'ctags' # Indexing of file info + headers 43 | brew 'diff-so-fancy'# Readable file compares (better diff) 44 | brew 'duf' # Get info on mounted disks (better df) 45 | brew 'entr' # Run command whenever file changes 46 | brew 'exa' # Listing files with info (better ls) 47 | brew 'exiftool' # Read, write and modify exif data 48 | brew 'fzf' # Fuzzy file finder and filtering 49 | brew 'hyperfine' # Benchmarking for arbitrary commands 50 | brew 'jdupes' # Duplicate file finder 51 | brew 'just' # Powerful command runner (better make) 52 | brew 'jq' # JSON parser, output and query files 53 | brew 'most' # Multi-window scroll pager (better less) 54 | brew 'procs' # Advanced process viewer (better ps) 55 | brew 'ripgrep' # Searching within files (better grep) 56 | brew 'rsync' # Fast incremental file transfer 57 | brew 'sd' # RegEx find and replace (better sed) 58 | brew 'thefuck' # Auto-correct miss-typed commands 59 | brew 'tldr' # Community-maintained docs (better man) 60 | brew 'tokei' # Count lines of code (better cloc) 61 | brew 'tree' # Directory listings as tree structure 62 | brew 'trash-cli' # Record and restore removed files 63 | brew 'watch' # Run commands periorically 64 | brew 'xsel' # Copy paste access to the X clipboard 65 | brew 'zoxide' # Auto-learning navigation (better cd) 66 | 67 | # CLI Monitoring and Performance Apps 68 | brew 'bmon' # Bandwidth utilization monitor 69 | brew 'ctop' # Container metrics and monitoring 70 | brew 'dog' # DNS lookup client (better dig) 71 | brew 'bpytop' # Resource monitoring (like htop) 72 | brew 'dua-cli' # Disk usage analyzer and monitor (better du) 73 | brew 'glances' # Resource monitor + web and API 74 | brew 'goaccess' # Web log analyzer and viewer 75 | brew 'gping' # Interactive ping tool, with graph 76 | brew 'speedtest-cli'# Command line speed test utility 77 | 78 | # CLI Productivity Apps 79 | brew 'aspell' # Spell check 80 | brew 'browsh' # Web browser, in terminal 81 | brew 'buku' # Bookmark manager 82 | brew 'cmus' # Music player 83 | brew 'cointop' # Crypto prices and portfolio 84 | brew 'ddgr' # Web search, via DuckDuckGo 85 | brew 'khal' # Calendar client 86 | brew 'mutt' # Email client 87 | brew 'newsboat' # RSS / ATOM reader 88 | brew 'pass' # Password store 89 | brew 'rclone' # Manage cloud storage 90 | brew 'task' # Todo + task management 91 | 92 | # CLI Development Suits 93 | brew 'httpie' # HTTP / API testing testing client 94 | brew 'lazydocker' # Full Docker management app 95 | brew 'lazygit' # Full Git management app 96 | brew 'kdash' # Kubernetes management 97 | 98 | # CLI External Sercvices 99 | cask 'ngrok' # Reverse proxy for sharing localhost 100 | brew 'tmate' # Share a terminal session via internet 101 | brew 'asciinema' # Recording + sharing terminal sessions 102 | brew 'navi' # Browse, search, read cheat sheets 103 | 104 | # CLI Fun 105 | brew 'cowsay' # Have an ASCII cow say your message 106 | brew 'figlet' # Output text as big ASCII art text 107 | brew 'lolcat' # Make console output rainbow colored 108 | brew 'neofetch' # Show system data and ditstro info 109 | brew 'pipes-sh' # Cool terminal pipe screen saver 110 | brew 'pv' # Pipe viewer, with animation options 111 | 112 | ############################################################# 113 | # Software Development # 114 | ############################################################# 115 | 116 | # Development Apps 117 | cask 'android-studio' # IDE for Android development 118 | cask 'boop' # Text transformation tool 119 | brew 'gradle' # Build automation for Java 120 | cask 'iterm2' # Better terminal emulator 121 | cask 'postman' # HTTP API testing app 122 | cask 'sourcetree' # Git visual client 123 | cask 'visual-studio-code' # Code editor 124 | 125 | # Development Langs, Compilers, Package Managers and SDKs 126 | brew 'gcc' # GNU C++ compilers 127 | brew 'go' # Compiler for Go Lang 128 | brew 'lua' # Lua interpreter 129 | brew 'luarocks' # Package manager for Lua 130 | brew 'node' # Node.js 131 | brew 'nvm' # Switching node versions 132 | brew 'openjdk' # Java development kit 133 | brew 'python' # Python interpreter 134 | brew 'rust' # Rust language 135 | cask 'android-sdk' # Android software dev kit 136 | 137 | # DevOps 138 | brew 'ansible' # Automation 139 | brew 'docker' # Containers 140 | 141 | # Development Utils 142 | brew 'gh' # Interact with GitHub PRs, issues, repos 143 | brew 'git-extras' # Extra git commands for common tasks 144 | brew 'scrcpy' # Display and control Android devices 145 | brew 'terminal-notifier' # Trigger Mac notifications from terminal 146 | brew 'tig' # Text-mode interface for git 147 | brew 'ttygif' # Generate GIF from terminal commands + output 148 | brew 'watchman' # Watch for changes and reload dev server 149 | 150 | # Network and Security Testing 151 | brew 'bettercap' # Network, scanning and monitoring 152 | brew 'nmap' # Port scanning 153 | brew 'wrk' # HTTP benchmarking 154 | cask 'burp-suite' # Web security testing 155 | cask 'owasp-zap' # Web app security scanner 156 | cask 'wireshark' # Network analyzer + packet capture 157 | 158 | # Security Utilities and Data Encryption 159 | brew 'bcrypt' # Encryption utility, using blowfish 160 | brew 'borgbackup' # Encrypted, deduplicated backups 161 | brew 'clamav' # Open source virus scanning suite 162 | brew 'dnscrypt-proxy' # Proxy for using encrypted DNS 163 | cask 'gpg-suite' # PGP encryption for emails and files 164 | brew 'git-crypt' # Transparent encryption for git repos 165 | brew 'lynis' # Scan system for common security issues 166 | brew 'openssl' # Cryptography and SSL/TLS Toolkit 167 | brew 'rkhunter' # Search / detect potential root kits 168 | cask 'veracrypt' # File and volume encryption 169 | 170 | ############################################################# 171 | # Desktop Applications # 172 | ############################################################# 173 | 174 | # Creativity 175 | cask 'audacity' # Audio editor / recorder 176 | cask 'gimp' # Photo editor 177 | brew 'handbrake' # Video transcoder 178 | cask 'inkscape' # Vector editor 179 | cask 'obs' # Screencasting / recording 180 | cask 'shotcut' # Video editor 181 | 182 | # Media 183 | cask 'calibre' # E-Book reader 184 | cask 'spotify', args: { require_sha: false } # Propietary music streaming 185 | cask 'transmission' # Torrent client 186 | cask 'vlc' # Media player 187 | brew 'pandoc' # Universal file converter 188 | brew 'youtube-dl' # YouTube video downloader 189 | 190 | # Personal Applications 191 | cask '1password' # Password manager (proprietary) 192 | cask 'tresorit' # Encrypted file backup (proprietary) 193 | cask 'standard-notes' # Encrypted synced notes 194 | cask 'signal' # Link to encrypted mobile messenger 195 | cask 'ledger-live' # Crypto hardware wallet manager 196 | cask 'mountain-duck' # Mount remote storage locations 197 | cask 'protonmail-bridge' # Decrypt ProtonMail emails 198 | cask 'protonvpn' # Client app for ProtonVPN 199 | cask 'vorta' # GUI for BorgBackup 200 | 201 | # Browsers 202 | cask 'firefox' 203 | cask 'chromium' 204 | cask 'orion' 205 | 206 | ############################################################# 207 | # MacOS-Specific Stuff # 208 | ############################################################# 209 | 210 | # Fonts 211 | tap 'homebrew/cask-fonts' 212 | cask 'font-fira-code' 213 | cask 'font-hack' 214 | cask 'font-inconsolata' 215 | cask 'font-meslo-lg-nerd-font' 216 | 217 | # Mac OS Quick-Look Plugins 218 | cask 'qlcolorcode' # QL for code with highlighting 219 | cask 'qlimagesize' # QL for size info for images 220 | cask 'qlmarkdown' # QL for markdown files 221 | cask 'qlprettypatch' # QL for patch / diff files 222 | cask 'qlstephen' # QL for dev text files 223 | cask 'qlvideo' # QL for video formats 224 | cask 'quicklook-csv' # QL for tables in CSV format 225 | cask 'quicklook-json', args: { require_sha: false } # QL for JSON, with trees 226 | cask 'quicklookapk', args: { require_sha: false } # QL for Android APKs 227 | cask 'webpquicklook', args: { require_sha: false } # QL for WebP image files 228 | 229 | # Mac OS Mods and Imrovments 230 | cask 'alt-tab' # Much better alt-tab window switcher 231 | cask 'anybar' # Custom programmatic menubar icons 232 | cask 'copyq' # Clipboard manager (cross platform) 233 | cask 'espanso' # Live text expander (cross-platform) 234 | cask 'finicky' # Website-specific default browser 235 | cask 'hiddenbar' # Hide / show annoying menubar icons 236 | brew 'iproute2mac' # MacOS port of netstat and ifconfig 237 | brew 'lporg' # Backup and restore launchpad layout 238 | brew 'm-cli' # All in one MacOS management CLI app 239 | cask 'mjolnir' # Util for loading Lua automations 240 | cask 'openinterminal' # Finder button, opens directory in terminal 241 | cask 'raycast', args: { require_sha: false } # Spotlight alternative 242 | cask 'santa' # Binary authorization for security 243 | cask 'shottr' # Better screenshot utility 244 | brew 'skhd' # Hotkey daemon for macOS 245 | cask 'stats' # System resource usage in menubar 246 | brew 'yabai' # Tiling window manager 247 | 248 | # Mac OS Utility Apps 249 | cask 'coteditor' # Just a simple plain-text editor 250 | cask 'little-snitch' # Firewall app viewing / blocking traffic 251 | cask 'keka' # File archiver and extractor 252 | 253 | # EOF 254 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2022 Alicia Sykes 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /guided-install.sh: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | ###################################################################### 4 | # 🍺 Lissy93/Brewfile - All-in-one install script # 5 | ###################################################################### 6 | # Sets up Homebrew, downloads Brewfile, and bundles listed packages # 7 | # IMPORTANT: Before running, read through everything very carefully! # 8 | # Licensed under MIT (C) Alicia Sykes 2022 # 9 | ###################################################################### 10 | 11 | # User-specified config 12 | BREWFILE_LOCATION="${HOME}/.Brewfile" 13 | REMOTE_BREWFILE="https://raw.githubusercontent.com/Lissy93/Brewfile/HEAD/Brewfile" 14 | 15 | # General config 16 | PARAMS=$* # User-specified parameters 17 | CURRENT_DIR=$(cd "$(dirname ${BASH_SOURCE[0]})" && pwd) 18 | PROMPT_TIMEOUT=15 # When user is prompted for input, skip after x seconds 19 | START_TIME=`date +%s` # Start timer 20 | 21 | # Color Variables 22 | HEADING_COLOR='\033[1;96m' 23 | QUESTION_COLOR='\033[1;93m' 24 | INFO_COLOR='\033[0;33m\x1b[2m' 25 | ERROR_COLOR='\033[1;31m' 26 | RESET='\033[0m' 27 | 28 | install_homebrew () { 29 | echo -en "\n🍺 ${HEADING_COLOR}Installing Homebrew${RESET}\n" 30 | /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 31 | export PATH=/opt/homebrew/bin:$PATH 32 | } 33 | 34 | download_brewfile () { 35 | echo -en "\n📥 ${HEADING_COLOR}Downloading Brewfile${RESET}\n" 36 | if hash "curl" 2> /dev/null; then 37 | curl -o $BREWFILE_LOCATION $REMOTE_BREWFILE 38 | elif hash "wget" 2> /dev/null; then 39 | wget -O $BREWFILE_LOCATION $REMOTE_BREWFILE 40 | else 41 | echo -e "${ERROR_COLOR}Error: Either curl or wget is required to download the Brewfile${RESET}" 42 | exit 1 43 | fi 44 | } 45 | 46 | update_packages () { 47 | echo -en "\n⤴️ ${HEADING_COLOR}Updating packages${RESET}\n" 48 | brew update # Update Brew to latest version 49 | brew upgrade # Upgrade all installed casks 50 | } 51 | 52 | edit_brewfile () { 53 | editor=${VISUAL-${EDITOR-nano}} 54 | echo -en "\n📝 ${HEADING_COLOR}Opening Brewfile in ${editor}${RESET}" 55 | ${editor} $BREWFILE_LOCATION 56 | } 57 | 58 | install_apps () { 59 | echo -en "\n💾 ${HEADING_COLOR}Installing listed apps${RESET}\n" 60 | brew bundle --global --file $BREWFILE_LOCATION 61 | } 62 | 63 | show_intro () { 64 | echo -e "\n${QUESTION_COLOR}🍺 Lissy93/Brewfile - Installation Script${RESET}" 65 | echo -e "${INFO_COLOR}The following steps will be taken:" 66 | echo "- Check Homebrew is installed, prompt to download if not" 67 | echo "- If no Brewfile present, download from GitHub, othwesise prompt user" 68 | echo "- Update Homebrew and upgrade currently installed packages" 69 | echo "- Ask user if they wish to edit Brewfile before continuing" 70 | echo "- Install and bundle all packages listed in the Brewfile" 71 | echo "- Print a summary of changes made and time taken" 72 | echo -e "${RESET}" 73 | } 74 | 75 | # If set to auto-yes - then don't wait for user reply 76 | if [[ $PARAMS == *"--auto-yes"* ]]; then 77 | PROMPT_TIMEOUT=1 78 | REPLY='Y' 79 | fi 80 | 81 | # If --help flag passed, show intro and exit 82 | if [[ $PARAMS == *"--help"* ]]; then 83 | show_intro 84 | exit 85 | fi 86 | 87 | show_intro 88 | 89 | # Check that Homebrew is installed, offer to install it if not present 90 | if ! hash "brew" 2> /dev/null; then 91 | echo -e "\n${QUESTION_COLOR}Homebrew isn't present on this system. Would you like to install it now? (y/N)${RESET}" 92 | read -t $PROMPT_TIMEOUT -n 1 -r 93 | if [[ $REPLY =~ ^[Yy]$ ]]; then 94 | install_homebrew 95 | fi 96 | fi 97 | 98 | # Check that Brewfile isn't already present, then download 99 | if [ -f $BREWFILE_LOCATION ]; then 100 | echo -e "\n${QUESTION_COLOR}Brewfile already exists. Would you like to overwrite it? (y/N)${RESET}" 101 | read -t $PROMPT_TIMEOUT -n 1 -r 102 | if [[ $REPLY =~ ^[Yy]$ ]]; then 103 | download_brewfile 104 | fi 105 | else 106 | download_brewfile 107 | fi 108 | 109 | # Run brew update and upgrade 110 | echo -e "\n${QUESTION_COLOR}Update and upgrade existing packages first? (y/N)${RESET}" 111 | read -t $PROMPT_TIMEOUT -n 1 -r 112 | if [[ $REPLY =~ ^[Yy]$ ]]; then 113 | update_packages 114 | fi 115 | 116 | # Ask user if they'd like to edit the Brewfile before bundling 117 | echo -e "\n${QUESTION_COLOR}Would you like to edit the Brewfile before installing packages? (y/N)${RESET}" 118 | read -t $PROMPT_TIMEOUT -n 1 -r should_edit 119 | if [[ $should_edit =~ ^[Yy]$ ]]; then 120 | edit_brewfile 121 | fi 122 | 123 | # Confirm user is happy to proceed with package installations 124 | echo -e "\n${QUESTION_COLOR}Proceed with installing listed packages? (y/N)${RESET}" 125 | read -t $PROMPT_TIMEOUT -n 1 -r 126 | if [[ $REPLY =~ ^[Yy]$ ]]; then 127 | install_apps 128 | fi 129 | 130 | # Print finishing off message 131 | echo -e "\n✅ ${HEADING_COLOR}Tasks completed sucesfully in $((`date +%s`-START_TIME)) seconds${RESET}" 132 | echo -e "\x1b[2m\n.~~~~.\n\033[0;33m\x1b[2mi====i_\n|cccc|_)\n|cccc|\n\`-==-'\n${RESET}" 133 | echo -e "\033[0;33m\x1b[2mThank you for using Lissy93/Brewfile${RESET}" 134 | unset PROMPT_TIMEOUT 135 | unset REPLY 136 | 137 | # EOF 138 | --------------------------------------------------------------------------------