Thanks to visit codestin.com
Credit goes to lib.rs

#dotfiles #home-dir #sync #config #repository

app dot_rust

A simple configuration files (i.e. dotfiles) manager.

4 releases (stable)

Uses new Rust 2024

1.0.2 Jul 1, 2025
0.8.0 Jul 1, 2025

#1919 in Command line utilities

32 downloads per month

MIT license

38KB
857 lines

Dot - A simple Dotfiles Manager

GitHub license Crates.io GitHub stars GitHub issues

A simple and elegant dotfile manager for Unix-like systems.

dot helps you manage your configuration files (dotfiles) by creating symbolic links from a centralized repository to their intended locations in your home directory (or wherever you want).

Features

  • Initialize: Create a new dotfiles repository.
  • Add: Start tracking a new dotfile.
  • Remove: Stop tracking a dotfile.
  • Sync: Synchronize all your dotfiles, creating symbolic links.

Installation

From Crates.io

You can install dot using cargo:

cargo install dot_rust

Build from Source

  1. Clone the repository:
    git clone https://github.com/rvillegasm/dot.git
    
  2. Navigate to the project directory:
    cd dot
    
  3. Build the project:
    cargo build --release
    
  4. The binary will be located at target/release/dot. You can move it to a directory in your $PATH.

Usage

# Initialize a new dot repository (defaults to ~/.dotfiles)
dot init

# Add a file to track
dot add ~/.vimrc

# Sync all tracked files
dot sync

# Remove a tracked file
dot remove .vimrc

Contributing

Contributions are welcome! Please feel free to open an issue or submit a pull request if you have any ideas, suggestions, or bug reports.

Code of Conduct

We adhere to the Contributor Covenant Code of Conduct. All contributors are expected to uphold this code.

License

This project is licensed under the MIT License. See the LICENSE.txt file for details.

Contact

Rafael Villegas - @rvillegasm - [email protected]

Dependencies

~1.5–4MB
~77K SLoC