Skip to content

joedicastro/dotfiles

Repository files navigation

dotfiles

This is a repository with my configuration files, those that in Linux normally are these files under the $HOME directory that are hidden and preceded by a dot, AKA dotfiles

Management

These configuration files are managed with the tool GNU Stow that is not intented originally for this purpose but works pretty well.

To use this configurations you only have to clone this repository in a directory of your home directory (~/dotfiles by default) and then use stow to "install" them, choosing the ones that you want to use.

For example to use the Vim configuration you only have to do this (from the dotfiles directory):

$ stow vim

and it would create a symlink for ~/.vim and ~/.vimrc to the same files/dirs in the ~/dotfiles/vim folder of this repository. Those symbolic links only would be created if not exists previously, in that case I recommend to make a backup of the original files first.

To remove a configuration is also very easy with stow:

$ stow -D vim

and it would remove the symbolic links.

And if you make a git pull to update this repository, you can "reinstall" the configurations to update them. Stow would first remove the previous symbolic links and then create the new ones.

$ stow -R vim

Stow is a package that you can find in the majority of Linux distributions and make the process of test/manage these configurations easier.

Content

That's the current content of this repository, and these are the more remarkable files.

/awesome

Configuration of Awesome

  • .config/awesome/awdt.py python script that allows me to test changes in the Awesome configuration. Starts a X session nested into the current session and served by Xephyr, with an test configuration (Awesome) running inside it.

  • .config/awesome/prep.org is a Org-mode format file in which I store the repositories, authors and licenses of the external libraries that I use in this configuration.

  • .config/awesome/check_execs.py & /awesome/logger.py are symbolic links to two python files that can be founded in this repository, https://github.com/joedicastro/python-recipes

/compton

Configuration of Compton

/dunst

Configuration of dunst

/emacs

Configuration of Emacs

/firejail

Configuration of firejail

/fontconfig

Configuration of fontconfig

/fonts

The fonts that I use in my terminal, vim, etc ...

  • Dejavu Sans Mono is a free public domain font and has the probably best Unicode support from all the monospaced fonts available.
  • Dejavu Sans Mono for Powerline is the same font adapted to use it with Powerline in Vim

/getmail

Configuration of getmail (an example with fake data)

/git

Configuration of git

/gnupg

Configuration of GnuPG

/gtk

Configuration of the Gtk theme to fix an error with the Gvim window

/hg

Configuration of Mercurial

/livestreamer

Configuration of Livestreamer

/mpd

Configuration of mpd

/ncmpcpp

Configuration of ncmpcpp

/pylint

Configuration of Pylint

/procmail

Configuration of procmail

/ranger

Configuration of ranger

/systemd

Configuration of systemd user units and timers

/tmux

Configuration of tmux

/urxvt

Configuration of rxvt-unicode

/vim

Configuration of Vim

  • .vimrc the Vim configuration file
  • .vim/README.md is a summary of my Vim configuration customizations
  • .vim/spell/ files needed for spelling
  • .vim/UltiSnips/ my custom UltiSnips snippets

/vimperator

Configuration of Vimperator

/xsession

Configuration of the X session

  • .xprofile bash script to setup the X session
  • .config/user-dirs.dirs default home user directories

/zathura

Configuration of zathura