formseal-fetch 2.9.0

Download encrypted form submissions from your storage backend.

formseal-fetch pulls ciphertexts stored by your backend down to your machine. Nothing is decrypted in transit or on the server — only the holder of the private key can read submissions.

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

Installation

Via pipx (recommended)

pipx install formseal-fetch

Via pip

pip install formseal-fetch

Quick start

fsf connect provider:<name>
fsf fetch
fsf status

How it works

Browser (formseal-embed)
       │
       ▼ (encrypted submissions)
 Cloudflare KV / Supabase / any other server
       │
       ▼ (fsf fetch)
  ciphertexts.jsonl ──► Your PC

Your backend stores opaque ciphertext only. fsf fetch downloads it. Decryption happens separately, offline, with your private key.

Commands

Run fsf --help for all options.

Security

Ciphertexts are encrypted at the source by formseal-embed. fsf only handles encrypted data — a backend compromise yields no plaintext.

Your API tokens never leave your machine. formseal-fetch:

• Stores credentials in your OS keychain (Windows Credential Manager / macOS Keychain / Linux Secret Service)
• Makes direct API calls to your storage backend only
• Sends no telemetry, has no analytics
• Skips already-downloaded ciphertexts automatically

Documentation

Full documentation is in the docs directory.

For developers

• Provider guide — Add new storage backends
• CONTRIBUTING.md — Full contributing guide

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

License

MIT