desync(1)

📦
version 1.1.5 · 3 versions
, in arch rolling

🦋 desync(1) — mtree era 🦋

bestie, welcome to the desync-mtree corner of desync(1). It’s giving “print my archive contents in mtree format” and honestly? iconic. 💅

🎀 NAME 🎀

desync-mtree — Print the content of a catar, caidx or local directory in mtree format. no cap, that’s the whole assignment. ✨

✨ SYNOPSIS ✨

desync mtree <catar|index|dir> [flags]

💖 DESCRIPTION 💖

okay so this command reads an archive (catar), an index (caidx), or a local directory, and prints the content in mtree format. literally the main character behavior we deserve. 🫶

The input is either a catar archive, a caidx index file (with -i and -s), or a local directory. pick your vibe, bestie. 🌸

🌸 OPTIONS 🌸

  • --ca-cert="" — trust authorities in this file, instead of OS trust store.
  • -c, --cache="" — store to be used as cache.
  • -r, --cache-repair[=true] — replace invalid chunks in the cache from source.
  • --client-cert="" — path to client certificate for TLS authentication.
  • --client-key="" — path to client key for TLS authentication.
  • -n, --concurrency=10 — number of concurrent goroutines, -1 to let desync choose: the number of CPUs for chunking and hashing, adapting to each store up to 128 for transfers.
  • -e, --error-retry=3 — number of times to retry in case of network error.
  • -b, --error-retry-base-interval=500ms — initial retry delay, increases linearly with each subsequent attempt.
  • -h, --help[=false] — help for mtree.
  • -i, --index[=false] — read index file (caidx), not catar.
  • -s, --store=[] — source store(s), used with -i.
  • -t, --trust-insecure[=false] — trust invalid certificates.

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • --config="" — config file (default $HOME/.config/desync/config.json).
  • --digest="sha512-256" — digest algorithm, sha512-256 or sha256.
  • --verbose[=false] — verbose mode.

🎀 EXAMPLE 🎀

desync mtree docs.catar
desync mtree -s http://192.168.1.1/ -c /path/to/local -i docs.caidx
desync mtree /path/to/dir

🔗 SEE ALSO 🔗

📜 HISTORY 📜

20-Oct-2026 — Auto generated by spf13/cobra. the lore is literally right there, bestie. 💀

xoxo, bestie — source/version desync, date Oct 2026 💅 (desync(1), obviously).

📦 where this page comes from