nvim-demo.mov

My neovim config

Neovim LazyVim for editing // Kitty for the terminal.

I often switch between Linux (Debian) and MacOS for programming. This setup works well for both cases.

Compatibility

OS	Neovim	LazyVim	Compatible
Debian 12 (bookworm)	0.11.3	14	✅
Ubuntu 22.04	0.11.3	14	✅
MacOS 15.4.1 (Sequoia)	0.11.3	14	✅

Install

The requirements are documented on LazyVim's home page. But these instructions will walk you through the complete setup.

# Debian install prereqs
sudo apt-get install fd-find
sudo apt-get install ripgrep

git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

# neovim install, prefer tarball over package manager
# so you can easily choose the package you want or upgrade
# in the future
cd /opt
sudo wget https://github.com/neovim/neovim/releases/download/v0.11.3/nvim-linux-x86_64.tar.gz
sudo tar -xzf nvim-linux-x86_64.tar.gz
sudo ln -sf /opt/nvim-linux-x86_64/bin/nvim ~/.local/bin/nvim
nvim --version

# to install on mac
# (system dependencies first)
brew install font-hack-nerd-font
brew install fzf
brew install ripgrep
brew install fd

# Then install neovim
cd /opt
sudo curl -LO https://github.com/neovim/neovim/releases/download/v0.11.3/nvim-macos-arm64.tar.gz
sudo xattr -c ./nvim-macos-arm64.tar.gz
sudo tar xzvf nvim-macos-arm64.tar.gz
sudo ln -sf /opt/nvim-macos-arm64.tar.gz/bin/nvim /usr/local/bin/nvim
nvim --version

nvim config installation

# as easy as:
git clone https://github.com/jackycamp/nvim.git ~/.config/nvim

kitty config installation

Installing kitty is pretty straight-forward. Just follow the instructions.

Then you need to move a couple of things around.

# copy over the kitty config
cp ~/.config/nvim/kitty.conf ~/.config/kitty/

# and don't forget the sick background pic
cp ~/.config/nvim/choso-bg.png ~/choso-bg.png

Now just launch neovim and the config will load automatically!

Commands

:Notifs

Run :Notifs to display all notifications and error messages that might appear when you first launch lazyvim.

:LazyVimVersion

Run :LazyVimVersion to display the loaded LazyVim version.

Troubleshooting

Why is fzf being used when I try to find or grep files?

You may need to manually enable telescope. Do :LazyExtras, find editor.telescope in the list of plugins, type "x" next to it to enable it.

Resources

Neovim release page