dotdrop(1)

📦
version 1.16.1 · 3 versions
, in ubuntu stonking

✨ NAME ✨

dotdrop — save your dotfiles once, deploy them everywhere 💅

(and yes bestie, this is the dotdrop(1) manual page, section 1, we love her)

🦋 SYNOPSIS 🦋

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

🌸 DESCRIPTION 🌸

okay SO. dotdrop makes managing your dotfiles across different hosts actually easy instead of a whole personality crisis. It lets you keep your dotfiles in Git and then automagically deploy different versions of the same file on different setups. no cap. 🫶

It also lets you manage different sets of dotfiles. like, say you've got one set for your home laptop and a totally different set for your office desktop. those sets can overlap, and different versions of the same dotfiles can be deployed using different predefined profiles. or maybe you've got a main set for your everyday host plus a subset you only need to push to temporary hosts (cloud VM etc.) that might be running a slightly different version of some of the dotfiles. it's giving versatile 👑

💖 COMMANDS 💖

🎀 install — Install dotfiles

  • -a, --force-actions — execute all actions even if no dotfile is installed 💅
  • -d, --dry — dry run, no commitment, just vibes 👀
  • -D, --showdiff — show a diff before overwriting, so you can lowkey see what's about to change
  • -f, --force — do not ask user confirmation for anything, we're speedrunning this fr fr
  • -n, --nodiff — do not diff when installing
  • -p, --profile=<profile> — specify the profile to use
  • -t, --temp — install to a temporary directory for review 🔍
  • -w, --workers=<nb> — number of concurrent workers [default: 1]
  • -W, --workdir-clear — clear the workdir

🎀 import — Import dotfiles

  • -d, --dry — dry run
  • -f, --force — do not ask user confirmation for anything
  • -i, --ignore=<pattern> — pattern to ignore 🙈
  • -l, --link=<link> — link option (nolink|absolute|relative|link_children)
  • -m, --preserve-mode — insert a chmod entry in the dotfile with its mode
  • -p, --profile=<profile> — specify the profile to use
  • -s, --as=<path> — import as a different path from actual path
  • --transr=<key> — associate trans_install key on import
  • --transw=<key> — apply trans_update key on import

🎀 compare — Compare dotfiles

  • -C, --file=<path> — path of dotfile to compare
  • -i, --ignore=<pattern> — pattern to ignore
  • -p, --profile=<profile> — specify the profile to use
  • -w, --workers=<nb> — number of concurrent workers [default: 1]
  • -z, --ignore-missing — ignore files in installed folders that are missing

🎀 update — Update a managed dotfile

  • -d, --dry — dry run
  • -f, --force — do not ask user confirmation for anything
  • -i, --ignore=<pattern> — pattern to ignore
  • -k, --key — treat <path> as a dotfile key 🔑
  • -p, --profile=<profile> — specify the profile to use
  • -P, --show-patch — provide a one-liner to manually patch template
  • -w, --workers=<nb> — number of concurrent workers [default: 1]
  • -z, --ignore-missing — ignore files in installed folders that are missing

🎀 remove — Unmanage a dotfile

  • -d, --dry — dry run
  • -f, --force — do not ask user confirmation for anything
  • -k, --key — treat <path> as a dotfile key 🔑
  • -p, --profile=<profile> — specify the profile to use

🎀 files — List the managed dotfiles

  • -G, --grepable — grepable output
  • -p, --profile=<profile> — specify the profile to use
  • -T, --template — only template dotfiles

🎀 detail — Detail managed dotfiles

  • -p, --profile=<profile> — specify the profile to use

🎀 profiles — List all profiles

  • -G, --grepable — grepable output

💜 GLOBAL OPTIONS 💜

these hit different everywhere, bestie:

  • -b, --no-banner — do not display the banner
  • -c, --cfg=<path> — path to the config
  • -V, --verbose — be verbose 🗣️

🌈 EXAMPLES 🌈

look at these iconic little invocation shapes 👑

dotdrop install
       [-VbtfndDaW] [-c <path>] [-p <profile>] [-w <nb>] [<key>...]

dotdrop import
       [-Vbdfm]     [-c <path>] [-p <profile>] [-i <pattern>...]
       [--transr=<key>] [--transw=<key>] [-l <link>] [-s <path>]
       <path>...

dotdrop compare
       [-LVbz]      [-c <path>] [-p <profile>] [-w <nb>] [-C <file>...]
       [-i <pattern>...]

dotdrop update
       [-VbfdkPz]   [-c <path>] [-p <profile>] [-w <nb>] [-i
       <pattern>...] [<path>...]

dotdrop remove
       [-Vbfdk]     [-c <path>] [-p <profile>] [<path>...]

dotdrop files
       [-VbTG]      [-c <path>] [-p <profile>]

dotdrop detail
       [-Vb]        [-c <path>] [-p <profile>] [<key>...]

dotdrop profiles
       [-VbG]       [-c <path>]

dotdrop --help

dotdrop --version

🌟 ABOUT 🌟

more info can be found on the repository under https://github.com/deadc0de6/dotdrop and in the main documentation under https://dotdrop.readthedocs.io 📚

⭐ AUTHOR ⭐

written by deadc0de6 — https://github.com/deadc0de6

dotdrop is copyright (c) 2017, deadc0de6. released under the GPLv3 license. periodt. 💅

🍓 REPORTING BUGS 🍓

found a lil bug? spill here: https://github.com/deadc0de6/dotdrop/issues 🐛

okay and that's the whole page bestie, tysm for reading 🫶 this was dotdrop version dotdrop-1.16.1, dated 11 April 2026, and it lives in section dotdrop(1). go forth and slay your dotfiles ✨💖🎀

📦 where this page comes from