dotfiles/README.md -rw-r--r-- 3.6 KiB
86a5187bHugo Osvaldo Barrera nvim: Add mapping for LSP rename 14 hours ago


"A man and his tools make a man and his trade". -Vita Sackville-West

This repository contains all configuration files for my desktop setup. The entire system configuration is defined in a declarative way, so recreating it and rolling back and forth can be done with confidence.

There's a few sets of files here:

dotfiles: These are user-specific configuration for applications. This includes compositor setup, neovim configuration, terminal theme, and settings for a lot of other applications. Symlinks are placed in the home directory pointing to the files inside this repository, so it's easy to track any changes using just git.

ansible: Some ansible playbooks to configure dconf-based applications and install flatpaks I use. Due to how ansible handles sudo, it can't be used for anything system wide. There's also bootstrapping issues in trying to use it to configure pristine systems, so the scope of what ansible handles will likely continue being rather narrow.

packages: These are meta-packages that install all desired packages and configure them. See packages/README.md for details.

sysconfig: This is a deprecated system-wide configuration package, and is gradually being moved into packages.

v: My portable neovim setup. See v/README.md. Directory name is due to my shortcut alias to run it: v.

#Goals of this repo

  • Keep configurations in sync across devices.
  • Keep a versioned history of my configurations.
  • Quickly bootstrap new configure new machines (physical or virtual).
  • Roll back breaking setup or configuration changes.


I use my own rust-based tool (see src/) to keep this repository in sync with my actual dotfiles using symlinks.

It gets the job done, and builds to a static binary, which makes bootstrapping simpler. I'd love to drop my own custom tool and just rely on something maintained by someone else. However, I've yet to find something that does simply this. homesick used to work, but it's given me issues with major ruby updates over the years. A binary-compiled homesick clone would be great.


Note: This is legacy and being repaced by packages/.

The system configuration is installed by an ArchLinux package. See sysconfig/README.md for more details on that.

#Tools I use

  • sway: desktop compositor
  • waybar: system status bar
  • neovim: code editor (using LSP, tree-sitter, and quite a few plugins)
  • zsh: shell and main working environment (it's designed for interactive use)
  • foot: very fast terminal emulator in C with great defaults
  • gammastep: screen colour temperature based on sunrise and sundown
  • darkman: automatic dark mode based on sundown and sunrise

I try to upstream any fixes, tweaks and improvements whenever possible, and limit this repository to customisations and very opinionated settings only.


I try to keep things relatively well documented. Some settings or overrides require attention only once every couple of years (e.g.: Firefox style overrides), and keeping comments around lets me figure out what existing code does, and where I got it from.

git blame and git log $FILE are generally be rather useful too.

#Bootstrapping a new system

  • Remember to run rustup default stable.

#Bootstrapping a desktop environment

Need to initialise himitsu:


Also need to initialise nixpkgs:

nix-channel --add https://nixos.org/channels/nixpkgs-unstable
nix-channel --update


Copyright 2012-2022, Hugo Osvaldo Barrera hugo@barrera.io

This repository is licensed under the ISC licence. See LICENCE for details.