My Mac Setup

Maybe I should start a series called “Not just a Gist”, as I’m slowly converting gists of mine to blog posts. The last one I converted was all about My Visual Studio Code Setup.

I participated in this week’s #devdiscuss about tooling, and I posted a few links to gists that are my setup on my Mac.

Tools you absolutely need on your Mac

• The Homebrew duo. These are a must have to simplify installing most things on your Mac. As soon as these are installed, you may proceed.
  • Homebrew - run /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" from the command line to install it.
  • Homebrew Cask - run brew tap caskroom/cask from the command line to install it.
• Spectacle, the best application I’ve found for managing windows on macOS. This is especially useful for anyone coming from Windows who are used to this out of the box functionality. Run brew cask install spectacle from the command line to install it.
• Alfred (buy the Alfred Powerpack to get the full use of Alfred). Run brew cask install alfred from the command line to install it.

Alfred Setup

Alfred is so awesome, it deserves it’s own section in this post. It’s basically Spotlight on steroids and a bag of chips. It’s more than an application launcher. It allows you to create workflows for repetitive tasks you do everyday and there is also a huge array of existing workflows for it available. I even decided to make some of my own, nickytonline/alfred-workflows: Hopefully useful workflows for Alfred.

I never used Alfred until this past summer. Why did I not use it sooner?!

