ohmyzsh/README-MY-SETUP.md

My Shell Setup

Much if my information comes from here and his YouTube video.

Note that this will backup and replace your existing ~/.zshrc file

You'll need zsh to install Oh My Zsh. Run zsh --version to check if you have it.

macOS

• install HomeBrew (probably already installed)

• install iTerm2

• install prereqs

  • need to install Nerd Fonts (may want other fonts but must be Nerd variety)

    brew tap homebrew/cask-fonts
    brew install --cask font-fantasque-sans-mono
    brew install --cask font-hack-nerd-font
    brew install --cask font-fira-nerd-font
    

  • Configure iTerm2 to use one of the nerd fonts

  • needed for oh-my-zsh module autojump

    brew install autojump
    brew install terminal-notifier
    

  • install ls replacement exa

    brew install exa
    

• continue to Common Install Steps

Linux

• install Tilex

  apt install tilix
  

• install prereqs

  • If which zsh not installed, then install with sudo apt install zsh. Next, change your login shell with chsh -s $(which zsh)

  • need to install Nerd Fonts (may want other fonts but must be Nerd variety)

    • I download FiraCode, exand, open Nautilus and double-click on each non-Windows font

  • configure Tilix to use the Nerd font

  • install autojump

    sudo apt install autojump
    

• continue to Common Install Steps

Windows

• Install Windows Terminal
• Recommend using WSL2 with Ubuntu and zsh installed there, but may be able to use Git Bash
• other steps TBD
• continue to Common Install Steps

Common Install Steps

• install Oh My Zsh customized fork

  • fork fklassen fork of oh-my-zsh to your personal account, or simpler yet use fklassen/ohmyzsh if you don't plan to modify anything

    https://github.com/fklassen/ohmyzsh/fork
    

  • if you forked, optionally modify README.md and tools/install.sh to point to your repo so that you don't need REPO=fklassen/ohmyzsh during installation

  • optionally customize forked repo to match your preferences

  • run installer

    • if you are using fklassen/ohmyzsh ...

      sh -c "$(curl -fsSL <https://raw.githubusercontent.com/fklassen/ohmyzsh/master/tools/install.sh>)"
      

    • if you forked your own repo ...

      REPO=<your_github_id>/ohmyzsh sh -c "$(curl -fsSL <https://raw.githubusercontent.com/fklassen/ohmyzsh/master/tools/install.sh>)"
      

  • optionally configure by editing '~/.zshrc` (see Getting Started)

    • I personally like to make a symbolic link so I can commit my changes to my forked config

      cd
      ln -sf ~/.oh-my-zsh/templates/zshrc.zsh-template .zshrc
      

• install Starship

  • run installer

    curl -sS https://starship.rs/install.sh | sh
    

  • take a copy Starship config file

    mkdir -p ~/.config
    cd ~/.config
    ln -s ~/.oh-my-zsh/templates/starship.toml
    

• Start a terminal session