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

TermMeaning
PairingTwo devices exchange a 6-word phrase so they trust each other
Trusted peerA device you have paired with before (may reconnect without re-entering a phrase)
Live syncContinuous edit sync for the open project
DiscoveryFinding 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

  1. Open the same project (or a transferred copy) on two devices.
  2. On both: Preferences → Sync → enable discovery / listening as prompted.
  3. Pair using the 6-word phrase shown on one device; enter it on the other (or approve as directed).
  4. Start live sync. For unknown peers, confirm the approval dialog when asked.
  5. 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.loro and related .bak / .sha256 files) 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.