Home

Awesome

Rotz 👃

crates.io

Fully cross platform dotfile manager and dev environment bootstrapper written in Rust.

Rust Dotfilemanager<br> Rust Dotfile manager<br> Rust Dotfile s<br> Rust Dot s<br> R ust Dots<br> R ots<br> Rot s<br> Rotz

📖 Documentation

Overview

Rotz has three main functionalities:

  1. Linking dotfiles from a common repository to your system
  2. Installing the applications you need to start working on an new/empty machine
  3. Full Cross platform functionality See Configuration

Installation

Homebrew

On Linux and MacOS you can install Rotz using Homebrew.

brew install volllly/tap/rotz

Scoop

On Windows you can install Rotz using Scoop.

scoop bucket add volllly https://github.com/volllly/scoop-bucket
scoop install volllly/rotz

Cargo

You can install Rotz using cargo everywhere if Rust is installed.

cargo install rotz

File Formats

Rotz uses yaml, toml or json configuration files per default.

Note: Rotz will auto detect the correct filetype.

You can install rotz with support for only one of the filetypes by using the --features flag.

Installer scripts

curl -fsSL volllly.github.io/rotz/install.sh | sh
irm volllly.github.io/rotz/install.ps1 | iex

Getting Started

If you already have a dotfiles repo you can clone it with the rotz clone command.

rotz clone git@github.com:<user>/<repo>.git

To bootstrap your dev environment use rotz install.

To link your dotfiles use rotz link.

Usage

Run rotz --help to see all commands Rotz has.

Contribute

Feel free to create pull requests and issues for bugs, features or questions.