Mac OS X Setup

Script to automate the setup of my Mac’s

• Quick Start
• Manual Setup
• Development & Maintenance

Quick Start

1. Login to the Apple Store with your Apple ID

2. (Optional) Export the environment variable SETUP_PROFILE with the name of the profile to apply (they are located in Profiles/Profiles.*). You may also export the environment variable SETUP_BREWFILES with a list of brewfiles to install extra to those defined in the profile (the name of the brewfiles is the text after the file named Brefiles/Brewfile.*)

   export SETUP_BREWFILES="Internet Office"
   export SETUP_PROFILE="Work" # Or "Personal"
   

3. Execute:

   curl -fsSL https://www.johandry.com/mac/setup.sh | bash
   

4. Install manually the applications that failed to install or follow the instructions that an installed program require.

5. Complete the setup following the instructions from the Manual Setup section

It may be required to execute again the setup script, update the Mac with Apple Store or maybe restart it. Pay attention to the output of the script, there may be manual actions required.

To update all the brew installed applications, execute:

brew update
brew upgrade

All the applications were installed with Brew Bundle. To restore the system to the initial applications execute the following command, then you can execute again the curl-setup-bash line:

brew bundle cleanup --global

Manual Setup

Basic Setup

1. Go to System Preferences, then Trackpad to modify the Trackpad settings.
2. Open Finder, go to Preferences (⌘ + ,), then General tab. Select your home directory in New Finder windows show.
3. Still on Finder Preferences, go to Sidebar tab, select/deselect the items as desired
4. Open Finder and in the sidebar, order the items and add Workspace and Sandbox directories, also the Cloud Storages directories.
5. In the menu bar, right click on the battery and select Show Percentage.

Docker

Yes, Docker is installed but it may fail, as it’s an critical application double check and install it manually, so:

1. Download it from here (It may be required to login first with the DockerHub user)
2. Install it or follow the instructions

Virtual Box

The Virtual Box installation may fail due to a security requirement from MacOS. If it fail the instructions will be provided during the brew install.

Double check it’s correctly installed, if failed or still failing download and install it from here.

AWS CLI

Configure your access to AWS through the CLI. Find the AWS access keys, it should be a CSV document. Open Terminal and execute the following command to enter the AWS Access Key ID and AWS Secret Access Key:

aws configure

The region could be us-west-2 and the output format json. Verify the access with the command:

aws ec2 describe-key-pairs

Microsoft Office 365 Home

1. Go to office service
2. Click on Install Office to download the installer

Google Chrome

Open Google Chrome and login with your user.

In the past the brew install of Chrome caused some problems every time there is a Chrome update. If it happens again, uninstall the brew cask for Chrome, download it from here and install it.

brew cask uninstall google-chrome

Terminal

1. Open Terminal, go to Preferences (⌘ + ,), select General tab.
2. Select Pro in New window with profile
3. Go to Profiles tab, select Pro as the default one.
4. In the Pro profile, go to the Window tab, set 160 in Columns, and 48 in Rows.

iTerm

1. Open iTerm, go to Preferences (⌘ + ,)
   • General > Closing: Uncheck all the options
   • Appearance > General: Set Theme to Minimal
   • Profiles
     • General: Check Advance Configuration, then Edit to select:
       • for New Windows: Set Directory to ~/Workspace
       • for New Tabs: Check Home directory
       • for New Split Panes: Check Reuse previous...
     • Colors: Change background color to 10% Gray
     • Window: Set Columns to 125 and Rows to 35
     • Terminal: Check Unlimited scrollback and Silence bell
     • Session: Check Status bar enabled, click on Configure Status Bar then drag: CPU Utilization, Memory Utilization, Network, Current Dir, git state, Composer and click on Auto-Rainbow
2. Split the terminal with Cmd + Shift + D, then Cmd + Shift + S, name the arrangement 2 Panels
3. Go to the top panel and split it with Cmd + D, then Cmd + Shift + S, name the arrangement 3 Panels
4. Go to Preferences (⌘ + ,) (again)
   • General > Startup: Select Open Default Window Arrangement
   • Arrangements: Select the 3 Panels and Set Default
   • Appearance: Set Theme to Dark and Status bar location to Bottom
