26 releases (4 stable)

Uses new Rust 2024

new 1.2.1 Apr 14, 2025
1.2.0 Mar 9, 2025
1.1.0 Feb 27, 2025
1.0.0 Dec 18, 2024
0.2.0 Feb 21, 2022

#19 in Configuration

Download history 4/week @ 2024-12-24 11/week @ 2025-01-07 2/week @ 2025-01-14 77/week @ 2025-02-11 12/week @ 2025-02-18 158/week @ 2025-02-25 132/week @ 2025-03-04 50/week @ 2025-03-11 6/week @ 2025-03-18 46/week @ 2025-04-08

66 downloads per month

MIT license

210KB
3K 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

📖 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–55MB
~894K SLoC