dotman is a simple, elegant & easy to use dotfiles manager πŸ––πŸ½

Download as .zip Download as .tar.gz View on GitHub

build status badge License: MIT platform: linux and macos bash love Website Status dotman Twitter: bhupeshimself

✨ Learn how I made dβ—‹tman from scratch ✨


Demo πŸ”₯


🌠 Features

Wait! it’s not written in a fancy language

And it doesn’t have to be. Why?

πŸ’  Installation

via curl ➰

sh -c "$(curl -fsSL"

via wget πŸ“₯

sh -c "$(wget -O-"

via httpie πŸ₯§

sh -c "$(http --download"

dotman is installed by default in /home/username/dotman, your $HOME directory.

Now run dotman for 1st time set-up.

  1. Enter repository URL (without .git).
  2. Enter folder name to where this repo be cloned (relative to /home/username/).
  3. Open up new terminal πŸš€.

Manually (you ok ?)

  1. Just grab from Releases πŸ”Ό and store it anywhere on your system.
  2. Change file permissions to be πŸƒ executable.
      chmod +x
  3. Set alias for dotman (optional). Alternatively modify your .bash_aliases file.
      alias $(pwd)/
  4. Run dotman.


Just run dotman anywhere in your terminal πŸ––.


Leave the rest to it.

What else πŸ‘€

dotman exports 2 variables in your default shell config (bashrc, zshrc etc):

  1. DOT_DEST: used for finding the location of dotfiles repository in your local system.
  2. DOT_REPO: the url to the remote dotfile repo.

You can change these manually if any one of the info changes.


πŸ€“ Bhupesh Varshney

Web Twitter: @bhupeshimself DEV: bhupesh


☺️ Show your support

Support me by giving a ⭐️ if this project helped you! or just Twitter URL

Donate using Liberapay Support on ko-fi

πŸ“ License

Copyright Β© 2020 Bhupesh Varshney.
This project is MIT licensed.

πŸ“ Changelog

See the file for details.

πŸ‘‹ Contributing

Please read the CONTRIBUTING file for the process of submitting pull requests to us.

✨ Contributors

Thanks goes to these wonderful people (emoji key):



Thiago Adomaitis

πŸ› πŸ’»





This project follows the all-contributors specification. Contributions of any kind welcome!