desync(1)

📦
version 1.1.5 · 3 versions
, in arch rolling

✨ desync-untar — NAME ✨

ok so bestie, this is desync-untar, and its whole entire thing is extracting a directory tree from a catar archive or an index 💖 that's it, that's the job. welcome to the extraction station, no cap 🎀

🌸 SYNOPSIS 🌸

desync untar <catar|index> <target> [flags]

🦋 DESCRIPTION 🦋

So you want the tea ☕: this command extracts a directory tree from a catar file or from an index. And listen — use '-' to read the index from STDIN, iykyk 💅

The input is either a catar archive, or a caidx index file (that's the one you use with -i and -s, mwah 😌).

By default, the catar archive is extracted to local disk, periodt. But if you pass --output-format=gnu-tar, the output can be set to GNU tar instead — either an archive, or straight to STDOUT with '-'. iconic behavior honestly 🔥

✨ OPTIONS ✨

  • --ca-cert="" — trust authorities in this file, instead of the OS trust store 🫶
  • -c, --cache="" — the store to be used as cache 🍓
  • -r, --cache-repair[=true] — replace invalid chunks in the cache from source, self-care fr 💅
  • --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 😭 (it happens bestie)
  • -b, --error-retry-base-interval=500ms — initial retry delay, increases linearly with each subsequent attempt ⏳
  • -h, --help[=false] — help for untar 🥺
  • -i, --index[=false] — read index file (caidx), not catar 📑
  • --no-same-owner[=false] — extract files as current user 🙈
  • --no-same-permissions[=false] — use current user's umask instead of what is in the archive 🧚
  • --no-same-xattrs[=false] — don't apply extended attributes from the archive, leave them be 💜
  • --output-format="disk" — output format, 'disk' or 'gnu-tar' 🎀
  • -s, --store=[] — source store(s), used with -i 🗂️
  • -t, --trust-insecure[=false] — trust invalid certificates ⚠️ (yes girl, that's the whole point of the flag name, tread carefully)

💫 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, for when you need ALL the lore 👀

🎀 EXAMPLE 🎀

desync untar docs.catar /tmp/documents
desync untar -s http://192.168.1.1/ -c /path/to/local -i docs.caidx /tmp/documents

look at her go 😭🫶

⭐ SEE ALSO ⭐

desync(1) — go read the main character's page too bestie 💖

🌷 HISTORY 🌷

20-Oct-2026 — Auto generated by spf13/cobra 🤖 (not me being literally auto-generated, embarrassing but slay)

ok that's the whole page, you're welcome 💅✨ this little beauty is brought to you by desync, version dated Oct 2026, shipped as desync(1) — mwah, go extract something gorgeous, ily, bye 🦋💜

📦 where this page comes from