Dotfiles

This project is a collection of dotfiles and other configuration files. It is designed to be simple and modular so you can easily pick as many files as you would like to use for your own setup.

Instead of having having your home directory clustered with various dotfiles, we have all of my relevant dotfiles bundled into a single .dotfiles direcory. To make sure that programs can find their files in the expected location, we use symbolic links.

Included Configurations

The following configurations are currently included in this repository:

Program	Files
vim	.vimrc
zsh	.zshrc	.oh-my-zsh
X	.Xdefaults	.Xdefaults.d
git	.gitconfig	.gitconfig.local
conky	.config/conky

Quick Start

Clone the repository.

$ git clone https://github.com/rngcntr/.dotfiles.git ~/.dotfiles

Initialize the submodules (optional)

Some of the contained configurations are forks of existing configuration repositories. In order to use these, you have to clone the required submodules.
```
$ cd ~/.dotfiles
$ git submodule init
$ git submodule update
```

Detailed Setup

vim

Follow step 1 of Quick Start (clone the repository)

Install Vundle

$ git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim

Create the symlink for .vimrc
```
$ ln -s ~/.dotfiles/.vimrc ~/.vimrc
```
Install the specified vim plugins
```
$ vim +PluginInstall +qall
```

zsh

Follow steps 1 and 2 of Quick Start (clone the repository and submodules)

Create the symlinks for .zshrc and .oh-my-zsh

$ ln -s ~/.dotfiles/.zshrc ~/.zshrc
$ ln -s ~/.dotfiles/.oh-my-zsh ~/.oh-my-zsh

Install oh-my-zsh
```
$ ~/.oh-my-zsh/tools/install.sh
```
Set zsh as your default shell
```
$ chsh -s $(which zsh)
```
Log out and back in for the changes to take effect

X

Follow step 1 of Quick Start (clone the repository)

Create the symlinks for .Xdefaults and .Xdefaults.d

$ ln -s ~/.dotfiles/.Xdefaults ~/.Xdefaults
$ ln -s ~/.dotfiles/.Xdefaults.d ~/.Xdefaults.d

git

Follow step 1 of Quick Start (clone the repository)

Create the symlinks for .gitconfig and .gitconfig.local

$ ln -s ~/.dotfiles/.gitconfig ~/.gitoconfig
$ ln -s ~/.dotfiles/.gitconfig.local ~/.gitconfig.local

Enter all of your personal settings into the .gitconfig.local file. Make sure you never commit this file for privacy reasons.

conky

Important Note: My conky widgets are heavily personalized and are not expected to work as intended on arbitrary systems. Anyway, feel free to use them as a starting point to create your own conky experience.

Follow step 1 of Quick start (clone the repository)

Create the symlink for conky

$ ln -s ~/.dotfiles/.config/conky ~/.config/conky

Start conky
```
$ .config/conky/conky-start.sh
```

Tip: Using this setup, conky does not automatically start on boot or login. However, conky can be auto started by creating a desktop entry and placing it in ~/.config/autostart. An example desktop entry would look like this:

[Desktop Entry]
Name=Conky
Comment=Autostart conky
Type=Application
Exec=sh -c "sleep 10; ~/.config/conky/conky-start.sh"