Skip to content

v0.6.0 — export a Set for a purpose, and seal one for critique

Choose a tag to compare

@corderro-artz corderro-artz released this 07 Sep 21:22
· 649 commits to main since this release

A cook writes your copy and holds everything. Handing a collection to somebody else is a different job, and the four reasons people do it want four different subsets. That's Export.

Open a Set and press Export…, or run nfty export.

Preset Art Marketplace metadata nfty metadata CookBook Sealed
Marketplace ✓ ✓ — — —
Asset pack ✓ ✓ ✓ — —
Full project ✓ ✓ ✓ ✓ —
Sealed critique ✓ ✓ ✓ — ✓

A preset is a starting point, not a mode — every box stays yours to change, and sealing is a switch you can put on any of the four.

The panel at the bottom names every file that will ship. It's generated by the same code that then does the writing, so it can't promise one thing and ship another.

Sealing, stated honestly

A sealed export is a .tin: the whole Set encrypted with AES-256-GCM under a key stretched by PBKDF2-SHA256 at 600,000 iterations, marked view-only.

What's real. Without the passphrase the file is noise. The view-only mark is authenticated with a second key from the same passphrase, so someone who intercepts the file can't strip it and pass the result on. Change one byte and it stops opening.

What isn't. It does not stop the person you gave the passphrase to. nfty refuses to save or export — in the engine, not just in the buttons — but the format is documented and the source is public. It's a lock on a door, not a wall, and the key-holder is already inside. It does not stop a screenshot.

Seal for people you chose, not against theft. There's deliberately no unseal command, and no --passphrase flag — argv is visible to every process on the machine and lands in your shell history. Use --key-env, or let nfty ask at the terminal.

nfty export ./collection --out ./dist --preset marketplace
nfty export ./collection --out ./dist --preset fullproject --book mybook.cbk
NFTY_KEY=... nfty export ./collection --out ./dist --preset sealedcritique --key-env NFTY_KEY

nfty inspect ./dist/ChestDemo.tin          # what it is — no passphrase needed
nfty inspect ./dist/ChestDemo.tin --key    # ...and what's inside

A recipient drops a .tin on the opening screen and is told what it is — collection, size, the sender's note — before being asked for the passphrase.

Also

  • LoadedSet.SourceDirectory, so the dialog recomputes its manifest on every checkbox without re-extracting the archive.
  • Exports are named after the collection, not the folder you cooked into.
  • ArchiveKind gains Sealed; .tin is marked binary in .gitattributes.

Downloads

framework-dependent smallest; needs the .NET 10 runtime
single-file-net10 one .exe; needs the .NET 10 runtime
single-file one .exe, nothing to install
portable unzip and run, nothing to install

Manual: https://www.vaporsoft.dev/nfty