DOKK / manpages / debian 12 / dotdrop / dotdrop.1.en
dotdrop(1) Save your dotfiles once, deploy them everywhere dotdrop(1)

dotdrop - save your dotfiles once, deploy them everywhere

dotdrop COMMAND [OPTIONS] [ARGS] ...
dotdrop --help
dotdrop --version

Dotdrop makes the management of dotfiles between different hosts easy. It allows you to store your dotfiles in Git and automagically deploy different versions of the same file on different setups.

It also allows manage different sets of dotfiles. For example, you can have a set of dotfiles for your home laptop and a different set for your office desktop. Those sets may overlap, and different versions of the same dotfiles can be deployed using different predefined profiles. Or you may have a main set of dotfiles for your everyday host and a subset you only need to deploy to temporary hosts (cloud VM etc.) that may be using a slightly different version of some of the dotfiles.

Install dotfiles
Execute all actions even if no dotfile is installed.
Dry run.
Show a diff before overwriting.
Do not ask user confirmation for anything.
Do not diff when installing.
Specify the profile to use.
Install to a temporary directory for review.
Number of concurrent workers [default: 1].
Clear the workdir.
Import dotfiles
Dry run.
Do not ask user confirmation for anything.
Pattern to ignore.
Link option (nolink|absolute|relative|link_children).
Insert a chmod entry in the dotfile with its mode.
Specify the profile to use.
Import as a different path from actual path.
Associate trans_read key on import.
Apply trans_write key on import.
Compare dotfiles
Path of dotfile to compare.
Pattern to ignore.
Specify the profile to use.
Number of concurrent workers [default: 1].
Ignore files in installed folders that are missing.
Update a managed dotfile
Dry run.
Do not ask user confirmation for anything.
Pattern to ignore.
Treat <path> as a dotfile key.
Specify the profile to use.
Provide a one-liner to manually patch template.
Number of concurrent workers [default: 1].
Ignore files in installed folders that are missing.
Unmanage a dotfile
Dry run.
Do not ask user confirmation for anything.
Treat <path> as a dotfile key.
Specify the profile to use.
List the managed dotfiles
Grepable output.
Specify the profile to use.
Only template dotfiles.
Detail managed dotfiles
Specify the profile to use.
List all profiles
Grepable output.

Do not display the banner.
Path to the config.
Be verbose.

[-VbtfndDaW] [-c <path>] [-p <profile>] [-w <nb>] [<key>...]
[-Vbdfm] [-c <path>] [-p <profile>] [-i <pattern>...] [--transr=<key>] [--transw=<key>] [-l <link>] [-s <path>] <path>...
[-LVbz] [-c <path>] [-p <profile>] [-w <nb>] [-C <file>...] [-i <pattern>...]
[-VbfdkPz] [-c <path>] [-p <profile>] [-w <nb>] [-i <pattern>...] [<path>...]
[-Vbfdk] [-c <path>] [-p <profile>] [<path>...]
[-VbTG] [-c <path>] [-p <profile>]
[-Vb] [-c <path>] [-p <profile>] [<key>...]
[-VbG] [-c <path>]

dotdrop --help

dotdrop --version

More information can be found on the repository under <https://github.com/deadc0de6/dotdrop> and in the main documentation under <https://dotdrop.readthedocs.io>

Written by deadc0de6 <https://github.com/deadc0de6>

dotdrop is copyright (c) 2017, deadc0de6. Released under the GPLv3 license.

<https://github.com/deadc0de6/dotdrop/issues>

25 January 2023 dotdrop-1.12.9