{"id":28856250,"url":"https://github.com/hayatolab/mac-setup","last_synced_at":"2026-05-05T00:34:03.203Z","repository":{"id":100925527,"uuid":"591584421","full_name":"hayatolab/mac-setup","owner":"hayatolab","description":"This repository contains info on all the Apps / Tools / Settings I use on my Mac.","archived":false,"fork":false,"pushed_at":"2023-01-22T05:42:15.000Z","size":136,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-20T01:33:24.926Z","etag":null,"topics":["brew","macos","setup","tools","vscode","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hayatolab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-01-21T07:06:12.000Z","updated_at":"2024-03-17T11:08:09.000Z","dependencies_parsed_at":"2023-06-10T20:00:12.333Z","dependency_job_id":null,"html_url":"https://github.com/hayatolab/mac-setup","commit_stats":null,"previous_names":["hayatojpg/mac-setup","hayatoinkz/mac-setup","hayatokzn/mac-setup","hayatolab/mac-setup"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hayatolab/mac-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hayatolab%2Fmac-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hayatolab%2Fmac-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hayatolab%2Fmac-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hayatolab%2Fmac-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hayatolab","download_url":"https://codeload.github.com/hayatolab/mac-setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hayatolab%2Fmac-setup/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260852172,"owners_count":23072607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brew","macos","setup","tools","vscode","zsh"],"created_at":"2025-06-20T00:12:53.465Z","updated_at":"2026-05-05T00:34:03.189Z","avatar_url":"https://github.com/hayatolab.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mac Development Setup\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [What Macbook do I have?](#what-macbook-do-i-have)\n- [Homebrew / Terminal / Shell](#homebrew--terminal--shell)\n  - [Homebrew](#homebrew)\n  - [Terminal](#terminal)\n  - [Shell](#shell)\n    - [Install Oh My Zsh and set plugins configuration](#install-oh-my-zsh-and-set-plugins-configuration)\n    - [Customizing ZSH Shell with `.zshrc`](#customizing-zsh-shell-with-zshrc)\n    - [Commands used by my .zshrc](#commands-used-by-my-zshrc)\n    - [Install the latest version of git](#install-the-latest-version-of-git)\n    - [Other command line tools I use](#other-command-line-tools-i-use)\n- [OS Productivity](#os-productivity)\n  - [Window Management](#window-management)\n- [Other Apps I Use Daily](#other-apps-i-use-daily)\n- [OS Settings](#os-settings)\n  - [Finder](#finder)\n- [Menu Bar Customization](#menu-bar-customization)\n  - [System Stats Widgets](#system-stats-widgets)\n  - [Menu Bar Calendar](#menu-bar-calendar)\n- [Web Browser](#web-browser)\n  - [Brave](#brave)\n- [Node.js](#nodejs)\n  - [Global Modules](#global-modules)\n- [VS Code](#vs-code)\n- [Break Timer](#break-timer)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\nThis repository contains info on all the Apps / Tools / Settings I use on my Mac.\n\n## What Macbook do I have?\n\n![MacBook Pro 16 M1 Max](.github/assets/macbook.jpg)\nThese are the specs at a glance:\n\n- Apple M1 Max\n- 32GB RAM\n- 1TB SSD\n\nYou can read more about it [here](https://everymac.com/systems/apple/macbook_pro/specs/macbook-pro-m1-max-10-core-cpu-32-core-gpu-16-2021-specs.html)\n\n## Homebrew / Terminal / Shell\n\n### Homebrew\n\n[Homebrew](https://brew.sh/) allows us to install tools and apps from the command line.\n\nTo install it, open up the built in `Terminal` app and run this command:\n\n```sh\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n```\n\nThis will also install the xcode build tools which is needed by many other developer tools.\n\nAfter Homebrew is done installing, we will use it to install everything else we need.\n\n### Terminal\n\nThe first app I install is to replace the built in `Terminal`.\n\nI prefer [iTerm2](https://iterm2.com/) because:\n\n- Nice [window chrome](https://en.wiktionary.org/wiki/chrome#Noun)\n- Lots of customization options\n- Clickable links\n- Native OS notifications\n\n\u003e Quick aside - \"window chrome\" is another term for the basic structural elements used in a graphical user interface, such as window frames and scroll bars, as opposed to the content. After having a few people review this, I realize not everyone knows / uses that term 😅\n\nThere are a lot of options for a terminal replacement, but I've been using iTerm2 for years and it works great for my needs.\n\nCheckout their documentation for more info on what iTerm2 can do: [https://iterm2.com/documentation.html](https://iterm2.com/documentation.html)\n\nWe install this using a Homebrew \"cask\". Casks are full applications, similar to what you would install from the App store.\n\n```sh\nbrew install iterm2\n```\n\nOnce installed, launch it and customize the settings / preferences to your liking. These are my preferred settings:\n\n- Appearance\n  - Theme\n    - Shades Of Purple\n- Profiles\n  - Default\n    - General -\u003e Working Directory -\u003e Reuse previous session's directory\n    - Colors -\u003e Basic Colors -\u003e Foreground -\u003e Lime Green\n    - Text -\u003e Font -\u003e JetBrainsMono\n      - You can download this font [here](https://github.com/ryanoasis/nerd-fonts/releases/download/v2.3.0/JetBrainsMono.zip).\n      - I use this font in VS Code as well\n    - Text -\u003e Font Size -\u003e 14\n    - Keys -\u003e Key Mappings -\u003e Presets -\u003e Natural Text Editing\n      - This allows me to use the [keyboard shortcuts](https://gist.github.com/hayato-eth/76757cb373b1cab9f1ebe77039709a29) I know and love inside of iTerm2\n\n### Shell\n\nMac now comes with `zsh` as the default [shell](https://en.wikipedia.org/wiki/Comparison_of_command_shells).\n\n#### Install Oh My Zsh and set plugins configuration\n\nTo see what shell is currently your default, run:\n\n```sh\necho $SHELL\n```\n\nTo install the latest version of oh-my-zsh:\n\n```sh\nsh -c \"$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\"\n```\n\nInstall Powerlevel10k using the following command:\n\n```sh\ngit clone https://github.com/romkatv/powerlevel10k.git $ZSH_CUSTOM/themes/powerlevel10k\n```\n\nThen you need to enable it, change the value of ZSH_THEME to following in ~/.zshrc file :\n\n```sh\nZSH_THEME=\"powerlevel10k/powerlevel10k\"\n```\n\nGo to Ruby directory and install Colorls:\n\n```sh\ncd /opt/homebrew/Cellar/ruby/\u003cx.x.x\u003e/bin\n# Then\n./gem install colorls\n```\n\nNow you are ready to link this library to the default one you installed before\n\n```sh\nln -s /opt/homebrew/lib/ruby/gems/\u003cx.x.x\u003e/bin/colorls /usr/local/bin/colorls\n```\n\n#### Customizing ZSH Shell with `.zshrc`\n\nI have a custom `.zshrc` with all of my custom settings including a customized prompt, aliases, PATH variables, colors and more.\n\nIf you do not want to go through the process of customizing your `.zshrc`, you can install [Oh My ZSH Bash](https://ohmyz.sh/) to get a ton of customizations out of the box.\n\nI store my `.zsh` on [github here](https://github.com/hayato-eth/mac-setup/main/src/.zshrc) so I can copy it over to any machine I'm setting up.\n\nCopy this file (or create your own) in your home directory:\n\n```sh\ncd ~\ncurl -O https://raw.githubusercontent.com/hayato-eth/mac-setup/main/src/zsh/.zshrc\n```\n\n#### Commands used by my .zshrc\n\n- [zsh-completions](https://github.com/zsh-users/zsh-completions) - Additional completion definitions for ZSH\n- [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions) - Additional suggestions for ZSH\n- [fast-syntax-highlighting](https://github.com/zdharma-continuum/fast-syntax-highlighting) - Feature-rich syntax highlighting for ZSH\n\n#### Install the latest version of git\n\nMy Mac came with `git` version `2.32.1`, we can use brew to install the latest version of `git`:\n\n```sh\ngit --version\nbrew install git\n```\n\nOpen a new tab / window to start using the latest version:\n\n```sh\ngit --version\n```\n\nConfigure git with your name / email and preferred editor:\n\n```sh\ngit config --global user.name Vinicius Rocha\n\ngit config --global user.email vinicius.workspace@gmail.com\n\ngit config --global core.editor vim\n\ngit config --global init.defaultBranch main\n```\n\nConfiguration for commits:\n\n- [Signing commits using GPG](https://gist.github.com/hayato-eth/458f0622de2990275755e3939413aa64)\n- [SSH Key to Github](https://gist.github.com/hayato-eth/442358ab92b9928a81c8f6d6425a5daa)\n\n#### Other command line tools I use\n\n- [ffmpeg](https://en.wikipedia.org/wiki/FFmpeg) - edit videos from the command line\n\n```sh\nbrew install ffmpeg\n```\n\n## OS Productivity\n\n### Window Management\n\nI know this feature is built in to a lot of other operating systems, but it is not built in to a Mac, so we need an app for it.\n\nI use [rectangle](https://rectangleapp.com/) to move and resize windows using keyboard shortcuts. I used to use [spectacle](https://www.spectacleapp.com/), but rectangle is more regularly maintained and allows me to use all of the same keyboard shortcuts as spectacle.\n\nI highly recommend installing this and memorizing the keyboard shortcuts. Fluid and seamless window management is key to being productive while coding.\n\n```sh\nbrew install rectangle\n```\n\n## Other Apps I Use Daily\n\n- [1Password](https://www.1password.com/) - The perfect password manager for ecosystem apple\n- [Brave](https://www.brave.com/) - Preferred Web browser\n- Android File Transfer - Transfer files to / from my android phone\n- Android Platform Tools - Installs `adb` without the need for the full android studio\n- [Cleanshot](https://cleanshot.com/) - The ultimate screen recording app made for macOS\n- [Discord](https://discord.com/) - Messaging / Community\n- [Docker Desktop](https://www.docker.com/products/docker-desktop/) - The fastest way to containerize applications\n- [Fig](https://fig.io/) - Boost terminal integration\n- [Figma](https://www.figma.com/) - UI Design Tool\n- [Insomnia](https://insomnia.rest/products/insomnia) - HTTP / REST / GraphQL tester / requester\n- [Raycast](https://www.raycast.com/) - An app that allows you to control just about every aspect of your MacBook\n- [Slack](https://slack.com/) - Messaging / Community\n- [VLC](https://www.videolan.org/) - I use VLC to watch videos instead of the built in QuickTime.\n- [Visual Studio Code](https://code.visualstudio.com/) - Code Editor\n\nYou can install them in one go by placing them all into a text file and then running brew install:\n\n```txt\n1password\nandroid-file-transfer\nandroid-platform-tools\nbrave-browser\ncleanshot\ndiscord\nfig\nfigma\ninsomnia\nraycast\nslack\nvisual-studio-code\nvlc\n```\n\n```sh\nxargs brew install \u003c apps.txt\n```\n\n## OS Settings\n\nThese are my preferred settings for `Finder` and the `Dock`.\n\n### Finder\n\n- Finder -\u003e Preferences\n  - General -\u003e Show these on the desktop -\u003e Select None\n    - I try to keep my desktop completely clean.\n  - General -\u003e New Finder windows show -\u003e Home Folder\n    - I prefer to see my home folder in each new finder window instead of recent documents\n  - Advanced -\u003e Show all filename extensions -\u003e Yes\n  - Advanced -\u003e Show warning before changing an extension -\u003e No\n  - Advanced -\u003e When performing a search -\u003e Search the current folder\n- View\n  - Show Status Bar\n  - Show Path Bar\n  - Show Tab Bar\n\n## Menu Bar Customization\n\n### System Stats Widgets\n\nI like to see my network traffic, CPU temp / usage and RAM usage at a glance.\n\nI used to use [stats](https://github.com/exelban/stats), a FOSS menu bar stats app.\n\nIn each widget, a key setting to look for is under \"widget settings\", choose \"merge widgets into one\".\n\n```sh\nbrew install stats\n```\n\n### Menu Bar Calendar\n\nI like to have a calendar in the menu bar that I can quickly look at. stats does not include one, so I found [cron](https://www.cron.com/). It seems fine for my needs.\n\n```sh\nbrew install cron\n```\n\n## Web Browser\n\n### Brave\n\nI use Brave because it is open source based on Chromium and it focuses heavily on performance and user privacy.\n\nI use the following extensions to help me while developing:\n\n- [ColorZilla](https://chrome.google.com/webstore/detail/colorzilla/bhlhnicpbhignbdhedgjhgdocnmhomnp)\n  - Advanced Eyedropper, Color Picker, Gradient Generator and other colorful goodies.\n- [CSS Peeper](https://chrome.google.com/webstore/detail/css-peeper/mbnbehikldjhnfehhnaidhjhoofhpehk)\n  - CSS Peeper is a CSS viewer tailored for Designers. Get access to the useful styles with our Chrome extension.\n- [Designer Daily Report](https://chrome.google.com/webstore/detail/designer-daily-report/imjkkofdknonmlapjelmafbikikbegbi)\n  - This extension opens a daily Designer Report on a background tab (non-distracting) roughly around 00:00AM PST time as the report is ready.\n- [Image Downloader](https://chrome.google.com/webstore/detail/image-downloader/cnpniohnfphhjihaiiggeabnkjhpaldj)\n  - Browse and download images on the web.\n- [JSON Viewer](https://chrome.google.com/webstore/detail/json-viewer/gbmdgpbipfallnflgajpaliibnhdgobh)\n  - It is a Chrome extension for printing JSON and JSONP.\n- [Octotree](https://chrome.google.com/webstore/detail/octotree-github-code-tree/bkhaagjahfmjljalopjnoealnfndnagc)\n  - Browser extension that enhances GitHub code review and exploration.\n- [Panda 5](https://chrome.google.com/webstore/detail/panda-5-your-favorite-web/haafibkemckmbknhfkiiniobjpgkebko)\n  - Panda is the simple free newsreader. Discover the best tools, resources, and inspiration in the world of design and tech. Find everything in one place.\n- [React Developer Tools](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi)\n  - Adds React debugging tools to the Chrome Developer Tools.\n- [Redux DevTools](https://chrome.google.com/webstore/detail/redux-devtools/lmhkpmbekcpmknklioeibfkpmmfibljd)\n  - The extension provides power-ups for your Redux development workflow. Apart from Redux, it can be used with any other architectures which handle the state.\n- [Responsive Viewer](https://chrome.google.com/webstore/detail/responsive-viewer/inmopeiepgfljkpkidclfgbgbmfcennb)\n  - A Chrome extension to show multiple screens in one view while developing responsive websites/applications.\n\n## Node.js\n\nI use nvm to manage the installed versions of Node.js on my machine. This allows me to easily switch between Node.js versions depending on the project I'm working in.\n\nSee installation instructions [here](https://github.com/nvm-sh/nvm#installing-and-updating).\n\nOR run this command (make sure v0.39.3 is still the latest)\n\n```sh\ncurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash\n```\n\nAfter installation you'll want to add the following to your .bash_profile / .zshrc etc.\n\n```sh\nexport NVM_DIR=\"$([ -z \"${XDG_CONFIG_HOME-}\" ] \u0026\u0026 printf %s \"${HOME}/.nvm\" || printf %s \"${XDG_CONFIG_HOME}/nvm\")\"\n[ -s \"$NVM_DIR/nvm.sh\" ] \u0026\u0026 \\. \"$NVM_DIR/nvm.sh\" # This loads nvm\n```\n\nNow that nvm is installed, you can install a specific version of node.js and use it:\n\n```sh\nnvm install --lts\nnode --version\n```\n\n### Global Modules\n\nThere are a few global node modules I use a lot:\n\n- lite-server\n  - Auto refreshing static file server. Great for working on static apps with no build tools.\n- license\n  - Auto generate open source license files\n- gitignore\n  - Auto generate `.gitignore` files base on the current project type\n- yarn\n  - Is a package manager that doubles down as project manager.\n- pnpm\n  - Is a package manager that doubles down as project manager.\n- @angular/cli\n  - The Angular CLI to create projects, generate application and library code, and perform a variety of ongoing development tasks such as testing, bundling, and deployment.\n\n```sh\nnpm install -g lite-server license gitignore yarn pnpm @angular/cli\n```\n\n## VS Code\n\nVS Code is my preferred code editor.\n\nYou can view all of my VS Code settings / extensions [here](https://github.com/hayato-eth/mac-setup/tree/main/src/vscode).\n\n2 of the most notable settings are:\n\n```json\n{\n  \"editor.linkedEditing\": true,\n  \"editor.snippetSuggestions\": \"top\"\n}\n```\n\n- editor.linkedEditing\n  - Automatically edit a closing tag when editing an opening tag\n- editor.snippetSuggestions\n  - Puts the most relevant auto complete options at the top\n\n## Break Timer\n\nI use an app called [Time Out](https://www.dejal.com/timeout/).\n\nI have it setup to show:\n\n- 10 second micro break every 15 minutes\n- 5 minute long break every 60 minutes\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhayatolab%2Fmac-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhayatolab%2Fmac-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhayatolab%2Fmac-setup/lists"}