(╯°□°）╯︵ ┻━┻

The Syntax FM podcast has a great episode on tooling, including Alfred, Our favourite Productivity Hacks 🔥 — Syntax Podcast 011. You should check it out.

Along with workflows, you can also install themes. I like Wes Bos’ Cobalt 2 theme for other things and I guess since Wes is a huge fan of Alfred, he decided to make the theme for Alfred as well. Download the raw Cobalt 2 theme file from the github.com/wesbos/Cobalt2-Alfred-Theme repository. Once downloaded, open the file and it will ask you if you want to import the theme into Alfred.

Click the import button and Alfred has been Cobalted.

At the time of this writing, here’s all the workflows that I currently have installed:

• yannickglt/alfred-devdocs: Alfred workflow for devdocs.io. Grab it from Packal. Search DevDocs straight from the Alfred search bar.
• carlosgaldino/alfred-emoji-workflow: Alfred 2 workflow for searching emoji codes.. Grab it here. I use this to get emojis super ⚡ fast ⚡. I just used it to put those two lightning bolts in this post!
• willfarrell/alfred-encode-decode-workflow: Encoding and decoding a sting into multiple variations.. Grab it here. A super quick way to encode/decode text.
• ruedap/alfred-font-awesome-workflow. Grab it here.
• gharlan/alfred-github-workflow: GitHub Workflow for Alfred 3. Grab it here.
• ngreenstein/alfred-process-killer. Grab it here.
• RunCommand. I only really use this to start Visual Studio Code from the command line.
• StackOverflow Search. Search stackoverflow.com right from Alfred. The only tweak I did to this workflow was change the keyword to launch it. I switched .so to sos. Otherwise it launches the RunCommand workflow and errors out because of the initial . running an invalid command. I also find it funny that I called it sos. Send help! 🆘
• TimeZones. Grab it here. A super quick way to get the time in a country or city.
• UUIDgen.
• Packal Updater. It updates any workflows you have that you grabbed via Packal, a popular workflow and themes directory for Alfred.
• These are some workflows I opened sourced that I find handy, nickytonline/alfred-workflows: Hopefully useful workflows for Alfred.
• I have a few others I made, but they’re just simple workflows for opening stuff like my Google Music. It uses an Alfred workflow template to just open a URL. Try making one yourself! I promise it’s not hard.
• Update 2018/01/27: Found the MDN Search workflow. Super handy!

If you use Alfred and have some workflows that are not listed here, please mention them in the comments. I’m always looking for new ones to improve my whole dev workflow.

You can also launch the terminal from Alfred, by typing > in the Alfred search bar followed by the command you wish to run. Since I use iTerm, I want that to open instead of the default Terminal app. Since Alfred 2.7.2, you can run a custom Applescript to launch another terminal application. Open the Alfred preferences window and click on the Features button in the top of the preferences window then click on the Terminal / Shell button at the bottom. In the Application drop down menu, select Custom and paste in this script from the Custom iTerm Applescripts for Alfred repository.

You're all good to go. To test it out launch Alfred and in the search bar type > ls and press ENTER. iTerm should open up with a listing of the current directory.

Tools for Web Development

• VS Code, here’s my setup. Run brew cask install visual-studio-code from the command line to install it.
• n, for installing different versions of node. I’m sure someone is going to suggest using nvm. The problem was though, when I switched from zsh (another great choice for a shell), I was unable to get nvm working with fish, so I just switched to n which works super well. Run brew install n from the command line to install it.
• now.sh, great for hosting but also great for knocking out some POCs and deploying it. Run brew cask install now from the command line to install it.
• Docker, containerize all the things! Run brew cask install docker from the command line to install it.
• Fira Code font for my shell and my favourite editor. Run the following only once as it's used for installing any font, brew tap caskroom/fonts. Once that is installed, you can install Fira Code by running brew cask install font-fira-code.
• I’ve discovered what the whole commotion is about npx, so I’ve also added that to my tool belt. Thanks Peter Kühne!

Shell/Terminal Setup

• iTerm2, a better terminal than the out of the box macOS terminal app. Run brew cask install iterm2 from the command line to install it.
• Fish shell, a better shell experience. Run brew cask install fish from the command line to install it.
• Fisherman, for themes and other utilities for the fish shell. Run curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs https://git.io/fisher from the command line to install it.
• edc/bass (to support bash utilities) - Assumes Fisherman is installed. Run fisher edc/bass from the command line to install it.
• I use the git CLI with git aliases. Here’s my list of git aliases.
• fish shell aliases I use because I'm a lazy typer or just can't remember the real command. Feel free to run the script snippet below to add them to your 🐡 🐚 .**

alias cg="eval \"git clone git@github.com:$argv.git\"" # Clones a gist, just pass in the gist ID
funcsave cg

alias flushdns="sudo killall -HUP mDNSResponder" # Because I never remember this command
funcsave flushdns

alias g="git"
funcsave g

alias glog="git log --oneline --decorate --all --graph"
funcsave glog

# Check out a PR
alias copr="git fetch origin pull/$argv/head:pr$argv;"
funcsave copr

alias y="yarn"  # Some say I live dangerously aliasing this to 'y'. I say yolo.
funcsave y

alias nib="node --inspect-brk" # nib path-to-my-file/my-file.js
funcsave nib

# When you want to just hash out an idea for something web
# Automatic page reloading and assets. Requires npx so
# ensure your npm is upgraded to the latest and greatest.
alias hot="npx browser-sync start --server src/ --files \"src/*.html\" \"src/css/*.css\" \"src/js/*.js\""
funcsave hot

Useful Utilities

• The Unarchiver - run brew cask install the-unarchiver from the command line to install it.
• Amphetamine, sometimes you just want your laptop to stay awake… 💊
• VLC - run brew cask install vlc from the command line to install it.
• f.lux, so you can be nice to your 👀 in the evening. Run brew cask install flux from the command line to install it.
• Dropbox, I use it to sync my Alfred settings, fish, fisherman etc. via symlinks.Run brew cask install dropbox from the command line to install it.
• dark-mode - run brew install dark-mode from the command line to install it.
• vanilla for OS X menu bar. Hide the clutter. Run brew cask install vanilla from the command line to install it.
• Slack
• Trello, I’m using this less and less though since I discovered Bear. I’ve fallen more in a todo list mode with Bear.
• Bear, this is definitely my favourite new app. It’s the first note taking app that I’m consistently using. I think it’s all due to markdown support and simplicity.
• LiceCap, for animated GIF screen captures. I find this tool very easy to use and the animated screen captures are pretty decent. Run brew cask install licecap from the command line to install it.
• Onyx. It's great for general maintenance of your computer. To install it run brew cask install onyx.

Tweaking macOS

• Prevent Mission control from rearranging Spaces. This drives me nuts, so I remove the setting. I arrange my spaces because I want them to stay like that.
• If you’re on a Mac with a Touchbar, map the function keys to always be used when in browsers, your editors or any other tools you use for dev.

That’s pretty much the round up of what I have on my machine at the moment. I should probably get around to writing a script that installs all this, but for the time being, other priorities.

I’m always looking for new tools to make me more efficient, so feel free to chime in in the comments below.

And here's the link to my mac setup script which I made a little while's after this blog post. It's not perfect, but it's helped me set up a few machines pretty easily.