Skip to content

Commit 6f75ae6

Browse files
committed
clarified new demo bundles in readme
1 parent 90ca5a1 commit 6f75ae6

1 file changed

Lines changed: 8 additions & 8 deletions

File tree

README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -80,10 +80,10 @@ See the **[CLI User Guide](docs/guide.md)** for complete documentation.
8080

8181
Before protecting real secrets, try the recovery process:
8282

83-
1. **[Download demo bundles](https://github.com/eljojo/rememory/releases/latest/download/demo-bundles.zip)** (contains 3 sample bundles)
83+
1. **[Download demo bundles](https://github.com/eljojo/rememory/releases/latest/download/demo-bundles.zip)** (5 friends, any 3 can recover)
8484
2. Open `bundle-alice/recover.html` in your browser
85-
3. Alice's share is pre-loaded — add Bob's or Carol's
86-
4. When enough shares are added, the files unlock
85+
3. Alice's piece is pre-loaded — drag two more README files onto the page. Dragging an entire bundle works too.
86+
4. When enough pieces are combined, the files unlock
8787

8888
This is the closest thing to what a real recovery feels like.
8989

@@ -95,12 +95,12 @@ Each friend gets a ZIP bundle containing:
9595

9696
| File | Purpose |
9797
|------|---------|
98-
| `README.txt` | Instructions, their unique share, contact list |
98+
| `README.txt` | Instructions, their unique piece, contact list |
9999
| `README.pdf` | Same content, formatted for printing |
100100
| `MANIFEST.age` | Your encrypted files (only included separately when over 10 MB) |
101101
| `recover.html` | Recovery tool (~300 KB), runs in any browser. For smaller archives, everything is embedded — just open this file |
102102

103-
**A single share reveals nothing.** But tell your friends to keep their bundle somewhere safe — it's their responsibility to you.
103+
**A single piece reveals nothing.** But tell your friends to keep their bundle somewhere safe — it's their responsibility to you.
104104

105105
![Example README PDF — page 1](docs/screenshots/demo-pdf/page-1.png)
106106

@@ -178,7 +178,7 @@ See the **[Security Review](docs/security-review.md)** for details.
178178
| Integrity | SHA-256 checksums |
179179
| Passphrase | 256 bits from crypto/rand |
180180

181-
**A single share reveals nothing about your secret.** This is a mathematical guarantee of Shamir's Secret Sharing — any fewer than *threshold* shares contains zero information about the original secret.
181+
**A single piece reveals nothing about your secret.** This is a mathematical guarantee of Shamir's Secret Sharing — any fewer than *threshold* pieces contain zero information about the original secret.
182182

183183
</details>
184184

@@ -188,7 +188,7 @@ See the **[Security Review](docs/security-review.md)** for details.
188188
| What if... | Result |
189189
|------------|--------|
190190
| A friend loses their bundle? | Fine, as long as threshold friends remain |
191-
| A friend leaks their share publicly? | Harmless without threshold-1 other shares |
191+
| A friend leaks their piece publicly? | Harmless without threshold-1 other pieces |
192192
| ReMemory disappears in 10 years? | `recover.html` still works — it's self-contained |
193193
| Browsers change dramatically? | Pure JavaScript with no external dependencies |
194194
| You forget how this works? | Each bundle's README.txt explains everything |
@@ -249,7 +249,7 @@ ReMemory isn't the first tool to use Shamir's Secret Sharing. Its focus is makin
249249
**Key takeaways:**
250250

251251
- Most tools only handle **text or passphrases**[eljojo/rememory](https://github.com/eljojo/rememory), both horcrux projects, [henrysdev/Haystack](https://github.com/henrysdev/Haystack), [cyphar/paperback](https://github.com/cyphar/paperback), and [msolomon/keybearer](https://github.com/msolomon/keybearer) are the few that handle actual files.
252-
- Only [eljojo/rememory](https://github.com/eljojo/rememory) generates a **self-contained recovery tool** (`recover.html`) bundled with each share — no installation, no internet, no CLI needed.
252+
- Only [eljojo/rememory](https://github.com/eljojo/rememory) generates a **self-contained recovery tool** (`recover.html`) bundled with each piece — no installation, no internet, no CLI needed.
253253
- Only [eljojo/rememory](https://github.com/eljojo/rememory) includes **contact details** in each bundle so friends know how to reach each other during recovery.
254254
- [paritytech/banana_split](https://github.com/paritytech/banana_split) and [cyphar/paperback](https://github.com/cyphar/paperback) output **QR codes** for printing, which is great for paper-based backups of short secrets.
255255
- **Bitwarden Emergency Access** is fundamentally different — it delegates vault access to one trusted person (not M-of-N splitting) and requires an online service.

0 commit comments

Comments
 (0)