desync(1)

📦
version 1.1.5 · 3 versions
, in arch rolling

🌸 NAME 🌸

okay bestie, this page is desync-chop, and it lives under the desync(1) manual — it’s literally “Read chunks from a file according to an index” ✨

✨ SYNOPSIS ✨

desync chop <index> <file> [flags]

💖 DESCRIPTION 💖

So what it does: it reads the <index> and extracts all referenced chunks from the <file> into a store — local or remote, whichever vibe you’re on 💅

It does not modify the input file or the index in any way. No cap. It’s used to populate a chunk store by chopping up a file according to an existing index 🎀

If you wanna exclude chunks that are already known to exist in the target store, use --ignore <index> — that skips any chunks from the given index. Same energy can be achieved by providing the chunks in their ASCII representation in a text file with --ignore-chunks <file> 🦋

And yes: use - to read the index from STDIN 👑

🎀 OPTIONS 🎀

  • --ca-cert="" — trust authorities in this file, instead of the OS trust store 🫶
  • -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 chop
  • --ignore=[] — index(es) with chunks to be excluded 🙈
  • --ignore-chunks=[] — text file with chunk IDs to be excluded
  • -s, --store="" — target store 🍓
  • -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 chop -s sftp://192.168.1.1/store file.caibx largefile.bin

💜 SEE ALSO 💜

🌈 HISTORY 🌈

  • 20-Oct-2026 Auto generated by spf13/cobra

this whole page is from the desync manual, dated Oct 2026, and it’s out here repping desync(1) like the main character it is 💅✨

📦 where this page comes from