Awesome Open Source
Awesome Open Source
 _     _           _
| |   | |         | |
| |___| |_____  __| | ____     Yet Another Dotfile Repo
|_____  (____ |/ _  |/ ___)
 _____| / ___ ( (_| | |        @lfilho's Version

                                                    Build Status PRs Welcome macos supported linux supported

sh -c "`curl -fsSL`"

Table of Contents:


One liner for OSX

To get started please run:

sh -c "`curl -fsSL`"

Note: YADR will automatically install all of its subcomponents. If you want to be asked about each one, use:

sh -c "`curl -fsSL`" -s ask

Instructions for Linux

Please do help us improving Linux support in this repo ;-)

  1. Make sure you have zsh installed on your machine (default location is /bin/zsh). Type zsh --version to see if you have it. If not, install it running the command sudo apt-get install zsh
  2. Make sure you have vim installed. If not, install it with sudo apt-get install vim
  3. Run the one liner installation script (see OSX section above)
  4. If asked, provide your superuser password
  5. Configure your terminal program to point the command to zsh (default /bin/zsh)
  6. Restart you Terminal
  7. You're done.

TIP: You can check the Dockerfile to see what's need for a basic installation.

Wait, you're not done!

Remap caps-lock to esc!

The esc key is the single most used key in vim. Old keyboards used to have Esc where Tab is today. Apple keyboards are the worst with their tiny Esc keys. But all this is fixed by remapping Caps to Esc. If you're hitting a small target in the corner, you are slowing yourself down considerably, and probably damaging your hands with repetitive strain injuries.

For OSX: with Karabiner Elements (you can install it via brew)

For Ubuntu: dconf write /org/gnome/desktop/input-sources/xkb-options "['caps:swapescape']"

TODO / IDEA: Automate this step (saving Karabiner-Elements' .json and loading it after installing the app)


Upgrading is easy.

cd ~/.yadr
git pull --rebase
rake update

What is YADR?

YADR is an opinionated dotfile repo that will make your heart sing

  • The best bits of all the top dotfile repos, vim and zsh plugins curated in one place, into a simple and cohesive way of working.
  • Several vim plugins, all under one roof, working together, each plugin researched and configured to be at its best, often with better shortcut keys.
  • Many zsh plugins, starting with the wonderful Prezto base, and adding a few niceties on top.
  • All things are vimized: command line, irb, postgres command line, tmux, etc.

What is (this fork's version of) YADR?

This is @lfilho's fork of the great work done by Yan (@skwp), Yadr.

I've been using Yadr since 2013 but since a couple of years ago my preferences and configurations started to diverge too much from upstream. So now my repo is barely mergeable with the original one. Although I'm still a contributor there, my main focus should on my fork (unless we converge again in the future of course :-)).

Here are the differences in a nutshell (also make sure you read the What's included, how to learn, how to customize? section):

  • NeoVim in Terminal rather than GUI MacVim
  • Generally faster vim experience (mostly because of RipGrep and NeoVim's async stuff, but we also use less plugins)
  • Keymaps that don't rely on MacOS's Cmd key, so keymaps would stay cohesive in both TUI vim, GUI vim and Linux environments.
  • Testing. We have basic CI testing. See more about it in the Testing section.
  • Different set of VIM plugins. That's too big of a list to keep up to date here in README so if you're interested you're better off comparing the two repo's plugins. What I can say is:
    • We focus less on Ruby, since it's not my most used language
    • We focus a little more on Javascript/Node
    • We focus on plugins that work better with NeoVim's better features and architecture
  • Couple of new aliases for command line and also git
  • Different file and folder organization and conventions for vim plugins and configurations (all contained to installation folder)
  • Automated iTerm2 configuration (including themes and colors)
  • Brew packages. I have added a Brewfile which makes easier to mantain and more flexible for the community to customize (you can point brew to different Brewfiles whenever you need; also easier to customize in your own fork)
  • Docker. Means you can test this repo in a Docker container without messing with your host environment until you're sure. More on that in the Docker Support section below.
  • Linux support. It's still very far from ideal, but it's my intention to leave the repo working for both MacOS and Linux as well as we can. The initial effort is done via the Docker support. The community can take it from there and help improve things.
  • Themes and colors. I'm not a fan of Solarized so I removed it and so far I'm enjoying Gruvbox theme (both for Vim and the terminal). I have also created my own zsh prompt. There are some screenshots in the Screenshots section below.

What's included, how to learn, how to customize?

The best way to learn the answer the the above questions is to browse the README files in each directory (starting with this one). For example, if you're insterested in seeing which vim plugins are there, as well their keymaps, head to nvim/ and start from there, proceeding to its subfolders' README and finally to each configuration file (there will be more specific comments inside each file).

Docker Support

We can use Docker to test some changes in a Linux Container.

Assuming your host system has Docker & Docker Compose properly installed, run:

docker-compose run dotfiles

This will build the container image it never built it before (which may take a while -- future times will be faster) and then run a zsh session inside that container for you. There you can play around, test commands, aliases, etc.

Warning: this repo is primarly OSX oriented. So any support for Linux can only be done with the help of the community.


We have a basic automated CI testing for both Linux and OSX. Head to test/ for more details.


Here's how my zsh prompt looks like on iTerm:

And here's another example inside a tmux's pane with tmux's statusline (powerline style):

It's using Gruvbox colors. For screenshots on how Vim looks with Gruvbox, you can check their gallery out.

Vimization of everything

The provided inputrc and editrc will turn your various command line tools like mysql and irb into vim prompts. There's also an included Ctrl-R reverse history search feature in editrc, very useful in irb, postgres command line, and etc.


See Other recommended OSX productivity tools.

Also, the a osx file is a bash script that sets up sensible defaults for devs and power users under osx. Read through it before running it. To use:


These hacks are Lion-centric. May not work for other OS'es. My favorite mods include:

  • Ultra fast key repeat rate (now you can scroll super quick using j/k)
  • No disk image verification (downloaded files open quicker)
  • Display the ~/Library folder in finder (hidden in Lion)


See Credits & Thanks

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.
Git (34,433
Vim (18,654
Zsh (7,211
Neovim (3,939
Tmux (3,870
Vim Plugin (2,485
Neovim Dotfiles (150
Vim Configs (133
Tmux Configs (89
Brewfile (54
Prezto (46
Prezto Prompt (3