softcopy
Current Release: 1.0.1
CLI tool for recovering binary data from hard-copy mnemonics (PGPfone, S/KEY OTP, BIP-39, Diceware) and verifying checksums. Sibling to hardcopy.
Installation
Usage
Decode from Hard Copy
Interact Mnemonic Words
# Interactive: enter words line by line from your printed hard copy
# Using S/KEY OTP word list
# Using BIP-39 word list
# Using Diceware word list
Input format: one line at a time, words separated by spaces. Line number prefix (0001: ) is optional (as printed by hardcopy --txt).
Verify Checksum
# Verify a recovered file matches the SHA-256 on your hard copy
# Enter checksum from hard copy when prompted
Supported Plugins
| Plugin | Words/Line | Source | Use Case |
|---|---|---|---|
plugins.pgpfone |
4 | PGPfone word list | PGP key backup (default) |
plugins.skeyotp |
6 | RFC 2289 S/KEY | One-time passwords |
plugins.bip39 |
6 | BIP-39 wordlist | Cryptocurrency seeds |
plugins.diceware |
6 | EFF Large Diceware | High-entropy passphrases |
Each plugin includes its own checksum/hashcode validation.
Example: Recover PGP Key from Hard Copy
# 1. Run softcopy with PGPfone plugin (default)
# 2. Follow prompts:
# Enter the mnemonic words from your hard-copy, one line at a time.
# Each line should have 4 words (optionally prefixed with the line number).
# Press Enter on an empty line or Ctrl+D when finished.
# Line 0001 > ALPHA BRAVO CHARLIE DELTA
# Line 0002 > ECHO FOXTROT GOLF HOTEL
# ...
# Line 0005 >
#
# 3. Output written
# Written 1234 bytes to: recovered.pgp
# 4. Verify against checksum on hard copy
# Please enter the SHA-256 checksum from your hard-copy:
# > a1b2c3d4e5f6...
# Checksum matches. Data integrity verified.
Options
softcopy [OPTIONS] [FILE]
OPTIONS:
--from <PLUGIN> Decoding plugin: plugins.pgpfone (default), plugins.skeyotp, plugins.bip39, plugins.diceware
-o, --output <FILE> Output file path for reconstructed data
--verify Verify a file against SHA-256 checksum from hard copy
--debug Enable debug logging
Workflow with hardcopy
┌─────────────┐ hardcopy ┌─────────────┐ softcopy ┌─────────────┐
│ Binary │ ────────────────► │ Hard Copy │ ────────────────► │ Recovered │
│ (keys, │ (PDF/TXT/HTML) │ (paper, │ (interactive │ Binary │
│ seeds) │ │ QR codes) │ word entry) │ (verified) │
└─────────────┘ └─────────────┘ └─────────────┘
│ ▲
│ SHA-256 checksum │ --verify
└───────────────────────────────┘
Features
Requires libhardcopy with out-bip39 and out-diceware features (enabled by default in this crate).
License
GPL-3.0