P2P sync
Pair devices, live-sync open files across the LAN, and manage trusted peers.
Live sync keeps open project files aligned across devices without a central cloud. Devices discover each other on the local network (and can use relay paths depending on configuration), pair with a short phrase, then exchange edits.
Configure everything under Preferences → Sync. The footer sync cloud icon jumps there when tapped.
Concepts
| Term | Meaning |
|---|---|
| Pairing | Two devices exchange a 6-word phrase so they trust each other |
| Trusted peer | A device you have paired with before (may reconnect without re-entering a phrase) |
| Live sync | Continuous edit sync for the open project |
| Discovery | Finding peers on the LAN (mDNS) |
Sync state for the project is stored under .rope_notes/ (ledger and trust files). Treat that folder as part of the project’s private runtime data.
Typical setup
- Open the same project (or a transferred copy) on two devices.
- On both: Preferences → Sync → enable discovery / listening as prompted.
- Pair using the 6-word phrase shown on one device; enter it on the other (or approve as directed).
- Start live sync. For unknown peers, confirm the approval dialog when asked.
- Edit on either device; the other should catch up for open, synced files.
Trusted peers can reconnect more smoothly on later sessions.
Approvals
- Pairing uses the phrase as proof; you may see a notification rather than a blocking dialog.
- Live sync from an unknown peer asks you to approve in the UI (with a timeout).
- Session transfer over the network uses the same pairing/trust machinery — see Session transfer.
Good practices
- Pair on a network you trust.
- Keep only the devices you need in the trusted-peers list.
- If sync behaves oddly (duplicated file contents, repeated crashes on edit), stop live sync on all devices, delete the sync ledger files under
.rope_notes/(sync_state.loroand related.bak/.sha256files) on each peer, then restart and re-pair. Do this only when recovering from corruption.
Platform notes
Available on desktop and mobile builds that include the sync library. Not available on web.