.dotfiles

My configuration, with installation steps.

Dependencies

Theese dotfiles only work on Unix systems.

You need to have zsh installed!

Installation

Important: You need to have zsh installed!

Install using the install script:

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/LucaAngioloni/.dotfiles/main/install.sh)"

This will install all the dependencies, tools and dotfiles.

Note: the script will ask for your password to install some dependencies.

Note: still experimental!

Sync

Use git to push and pull.

If the changes are on the existing files they should be applied immediately, otherwise if you add new "folders" or files, redo the Stow process.

Use sup (Shell UPdate)

Use the sup command in the terminal to update the dotfiles and update all the dependencies and tools installed above.

Manual installation

Brew

On a Mac, install brew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Git

OSX

brew install git

Debian

sudo apt-get install git

Oh My ZSH

Install with this command:

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

Set ZSH as default shell

ZSH Theme

To select which theme to use change ZSH_THEME in shell/.shellconfig/oh-my-zsh. You can just install the one you need.

My current favourite is: Powelevel10k

Powelevel10k

Clone this repo:

git clone https://github.com/romkatv/powerlevel10k.git $ZSH_CUSTOM/themes/powerlevel10k

Spaceship

Clone this repo:

git clone https://github.com/spaceship-prompt/spaceship-prompt.git "$ZSH_CUSTOM/themes/spaceship-prompt" --depth=1

Symlink spaceship.zsh-theme to your oh-my-zsh custom themes directory:

ln -s "$ZSH_CUSTOM/themes/spaceship-prompt/spaceship.zsh-theme" "$ZSH_CUSTOM/themes/spaceship.zsh-theme"

Starship

Install Starship:

# MacOS
brew install starship

# Debian
curl -sS https://starship.rs/install.sh | sh
# Run this command again to update

ZSH plugins

Install zsh-completions:

git clone https://github.com/zsh-users/zsh-completions ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/zsh-completions

Install zsh-autosuggestions:

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

Install fast-syntax-highlighting:

git clone https://github.com/zdharma-continuum/fast-syntax-highlighting.git \
  ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/fast-syntax-highlighting

Choose a theme with fast-theme {theme-name}.

List all themes with fast-theme -l.

Run fast-theme -t {theme-name} option to obtain a snippet.

I use default but I am not super happy with it.

Tmux

OSX

brew install tmux

Debian

sudo apt-get install tmux

Ruby (mainly for colorls)

OSX

brew install ruby

Debian

sudo snap install ruby --classic

Color LS

Requires ruby.

Install gem:

gem install colorls

LSD

OSX

brew install lsd

Debian

sudo apt-get install lsd

The Fuck

OSX

brew install thefuck

Debian

Requires Python.

pip3 install thefuck --user

fd

OSX

brew install fd

Debian

sudo apt install fd-find

# If fd is not available in PATH (because it is called fdfind)
ln -s $(which fdfind) ~/.local/bin/fd

or refer to the documentation

Tree

OSX

brew install tree

Debian

sudo apt-get install tree

Bat

OSX

brew install bat

Debian

sudo apt-get install bat

# If bat is not available and it is instead batcat
mkdir -p ~/.local/bin
ln -s /usr/bin/batcat ~/.local/bin/bat

or refer to the documentation

FZF

OSX

brew install fzf

# To install useful key bindings and fuzzy completion (run once):
$(brew --prefix)/opt/fzf/install

Uninstall

$(brew --prefix)/opt/fzf/uninstall

brew uninstall fzf

Debian

sudo apt-get install fzf

Add ~/.fzf.zsh with this:

# Auto-completion
# ---------------
source /usr/share/doc/fzf/examples/completion.zsh

# Key bindings
# ------------
source /usr/share/doc/fzf/examples/key-bindings.zsh

Direnv

OSX

brew install direnv

Uninstall

brew uninstall direnv

Debian

sudo apt-get install direnv

Catimg

OSX

brew install catimg

Debian

sudo apt-get install catimg

Ripgrep

OSX

brew install ripgrep

Debian

sudo apt-get install ripgrep

Neovim

OSX

brew install neovim

Debian

sudo snap install nvim --classic

NVChad

git clone https://github.com/NvChad/NvChad ~/.config/nvim --depth 1 && nvim

DUF

OSX

brew install duf

Debian

sudo apt-get install duf

Stow

Install GNU stow.

Debian

sudo apt-get install stow

OSX

brew install stow

Install dotfiles in your system

To install the dotfiles, first backup and remove all the dotfiles already there (otherwise stow will not work), then:

stow -R */

Font

Use a NERD font. I use Fura Code

N.B. The font must be installed in the system and it is needed to show icons and advanced graphics.

iTerm 2

On Mac use iTerm2. Themes and configurations are in the term folder.

In iTerm2 go to Preferences and then General and click on Load preferences from a custom folder or URL and select the com.googlecode.iterm2.plist file.

Speedup

Installing git with brew instead of using the Apple git seems to speed things a little.

Also accepting the terms of the xcodebuild licence seems to help: sudo xcodebuild -license accept.

To make startup faster set in the General tab of Profile in Command:

Command: /usr/local/bin/zsh -i

This should completely skip the login phase.

Old config

To make startup faster set in the General tab of Profile in Command:

Command: login -fq lucaangioloni /usr/local/bin/zsh -il

This serves 2 purposes:

• Start zsh in interactive and login mode with -il.
• Do not show last login information with -q (same effect as .hushlogin but it seems faster because it does not even go to search the logs to find the last login event. (? check this info)).

Optional tools

Brew formulae

Install using brew bundle install while in the root directory of this repo where the Brewfile is.

To create / update the Brewfile

brew bundle dump

Notable Python packages

pip install \
autopep8 \
black \
cookiecutter \
flake8 \
get-files-list \
httpie \
ipython \
jupyterlab \
matplotlib \
numpy \
opencv-python \
pandas \
Pillow \
pip-tools \
pyinstaller \
requests \
rich \
scikit-learn \
scipy \
tqdm \
virtualenv

Notable NPM packages

npm install -g \
share-cli \
trash-cli \
tldr \
firebase-tools \
yarn \
prettier \
eslint \
jsdoc \
browser-sync \
npm-check-updates \
speed-test \
http-server-with-auth