Awesome Open Source
Awesome Open Source

Custom *nix config files, for mac and ubuntu

 tmux   > keymaps, vi mode, status bar
 fzf    > command line fuzzy finder
 vim    > useful plugins
 git    > global git config and aliases

mac 和 ubuntu 都能用的配置

  • shell
  • tmux
  • vim
  • git
  • ruby

how to manage your dotfiles 中文




store configuration files in ~/.dotfiles folder and symlink them to ~

$ cd ~
$ tree -a -L 2

├── .dotfiles
│   ├── .git
│   ├── .gitignore
│   ├── .gitmodules
│   ├──
│   ├── git/
│   ├── vim/
│   ├── tmux/
│   ├── shell/
│   ├── ...
├── .tmux/ -> .dotfiles/tmux/.tmux/
├── .tmux.conf -> .dotfiles/tmux/.tmux.conf
├── .zshrc -> .dotfiles/shell/.zshrc


i manage symlinks with gnu stow

stow is available for all linux and most other unix like distributions via your package manager.

  • for ubuntu sudo apt-get install stow
  • for mac brew install stow
# navigate to your home directory
cd ~
# clone the repo:
git clone .dotfiles
# enter the `.dotfiles` directory
cd .dotfiles
git submodule init --recursive
# install the zsh settings
stow shell
stow vim
stow tmux
# etc, etc, etc...
# (`stow --help` get more usage)

how it works

by default the stow command will create symlinks for files in the parent directory of where you execute the command. so my dotfiles setup assumes this repo is located in the root of your home directory ~/.dotfiles. and all stow commands should be executed in that directory. otherwise you'll need to use the -d flag with the repo directory location.

to install most of my configs you execute the stow command with the folder name as the only argument.

to install my shell configs use the command:

~/.dotfiles$ stow shell

this will symlink files to ~ and various other places.

note: stow can only create a symlink if a config file does not already exist. if a default file was created upon program installation you must delete it first before you can install a new one with stow. this does not apply to directories, only files.


Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (169,536
Vim (18,654
Bash (18,605
Vim Script (11,482
Dotfiles (10,714
Zsh (7,211
Tmux (3,870
Vimrc (2,251
Fzf (962
Gitconfig (181
Tmux Configs (89
Stow (87