5. To enable word jumps and word deletion, go to Preferences (⌘ + ,) > Profiles > Keys > Load Presents…, select Natural Text Editing
6. Go to iTerm2 Themes download the themes you like to ~/Downloads, some suggestions are:
   • Brogrammer :+1:
   • Hacktober
   • Harper
   • Highway
   • Hurtado :ok_hand:
   • Japanesque
   • JetBrains Darcula
   • Kibble
   • Material
   • MaterialDark
   • MaterialOcean :+1:
   • Nocturnal Winter :fire:
7. Go to Preferences (⌘ + ,) > Profiles > Colors > Color Presets… > Import:
   • Go to the ~/Downloads directory and select all the downloaded themes
   • Go back to Color Presets… and select the theme you like the most

Tips:

• You switch between panels with Cmd + Option + <Arrow Key>, Cmd + [ or Cmd + ].
• Maximaze the active panel with Cmd + Shift + Enter
• You can close the 3rd panel with Cmd + W
• Execute this line after download all the themes: mkdir themes; mv *.itermcolors* themes; cd themes; for f in *; do mv $f ${f%*.txt}; done

Visual Studio Code

The Go extension require a bunch of tools installed, to install them, create a new file with a simple Go code:

package main

import "fmt"

func main() {
  fmt.Println("hello")
}

Save it and an alert at the bottom will ask to install all the dependencies required by the VSCode Go package. Select All and wait until all are installed.

The default Python interpreter is Python 2, to select Python 3 open the Command Palette (⇧⌘P) and -partially - type Python: Select Interpreter, then select the correct Python 3 interpreter.

If you don’t see it in the list try to reinstall Python 3 and/or restart Visual Studio Code:

brew reinstall python3
brew link python3
python3 -V
where python3

Slack

Login to the following workspaces:

• gophers.slack.com
• kubernetes.slack.com

Manual Download and Install

• NETGEAR Genie: Download it from here
• Printer drivers and utilities: Download them from here

Manual and Specific Setups

Open all the installed applications and make sure they are working, most of them require to accept something or require an user input. These are some of these applications:

• XCode
• Server
• 1Password
• Google Chrome
• Firefox
• Skype
• WhatsApp
• Slack
• Spotify
• Github Desktop
• Microsoft Office Apps (Word, Excel, PowerPoint, OneNote, Outlook)

Development and Maintenance

To modify the list of applications to install or modify the script, first clone or pull the project.

The setup.sh script install automatically a list of applications using Homebrew and mas-cli. It will also execute other tasks such as create a Workspace directory, customize the Zsh theme and more.

There is a file per Mac named with the hostname, i.e. Brewfile.Johandrys-MacBook-Pro.local, and the file Brewfile.Base with all the applications every mac should have. These Brewfiles are required by Brew Bundle and they list all the applications to install. Comments starting with # are allow.

You can create a list of installed applications with the following command:

brew bundle dump --describe

Then move the applications in Brewfile to the right Brewfile.*.

The setup.sh script will create a Brewfile that will be saved to ~/.Brewfile so you can upgrade all the applications at any time with:

brew bundle install --verbose --global

Or remove the none required programs with:

brew bundle cleanup --global

Visual Studio Code Extensions

To list the existing Visual Studio Code extensions execute the command:

code --list-extensions

Then update the file Brewfile.VSCode.

To remove an extension, use the command:

code --uninstall-extension <extension_name>

Atom Packages

To list the installed Atom packages, use the command:

apm list --bare --packages --installed --enabled

Then update the file Atom_Packages.lst but do not include the version number (including the @ character) unless an specific version is required.

To remove the no needed packages, use the command:

apm uninstall <package_name>

Testing

To test locally (not always recommended), execute:

LOCAL_SETUP=1 ./setup.sh

The environment variable LOCAL_SETUP=1 use the files locally instead of getting them from GitHub.

If no parameter is pass the script will use the Profile.Test profile instead the one with the hostname. Or, you may pass a list of brewfiles extensions (the name after Brewfile.) to use them.

Notice that Brewfile.Base will always be used.

It’s possible to test the script using Vagrant. Follow these steps to use OSX Setup with Vagrant:

vagrant up
vagrant ssh
$ cd OS_Setup
$ LOCAL_SETUP=1 ./setup.sh Test

As mentioned above, you need to login to Apple Store with your Apple ID. Follow these steps at the Vagrant box:

1. Open VirtualBox to show the machine screen.
2. Login with user vagrant password vagrant
3. Open Apple Store and login with your Apple ID
4. Follow the authentication process, then you can close the screen.

To start over from scratch, execute vagrant destroy and start over by running vagrant up.