Awesome
<p align="center"> <img src="https://github.com/Bhupesh-V/dotman/blob/master/assets/dotman-logo.png?raw=true" height="230"> </p> <p align="center"> <a href="https://github.com/Bhupesh-V/dotman/actions"> <img alt="build status badge" src="https://github.com/Bhupesh-V/dotman/workflows/build/badge.svg?branch=master"> </a> <a href="https://github.com/Bhupesh-V/dotman/blob/master/LICENSE"> <img alt="License: MIT" src="https://img.shields.io/github/license/Bhupesh-V/dotman" /> </a> <a href=""> <img alt="platform: linux and macos" src="https://img.shields.io/badge/platform-GNU/Linux %7C MacOS-blue"> </a> <a href="https://github.com/ellerbrock/open-source-badges"> <img alt="bash love" src="https://raw.githubusercontent.com/ellerbrock/open-source-badges/master/badges/bash-v1/bash.png"> </a> <a href="https://bhupesh-v.github.io/dotman"> <img alt="Website Status dotman" src="https://img.shields.io/website?url=https%3A%2F%2Fbhupesh-v.github.io%2Fdotman"> </a> <a href="https://twitter.com/bhupeshimself"> <img alt="Twitter: bhupeshimself" src="https://img.shields.io/twitter/follow/bhupeshimself.svg?style=social" target="_blank" /> </a> </p> <samp> <h3 align="center"> <a href="https://www.freecodecamp.org/news/build-your-own-dotfiles-manager-from-scratch/">β¨ Learn how I made dβtman from scratch β¨</a> </h3> </samp>Demo π₯
<p align="center"> <img alt="dotman-demo" src="https://user-images.githubusercontent.com/34342551/97109739-ee43fc00-16fa-11eb-8ed2-3a69ad7073b3.gif"> </p>π Features
- Single file manager (Portable)
- No config files for dotman (No
.dotrc
π€¦) - No useless arguments (single command π)
- Easy to use
- Extendable β, Available as a Template
- Fewer Dependencies
Git
Bash>=3
Wait! it's not written in a fancy language
And it doesn't have to be. Why?
- Your focus should be on your dot files & scripts rather than on a dotfiles manager or how to use it.(Wait I forgot what was the command to push files? Is it
dt push
ordt --push
) - Creating a overly-complex solution for something simple should not be the goal.
π Installation
via curl
β°
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Bhupesh-v/dotman/master/tools/install.sh)"
via wget
π₯
sh -c "$(wget -O- https://raw.githubusercontent.com/Bhupesh-v/dotman/master/tools/install.sh)"
via httpie
π₯§
sh -c "$(http --download https://raw.githubusercontent.com/Bhupesh-v/dotman/master/tools/install.sh)"
dotman is installed by default in
/home/username/dotman
, your$HOME
directory.
Now run dotman
for 1st time set-up.
- Enter repository URL (without
.git
). - Specify folder you want to clone the dotfile repo to (relative to
/home/username/
). - Open up new terminal π.
Manually (you ok ?)
- Just grab dotman.sh from Releases πΌ and store it anywhere on your system.
- Change file permissions to be π executable.
chmod +x dotman.sh
- Set alias for dotman (optional). Alternatively modify your
.bash_aliases
file.
alias $(pwd)/dotman.sh=dotman
- Run dotman.
dotman.sh
Usage
Just run dotman
anywhere in your terminal π.
dotman
Leave the rest to it.
What else π
dotman exports 2 variables in your default shell config (bashrc
, zshrc
etc):
DOT_DEST
: used for finding the location of dotfiles repository in your local system.DOT_REPO
: the url to the remote dotfile repo.
You can change these manually if any one of the info changes.
Author
π€ Bhupesh Varshney
Web | Twitter: @bhupeshimself | DEV: bhupesh
βΊοΈ Show your support
Support me by giving a βοΈ if this project helped you! or just
<a href="https://liberapay.com/bhupesh/donate"> <img title="librepay/bhupesh" alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg" width="100"> </a> <a href="https://ko-fi.com/bhupesh"> <img title="ko-fi/bhupesh" alt="Support on ko-fi" src="https://user-images.githubusercontent.com/34342551/88784787-12507980-d1ae-11ea-82fe-f55753340168.png" width="185"> </a>π License
Copyright Β© 2020 Bhupesh Varshney.<br /> This project is MIT licensed.
π Changelog
See the CHANGELOG.md 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):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://github.com/fpitters"><img src="https://avatars2.githubusercontent.com/u/1129222?v=4" width="100px;" alt=""/><br /><sub><b>fpitters</b></sub></a><br /><a href="https://github.com/Bhupesh-V/dotman/issues?q=author%3Afpitters" title="Bug reports">π</a></td> <td align="center"><a href="https://github.com/tadomaitis"><img src="https://avatars3.githubusercontent.com/u/20560225?v=4" width="100px;" alt=""/><br /><sub><b>Thiago Adomaitis</b></sub></a><br /><a href="https://github.com/Bhupesh-V/dotman/issues?q=author%3Atadomaitis" title="Bug reports">π</a> <a href="https://github.com/Bhupesh-V/dotman/commits?author=tadomaitis" title="Code">π»</a></td> <td align="center"><a href="http://scott.menzer.org"><img src="https://avatars1.githubusercontent.com/u/624392?v=4" width="100px;" alt=""/><br /><sub><b>Scott</b></sub></a><br /><a href="https://github.com/Bhupesh-V/dotman/issues?q=author%3Asmenzer" title="Bug reports">π</a></td> <td align="center"><a href="https://prajeshpuri.tech/"><img src="https://avatars3.githubusercontent.com/u/34602781?v=4" width="100px;" alt=""/><br /><sub><b>Prajeshpuri</b></sub></a><br /><a href="https://github.com/Bhupesh-V/dotman/commits?author=Prajeshpuri" title="Code">π»</a></td> </tr> </table> <!-- markdownlint-enable --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->This project follows the all-contributors specification. Contributions of any kind welcome!