🏠 Personal dotfiles for *NIX (macOS and Linux) systems.
curl -fsSL https://dotfiles.wook.kr/etc/install | bash
dotfiles.wook.kr
(via curl -L
or wget
), e.g.,
$ git clone --recursive https://github.com/wookayin/dotfiles.git ~/.dotfiles
$ cd ~/.dotfiles && python install.py
The installation script will clone the repository into ~/.dotfiles
and create symbolic links (e.g., ~/.vimrc
) for you.
If target files already exist (e.g. ~/.vim
, ~/.vimrc
), you will need to manually resolve the conflict (delete the old one or just ignore). See Troubleshooting below for details.
$ dotfiles
To update dotfiles (pull changes from upstream and run install.py
again):
$ dotfiles update
$ dotfiles update --fast # fast update mode: skip updating {vim,zsh} plugins
On Linux, you can install some common softwares locally (into $HOME/.local/bin
) without sudo:
$ dotfiles install neovim # -> ~/.local/bin/nvim
$ dotfiles install ripgrep # -> ~/.local/bin/rg
Please read carefully warning messages during installation !!
If something goes wrong, please run $ dotfiles update
(or install.py) to make everything up-to-date.
~/.zshrc
, ~/.vimrc
, ~/.vim
, etc., that are NOT symbolic links,Q: I see some weird icons like ⍰
in (neo)vim or in the statusline.
JetBrainsMono Nerd Font Mono
JetBrainsMono NFM
brew install --cask font-*-nerd-font
.
brew install --cask font-jetbrains-mono-nerd-font
)brew reinstall --cask $(brew list | grep nerd-font)
.If neovim + treesitter emits an error like query: invalid node type
, run :TSUpdate
(and wait for installation is done).
If neovim cannot run due to version 'GLIBC_2.29' not found
errors (on Ubuntu 18.04 or earlier),
you should upgrade your Ubuntu distribution to 20.04+ in order to run nvim 0.8.x or higher.
If you use appimage binary of neovim,
this will work in Ubuntu 18.04; install neovim through dotfiles install neovim
or NEOVIM_VERSION=0.9.4 dotfiles install neovim
.
If neovim emits any startup errors (e.g. no module named neovim
):
dotfiles install neovim
(linux) or brew install neovim
(mac).:checkhealth
.:Lazy update
: some errors from vim plugin could be easily solved by updating plugins to date.:Lazy update
(in vim) or $ dotfiles update
(in zsh).pynvim
pypi package is installed on local python 3,which python3
. Use the following vim command to tell which host python is used::echo g:python3_host_prog
.
python3 -m pip install --user pynvim
might help.Does vim color look weird (e.g. only black-and-white)?
:set notermguicolors
to temporarily disable 24-bit colors.Does tmux look weird? Make sure that tmux version is 2.3 or higher.
$ dotfiles install tmux
to install tmux
into $HOME/.local/bin
, if you do not have sudo.If you are still lost, or you've found a bug, please feel free to contact me or raise an issue --- I will happy to assist.
Copyright (c) 2012-2024 Jongwook Choi (@wookayin)