Configuration

Rotz uses a git repo containing the dotfiles and yaml, [toml] or [json] files for configuration.

tip

To use another file format see Other File Formats.

This git repo should be located at ~/.dotfiles. Different paths can be specified using the --dotfiles cli flag or in the Rotz config file.

tip

The location of the config file can be overridden using the --config cli flag. To get the default location of the config run rotz --help

Each managed application has a subfolder containing its dotfiles and a dot.yaml file.

yaml
toml
json

Example:
└── vscode
    ├── dot.yaml
    ├── keybindings.json
    └── settings.json

Example:
└── vscode
    ├── dot.toml
    ├── keybindings.json
    └── settings.json

Example:
└── vscode
    ├── dot.json
    ├── keybindings.json
    └── settings.json

The file dot.yaml/dot.toml/dot.json contains information about how to install the application and where to link the dotfiles.

Nesting

The dots can also be nested. See the Nesting section for more information.

yaml
toml
json

Example: nested dots
└── editors
    ├── vscode
    │   ├── dot.yaml
    │   ├── keybindings.json
    │   └── settings.json
    └── neovim
        ├── dot.yaml
        └── init.lua

Example: nested dots
└── editors
    ├── vscode
    │   ├── dot.toml
    │   ├── keybindings.json
    │   └── settings.json
    └── neovim
        ├── dot.toml
        └── init.lua

Example: nested dots
└── editors
    ├── vscode
    │   ├── dot.json
    │   ├── keybindings.json
    │   └── settings.json
    └── neovim
        ├── dot.json
        └── init.lua

Nesting​

Nesting