Kitty + Neovim + tmux Ultimate Setup

Notes

These instructions were written primarily for Mac but can be translated for Linux and Windows.
The theme and font used throughout this setup are gruvbox dark ² and FiraCode Nerd Font ⁵.

Preparation

Run git clone https://github.com/Jrachman/kitty-neovim-tmux-ultimate-setup.git.

Kitty

Run curl -L https://sw.kovidgoyal.net/kitty/installer.sh | sh /dev/stdin. ¹
Open Kitty and click on kitty --> Preferences. This should open up a Vim window with Kitty's settings.
Copy and paste the following to the top of the settings file:

mouse_hide_wait 0
kitty_mod cmd+shift
map kitty_mod+equal     change_font_size all +2.0
map kitty_mod+minus     change_font_size all -2.0
map kitty_mod+backspace change_font_size all 0
font_family      FiraCode Nerd Font Mono
bold_font        auto
italic_font      auto
bold_italic_font auto
font_size 12.0
macos_titlebar_color background
map alt+left send_text all \x1b\x62
map alt+right send_text all \x1b\x66\

include ./theme.conf
map cmd+d new_window
# map kitty_mod+n new_os_window

If you do not want to add a theme, please comment out the include ./theme.conf in your Kitty Preference file. If you do want a theme, run the following in Kitty to add gruvbox dark: ²

git clone --depth 1 https://github.com/dexpota/kitty-themes.git ~/.config/kitty/kitty-themes

cd ~/.config/kitty

ln -s ./kitty-themes/themes/gruvbox_dark.conf ~/.config/kitty/theme.conf

Now, quit Kitty with CMD-q and reopen to see all of the changes in place.

Neovim

Run the following:

brew install neovim ³

sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim' ⁴

mkdir ~/.config/nvim

cp <path_to_kitty-neovim-tmux-ultimate-setup_folder>/init.vim ~/.config/nvim/init.vim ⁵

brew tap homebrew/cask-fonts && brew install --cask font-fira-code-nerd-font

brew install fzf ⁶

set rtp+=/usr/local/opt/fzf

brew install ripgrep ⁷

Run nvim (you don't call neovim, you have to call nvim instead), type :PlugInstall, and then click Enter. If there are any errors, there should be instructions that pop up to help you resolve them.
Exit out of Neovim by executing :q until you are back in the terminal and then run nvim again to see the customizations.

tmux

Run the following: ⁸

brew install tmux

echo 'export PATH="/usr/local/opt/ncurses/bin:PATH"' >> ~/.zshrc

cp <path_to_kitty-neovim-tmux-ultimate-setup_folder>/.tmux.conf ~/.tmux.conf

tmux

nvim

In Neovim, execute :Tmuxline and then :TmuxlineSnapshot ~/tmuxline. ⁹
Exit out of Neovim with :q
Replace the commented-out line of your ~/.tmux.conf file with

# Toggle mouse on
bind-key M \
    set-option -g mouse on \;\
    display-message 'Mouse: ON'
# Toggle mouse off
bind-key m \
    set-option -g mouse off \;\
    display-message 'Mouse: OFF'

Save and then run tmux source-file ~/.tmux.conf.
Kill your tmux session by hitting (CTRL-a)-x-y.
Now, run tmux again and your setup should be complete.

BONUS: Spotify in Neovim!

https://github.com/srishanbhattarai/neovim-spotify ;)

References

¹ https://sw.kovidgoyal.net/kitty/binary.html#customizing-the-installation

² https://github.com/dexpota/kitty-themes/tree/master/themes

³ https://github.com/neovim/neovim/wiki/Installing-Neovim

⁴ https://github.com/junegunn/vim-plug

⁵ https://www.nerdfonts.com/font-downloads

⁶ https://github.com/junegunn/fzf

⁷ https://github.com/BurntSushi/ripgrep

⁸ https://medium.com/@jeongwhanchoi/install-tmux-on-osx-and-basics-commands-for-beginners-be22520fd95e

⁹ https://github.com/edkolev/tmuxline.vim#usage

Special Thanks!

Thank you to Agnes Jang for teaching me about how to set all of this up, informing me about the various possible customizations, and walking me through the depths of mastering Vim.

Jrachman / bm