desync(1)

📦
version 1.1.5 · 4 versions
, in arch rolling

💅 desync(1) — the glow-up

okay so bestie, welcome to the desync(1) manual page 🫶 this is the main character page for desync itself — the one that introduces you to the whole squad. buckle up, it's giving "system administrator but make it cute" 💖

✨ NAME ✨

desync — a content-addressed binary distribution system 💫 (yes that's a lot of words, we'll get into it)

🎀 SYNOPSIS 🎀

desync [flags]

that's it. that's the whole vibe. flags only, no positional drama 💅

🌸 DESCRIPTION 🌸

so like, desync is a content-addressed binary distribution system — no cap, that's literally what it is 🔥

here's the tea: it chunks files into reusable, compressed pieces, and keeps those pieces in chunk stores. then it reassembles them efficiently using indexes, seeds, and caches. the way that it just *works*… iconic. 👑

and the best part? it's compatible with casync archives, indexes and stores ✨ so if you're coming from casync land, you're gonna feel right at home.

🦋 store locations 🦋

okay so store locations — these are what you use with options like -s/--store and -c/--cache, and they can be lowkey any of these:

  • /path/to/store — a local directory store 🍓
  • http(s)://host/path/ — a chunk/index server (peep the chunk-server command) 🌈
  • s3+http(s)://host/bucket — an S3-compatible object store ☁️
  • gs://bucket/prefix — a Google Cloud Storage bucket 💜
  • sftp://user@host/path — an SFTP store 🧚
  • ssh://user@host/path — the casync protocol over SSH, and ngl this one is read-only 🙈

💫 multiple stores, multiple vibes 💫

commands that accept multiple stores will try them in the order given — first come, first served, periodt 💅

and here's the cute part: you can combine several stores into one failover group by separating them with |. for example:

-s "http://server1/store|http://server2/store"

so if server one is being flaky, server two catches you. main character AND a safety net 😭💖

⭐ OPTIONS ⭐

  • --config="" — the config file, and it defaults to $HOME/.config/desync/config.json 🎀 (empty string means "use the default", iykyk)
  • --digest="sha512-256" — the digest algorithm. your choices are sha512-256 or sha256, and the default is sha512-256 🔥
  • -h, --help[=false] — help for desync 💖 (defaults to false)
  • --verbose[=false] — verbose mode, for when you wanna know everything 👀 (defaults to false)
  • --version[=false] — prints the version and dips 👋 exits right after (defaults to false)

🌟 SEE ALSO 🌟

the whole friend group, in all their glory:

go read them, bestie. all of them. no skipping 💅

🧚 HISTORY 🧚

20-Oct-2026 — Auto generated by spf13/cobra 🤖✨ (the robots wrote this one so we didn't have to)

one tiny PSA before you go: this page is desync(1) from Oct 2026 — that's the version + date combo, and it's the desync manual, section 1. slay 💖🦋

go forth and chunk, queen 👑💜

📦 where this page comes from