formseal-decrypt 0.4.0

CLI tool for decrypting formseal ciphertexts

Decrypt formseal ciphertexts locally.

---

formseal-decrypt decrypts form submissions downloaded by formseal-fetch. Nothing is decrypted in transit or on the server — only the holder of the private key can read submissions.

formseal-decrypt is not a hosted service or dashboard. It is a CLI decryption utility.

---

Installation

Via pipx (recommended)

pipx install formseal-decrypt

Via pip

pip install formseal-decrypt

---

Quick start

fsd connect
fsd decrypt
fsd status

---

How it works

Browser (formseal-embed)
       │
       ▼ (encrypted submissions)
 Your server / endpoint
       │
       ▼ (fsf fetch)
 ciphertexts.jsonl ──► Your PC
       │
       ▼ (fsd decrypt)
 formseal.decrypted.jsonl (or .json for pretty output)

Your backend stores opaque ciphertext only. fsf fetch downloads it. fsd decrypt decrypts it offline with your private key.

---

Commands

Command	Description
fsd	Show about / info
fsd connect	Configure source, destination, private key, and format
fsd decrypt	Decrypt ciphertexts
fsd status	Show configuration
fsd disconnect	Clear credentials
fsd disconnect --wipe	Clear everything including messages

Run fsd --help for all options.

---

Output Formats

During fsd connect, you can choose the output format:

• JSON Lines (jsonl) — One JSON object per line
• JSON (json) — Pretty-printed JSON array

---

Security

Your private key never leaves your machine. formseal-decrypt:

• Stores credentials in your OS keychain (Windows Credential Manager / macOS Keychain / Linux Secret Service)
• Decrypts locally only
• Sends no telemetry, has no analytics
• Skips already-decrypted messages automatically

---

Documentation

• SECURITY.md — Security policy

---

Please star the repo if you find formseal-decrypt useful.

---

License

MIT