{"id":18823042,"url":"https://github.com/himynameisdave/macos-setup","last_synced_at":"2026-01-19T07:30:17.933Z","repository":{"id":139144154,"uuid":"219842027","full_name":"himynameisdave/macos-setup","owner":"himynameisdave","description":"💻 Steps I take for setting up a new McBook","archived":false,"fork":false,"pushed_at":"2020-10-27T17:26:53.000Z","size":19,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-15T04:51:20.409Z","etag":null,"topics":["config","laptop-setup","macos-setup","software"],"latest_commit_sha":null,"homepage":"","language":null,"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/himynameisdave.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-05T20:15:04.000Z","updated_at":"2023-12-18T16:15:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"f4db5ecd-7ae8-4f4b-bfbd-7a167f797d81","html_url":"https://github.com/himynameisdave/macos-setup","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/himynameisdave%2Fmacos-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/himynameisdave%2Fmacos-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/himynameisdave%2Fmacos-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/himynameisdave%2Fmacos-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/himynameisdave","download_url":"https://codeload.github.com/himynameisdave/macos-setup/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239758899,"owners_count":19692041,"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":["config","laptop-setup","macos-setup","software"],"created_at":"2024-11-08T00:52:31.326Z","updated_at":"2026-01-19T07:30:17.886Z","avatar_url":"https://github.com/himynameisdave.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\" margin=\"0 auto 20px\"\u003e\n    \u003ch1\u003emacOS Setup\u003c/h1\u003e\n    \u003cp style=\"font-style: italic;\"\u003e💻 Steps I take for setting up a new McBook\u003c/p\u003e\n\u003c/div\u003e\n\n---\n\nWhen setting up a new MacBook, here is roughly the series of steps / applications I download in order to get the system in an optimal state for me to develop properly.\n\n## Settings\n\n### Trackpad\n\n1. Disable Look up/dictionary click.\n1. Enable tab to click.\n\n### Mission Control\n\n1. Disable \"Automatically rearrange Spaces based on most recent use\"\n\n### Sound\n\n1. Enable \"Play feedback when volume is changed\"\n\n### a11y\n\n1. Under \"Zoom\", enable \"Use scroll gesture with modifier keys to zoom\", setting the key to ^Control.\n1. Under \"Display\", slightly bump the contrast and cursor size (based on displays being used).\n1. Under \"Mouse \u0026 Trackpad\", click \"Trackpad Options\", then enable dragging via three-finger drag.\n\n\n## Applications\n\n1. [~Spectacle~](https://www.spectacleapp.com/) - _Deprecated_\n    - [Rectangle](https://rectangleapp.com/) - Vital app for moving/resizing windows around the screen.\n1. [Spark](https://sparkmailapp.com/) - Sexy email client.\n1. [VS Code](https://code.visualstudio.com/download) - Prefered code editor.\n1. [iTerm2](https://iterm2.com/) - Prefered terminal client.\n1. [Insomnia](https://insomnia.rest/) - Tool for testing APIs (REST \u0026 GraphQL).\n1. [Slack](https://slack.com/downloads/mac) - Slack, for work and fun.\n1. [Pock](https://pock.dev/) - App for customizing the macOS Touch Bar.\n1. [Amphetamine](https://apps.apple.com/us/app/amphetamine/id937984704?mt=12) - Keep your Mac awake, on demand.\n1. [GPG Tools](https://gpgtools.org/) - Manager for GPG keys.\n1. [NordVPN](https://apps.apple.com/us/app/vpn-by-nordvpn-web-security/id1116599239?mt=12) - A nice VPN.\n1. [Signal](https://signal.org/download/) - For chatting with pals.\n1. [Memory Diag](https://apps.apple.com/us/app/memory-diag/id748212890?mt=12) - Helps with memory management.\n1. [Monitor Control](https://github.com/MonitorControl/MonitorControl#-monitorcontrol-) - Control external monitor brightness, contrast or volume via keyboard native keys.\n\n## Homebrew \u0026 Command Line Tools\n\n[Homebrew](https://brew.sh/) is a must-have for any macOS system. Install it using the following command, then let's install some stuff:\n\n```\n/usr/bin/ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n```\n\n1. `brew install ack` - [`ack`](https://beyondgrep.com/) is like `grep`, but much nicer.\n1. `sudo easy_install Pygments` - [`Pygments`](https://github.com/dagwieers/pygments) Better syntax highlighting, for [this command](https://github.com/himynameisdave/dotfiles/blob/2ec0e962f276afd59e3329aab75bc7724e585db5/.aliases#L12).\n1. `brew install tree` - [`tree`](https://osxdaily.com/2016/09/09/view-folder-tree-terminal-mac-os-tree-equivalent/) is a nice tree view for the current directory.\n\n## Node\n\nGotta have [NodeJS](https://nodejs.org/en/)! The best way to install and manage it is using Node Version Manager (`nvm`). Install it like so:\n\n```\ncurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.1/install.sh | bash\n```\n\nYou can then proceed to install Node. Run `nvm ls-remote` to list remote versions of node versions.\n\n_Note: After installing node, all future versions should be installed using [this commamnd](https://github.com/himynameisdave/dotfiles/blob/2ec0e962f276afd59e3329aab75bc7724e585db5/.functions#L45-L51). This will install the new version, **and** all the globally installed packages._\n\n### Deno\n\nNow that [Deno](https://deno.land/) is stable/v1, install it so that we can use it for new projects moving forward.\n\n```\nbrew install deno\n```\n\n## Dotfiles\n\nPlease check out this [dotfiles](https://github.com/himynameisdave/dotfiles) repository for info on the dotfiles. It includes a `.profile`, along with various `.alises` and `.functions` which I usually use. It also includes the [`starship`](https://starship.rs/) configuration I use (see below).\n\n### Starship\n\nInstall [`starship`](https://starship.rs/).\n\n```bash\nbrew install starship\n```\n\nThis is a handy terminal tool with some neat features. It has its own `starship.toml` config file that you can find in [my dotfiles](https://github.com/himynameisdave/dotfiles).\n\n## VSCode\n\n### Extensions\n\n1. [Atom Keymap](https://github.com/Microsoft/vscode-atom-keybindings) - Inherit a lot of Atom's keymappings.\n1. [Atom One Dark Theme](https://github.com/akamud/vscode-theme-onedark) - Nice theme.\n1. [Material Icon Theme](https://github.com/PKief/vscode-material-icon-theme) - Better icons, with support for oodles of extensions.\n1. [GitLens](https://github.com/eamodio/vscode-gitlens) - Adds lots of built-in git goodies, such as viewing who last edited a line.\n1. [Bracket Pair Colorizer](https://github.com/CoenraadS/BracketPair) - Makes matching brackets have the same color, making code blocks easier to see.\n1. [ESLint](https://github.com/Microsoft/vscode-eslint) - ESLint in VSCode.\n1. [npm Intellisense](https://github.com/ChristianKohler/NpmIntellisense) - Autocompletes npm modules in import statements.\n1. [Svelte](https://github.com/UnwrittenFun/svelte-vscode) - Adds Svelte language support.\n1. [Svelte Intellisense](https://github.com/ArdenIvanov/svelte-intellisense) - Adds Svelte intellisense support.\n1. [ES7 React/Redux Snippets](https://github.com/dsznajder/vscode-es7-javascript-react-snippets) - _Some_ good snippets for React \u0026 Redux. Currently looking for a better replacement.\n1. [Go](https://github.com/Microsoft/vscode-go) - Adds language support for the [Go language](https://golang.org/) to VS Code.\n1. [Chrome Debugger](https://github.com/Microsoft/vscode-chrome-debug) - Debug code running in Google Chrome from VS Code.\n1. [Rainbow CSV](https://github.com/mechatroner/vscode_rainbow_csv) - Make CSVs pretty again!\n1. [Sort JS Object Keys](https://github.com/SBeator/sort-js-object-keys) - Alphabetize JS object keys.\n1. [Markdown Lint](https://github.com/DavidAnson/vscode-markdownlint) - Lint markdown files for common pitfalls.\n1. [Indent 4-to-2](https://github.com/compulim/vscode-indent-4to2) - Simplify converting indentation of tab or 4 spaces into 2 spaces.\n\n### Key Mappings\n\nThere are a few key mappings which I prefer to set when setting up VS Code. Hit `SHIFT` + `CMD` + `P` to pull up the commands pallet, then select **Preferences: Open Keyboard Shortcuts**.\n\n- **Move Line Down** - `^` + `⌥` + `↓`\n- **Move Line Up** - `^` + `⌥` + `↑`\n\n### Font\n\nUse the [Cascadia font](https://github.com/Microsoft/Cascadia-Code) from Microsoft. Download [this `.ttf` file](https://github.com/microsoft/cascadia-code/releases/download/v1911.21/CascadiaMonoPL.ttf), install the font on your Mac by opening the file, and then in VSCode open up the settings UI and add the following as the `font-family`:\n\n```\n'Cascadia Mono PL', Menlo, Monaco, 'Courier New', monospace\n```\n\n## iTerm\n\n### Colours\n\nUse the [provided colour pallet](https://github.com/himynameisdave/macos-setup/blob/master/himynameisdave.itermcolors). You can add them under **Preferences \u003e Profiles \u003e Colors \u003e Color Presets \u003e Import**.\n\n### Keys\n\nUnder **Preferences \u003e Profiles \u003e Keys**, alter the following two key combos:\n\n- `⌥` + ⬅️ - Send Escape Sequence `b`\n- `⌥` + ➡ - Send Escape Sequence `f`\n\n### Fonts\n\nIn order to use [`starship`](https://starship.rs/), you'll need a [Nerd Font](https://www.nerdfonts.com/) that supports the glyphs to be used in the terminal. I prefer the [`Cascadia` variant](https://github.com/ryanoasis/nerd-fonts/releases/download/v2.1.0/CascadiaCode.zip). You can add it to iTerm via **Profiles \u003e Text**.\n\n---\n\n\u003e _✌️ Made by [Dave](http://himynameisdave.com)._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhimynameisdave%2Fmacos-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhimynameisdave%2Fmacos-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhimynameisdave%2Fmacos-setup/lists"}