iTerm 2 + Fish Shell + Fisher + Themes\Plugins

NOTE: This guide is based on tooling that is partly not available for Apple Silicon. I'm waiting for required changes from third-parties and then can check and update the guild along with the script itself. For now, it works only on Intel based Mac.

This guide is targeted for those, who wants to have a nice UI in the terminal with the rich features.

Please, raise your issue if something strange happened. I'd like to improve this script, so it could work without any errors during the installation.

The Problem

Every time, I've re-installed my operating system, I spend around ~30 minutes to set up my terminal environment again. I bored of it, so I decided to make a list of all actions I doing, when setting it up, alongside with automatic script to do so, and share it with you all.

Screenshots & GIFs

They are available here.

Key Features

The script installs things related to terminal environment only:

• Installs Command Line Tools, Homebrew, iTerm2, Fish, Fisher.
• Installs Material Design color preset for iTerm2 and patched Meslo Nerd Font.
• Theme

  bobthefish

  , which is based on popular

  agnoster

  .
• Completions for

  brew

  ,

  git

  ,

  ./node_modules/.bin

  and others...

Installs a lot of useful plugins for Fish Shell:

• bass

  plugin that makes easy to use scripts written for Bash Shell in Fish Shell.
• Plugin

  done

  that notifies you when the process is finished. i.e. you can run

  npm install

  command and switch back into your browser. When

  npm install

  is done, you will get OSX notification.

• fzy

  plugin adds a hotkey Ctrl+R that allows to show and search in your command history.

• pj

  function allows to easily jump between your favorite directories. It installs with configured

  ~/Library/Projects

  folder, so you can jump to any of your projects by calling

  pj 

  .

• upto

  function gets you to a parent folder. I.e. you're inside

  a/b/c/d/e/

  , calling

  upto b

  will navigate you into

  a/b

  .
• ...and others, you can find the full list below in manual guide.

How To Setup

You can achieve the same setup as mine, by manually setting up the environment (following the guide below) or automatically by executing the installer

install.sh

Automatic Installation

Highly recommended to run the script below under Bash session in default Terminal.app. I can not guarantee proper installation outside of Terminal.app + Bash Shell.

bash 
Manual Installation

Command Line Tools

You don't need to install the whole Xcode for it.
By executing the command below, you will get only the command line tools without heavy IDE and dependencies it take:
xcode-select --install

Homebrew

Homebrew is a software manager for MacOS.
Its purpose is like the purpose of 
apt-get
 on Debian-based systems or 
yum
 on Fedora.
You can install command line tools from there or even full-featured applications.

Install Homebrew

iTerm2

Install iTerm 2

• Download and install iTerm2 (it has better color fidelity than the built in Terminal).

or install it via Homebrew:

brew cask install iterm2

Install Color Scheme

Get the iTerm color settings:

• Material Design Theme
• More themes @ iterm2colorschemes

Just save it somewhere and open the file(s). The color settings will be imported into iTerm2. Apply them in iTerm through iTerm -> Preferences -> Profiles -> Colors -> Load Presets. You can create a different profile, other than Default if you wish to do so.

Install Patched Font

• Meslo LG M DZ Regular Nerd Font Complete Mono
• Others @ powerline fonts

Open the downloaded font and press "Install Font".

Set this font in iTerm2 (iTerm -> Preferences -> Profiles -> Text).

• Regular Font -> "Change Font"
• Non-ASCII Font -> "Change Font"

Restart iTerm2 for all changes to take effect.

Fish Shell

Install Fish Shell

Download and install Fish Shell.

or using Homebrew:

brew install fish
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish

Install Fisher

Fisher is a plugin manager for Fish Shell.

curl https://git.io/fisher --create-dirs -sLo ~/.config/fish/functions/fisher.fish

Install Themes and Plugins

• Anicode
• Bass
• Bob The Fish
• Brew Completions
• Colored Man Pages
• done
• errno-grep
• fzy
• GRC
• kill-on-port
• Node BinPath
• NVM (Node Version Manager)
• PJ
• rustup
• upto

License

MIT