Peer Share

Send files and folders from one Obsidian vault to another, straight from device to device. Peer Share uses WebRTC and the PairDrop protocol, so it also works with the PairDrop web app on any phone or computer with a browser.

No account, no cloud storage. Devices on the same network find each other automatically. Pair two devices once and they'll find each other from anywhere.

Features

• Send single files, several files, or whole folders
• Automatic discovery on your local network
• Pairing with a 6-digit code for devices on different networks
• Auto-accept for devices you trust
• Works with pairdrop.net in a browser, so you can send to devices that don't have Obsidian
• Relayed connections when a direct one isn't possible (VPNs, strict firewalls)
• Share history sidebar with search, filters and statistics
• Desktop and mobile
• English, Spanish, German, French, Russian, Japanese, Korean and Simplified Chinese

Installation

In Obsidian, open Settings → Community plugins → Browse, search for "Peer Share", then install and enable it. You can also install it from community.obsidian.md.

To install by hand:

1. Download main.js, manifest.json and styles.css from the latest release.
2. Put them in a new folder: <your vault>/.obsidian/plugins/peer-share/.
3. In Settings → Community plugins, reload the installed plugins and enable Peer Share.

Quick start

1. Install Peer Share on both devices (or open pairdrop.net on the second one).
2. Click the Peer Share icon in the ribbon.
3. Pick the other device, pick your files, and send.
4. Accept the transfer on the other device. Files land in the peer-share folder.

Don't see the other device? It's probably on a different network or a VPN. Run Peer Share: Pair with device on both and enter the code.

The User guide covers everything else: pairing, receiving, settings, history and troubleshooting.

Privacy and security

Files travel directly between the two devices, encrypted by WebRTC. The signaling server (pairdrop.net by default) introduces the devices to each other and never receives your files. When no direct route exists, the data passes through a relay server, still encrypted between the two devices.

The server does see some metadata, such as IP addresses and when you connect. SECURITY.md explains what each party can and can't see. To keep even that metadata to yourself, run your own server.

Compatibility

• Obsidian 1.13.0 or later
• Windows, macOS, Linux, iOS and Android
• Other Peer Share vaults and PairDrop web clients

Contributing

Bug reports and pull requests are welcome. See CONTRIBUTING.md.

License

MIT. See LICENSE.

Credits

Built on the protocol and public server of PairDrop, for Obsidian.