About yadm
yadm is a tool that simplifies dotfile management by leveraging Git. It allows you to maintain a single repository of configurations in your home directory, making it easy to sync and manage settings across multiple systems. With features like alternate files, encryption support, and customizable hooks, yadm provides a flexible and secure way to handle your dotfiles.
FAQ
You can configure Git author information globally using the git config command, and then manage it via yadm. For example: git config --global user.email "your-email@domain" and git config --global user.name "Your Name". To add this to your yadm repository, use yadm add ~/.gitconfig. Alternatively, you can configure these settings specifically for your yadm repo using yadm gitconfig.
By default, yadm ignores untracked files. To display them, use the -unormal parameter: yadm status -unormal. To change the default behavior, you can configure it in the yadm repository itself using yadm gitconfig --unset status.showUntrackedFiles.
You can use the yadm add command with the -u parameter: yadm add -u :/. Note that the :/ is not necessary starting with Git 2.0.
You can change the URL of your remote yadm repository using the yadm remote set-url command. For example: yadm remote set-url origin .
Yes, it is recommended to add your yadm configurations (stored in ~/.config/yadm/config) to your repository. This allows your configurations to follow you when you clone your repository.
Yes, you only need gpg, openssl, transcrypt, or git-crypt installed if you plan on using the encrypt/decrypt features. yadm will inform you if a dependency is missing for any command.
No, you should not add encrypted files directly to the repository. Instead, add the names or wildcard patterns of the files you want encrypted to ~/.config/yadm/encrypt. Then use the yadm encrypt command to encrypt the matched files, which adds them to ~/.local/share/yadm/archive. Finally, add ~/.local/share/yadm/archive to your repository.
You can configure ignored files by adding a .gitignore file to your $HOME directory or sub-directories, similar to how you would with Git. Alternatively, you can add patterns to $HOME/.local/share/yadm/repo.git/info/exclude. Be sure to add these files to your repository so they can be synced.
Alternatives to consider
Community ratings & full listBadges
Promote yadm giving it more exposure, by adding these badges to your website, documentation, or product listing. Each badge links back to yadm page on Webfolio.
<a href="https://www.webfolio.to/tools/yadm?utm_source=badge&utm_campaign=badge" target="_blank" rel="noopener noreferrer"><img src="https://www.webfolio.to/badges/featured_color.svg" alt="Featured on Webfolio" style="max-width: 150px" /></a>
Categories
Claim this tool
Are you the founder? Claim your profile to update details and track views.