22 releases

0.10.0 Dec 10, 2023
0.9.5 Jul 14, 2023
0.9.3 Feb 12, 2023
0.9.1 Nov 6, 2022
0.2.0 Feb 21, 2022

#95 in Configuration

Download history 7/week @ 2023-12-04 5/week @ 2023-12-11 19/week @ 2024-02-26 169/week @ 2024-03-04 1/week @ 2024-03-11

189 downloads per month

MIT license

185KB
2.5K SLoC

Rotz πŸ‘ƒ

crates.io

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

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

πŸ—ΊοΈ Roadmap

πŸ“– 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.

  • cargo install rotz --no-default-features --features toml
    
  • cargo install rotz --no-default-features --features json
    

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.

Dependencies

~23–60MB
~1M SLoC