Dotfiles generator that allows quick configuration of different window managers in multiple OSs.

Arch Linux

Install dots-stable from AUR

$ yay dots-stable
$ dots --help

or install the rolling release dots-git from AUR

$ yay dots-git
$ dots --help

Installation from Source

Use this for any OS that is not Arch Linux or Arch Linux based distro

$ git clone https://github.com/ulises-jeremias/dotfiles /tmp/dotfiles
$ cd /tmp/dotfiles
$ sudo ./install
$ dots --help

The installation script allows you to install all the necessary dependencies that allow your dotfiles config work correctly.

Customization

There is no need to fork this repository in order to customize it. Everything can be customized by leveraging the custom-config directory. You are encouraged to maintain a separate github repository of configurations for your own dotfiles.

Read more about this at Customization Docs.

Examples

Testing

We have different testing environments that allow us to test the dotfiles generator in different OSs and window managers.

Docker and Xephyr

To run the testing environment just run the following commands;

$ git clone https://github.com/ulises-jeremias/dotfiles /tmp/dotfiles
$ cd /tmp/dotfiles
$ ./playground/bin/test --os="<os>" --wms=<WMS> # use -h to know more about install options

Vagrant

To run the testing environment just run the following commands;

$ git clone https://github.com/ulises-jeremias/dotfiles /tmp/dotfiles
$ cd /tmp/dotfiles
$ cd ./playground/vagrant/<os>/
$ vagrant up

# to access the VM
$ vagrant ssh

Contributors

Made with contributors-img.