dashbeam README

The project's README from github.com/tonyantony300/dashbeam. As one markdown file: README.md.

Language: English | 中文 | Русский | Português | Español | Deutsch | Français | 日本語 | 한국어 | Polski | العربية

File transfer doesn't need to be complicated

DashBeam Header

DashBeam working demo

Discord Version Website Platforms Sponsor

A free and open-source file transfer tool that harnesses the power of cutting-edge peer-to-peer networking, letting you transfer files directly without storing them on cloud servers.

Why rely on WeTransfer, Dropbox, or Google Drive when you can reliably and easily transfer files directly, end-to-end encrypted and without revealing any personal information?

Pick whichever route is closest to hand: send a link or a QR code that opens on any device, send to a device you paired once, or send to a device already on your network. All three move the same bytes the same way - directly, encrypted end to end.

Features

Real-world stats

Metric Reported
Largest transfer 452 GB
Fastest large transfer 54 GB @ 123 MB/s (~1 Gbps)
High-speed bulk transfer 328 GB @ 93 MB/s
Peak speed measured 125 MB/s (1 Gbps)

Transfer throughput depends on your device, network, and connection path.

Installation

The easiest way to get started is by downloading one of the following versions for your respective operating system:

Platform Recommended Other formats Size
💻 Windows (x64) Setup.exe MSI, Portable ZIP ~10 MB
💻 macOS (Universal) DashBeam.dmg Apple Silicon, Intel ~15 MB
💻 Linux (amd64) DashBeam.deb .rpm, AppImage ~13 MB
📱 Android (arm64) DashBeam.apk armv7, universal ~50 MB
⌨️ CLI Downloads - ~4-5 MB
🌐 Web (Limited throughput) app.dashbeam.net - ~2 MB

More options at GitHub Releases or in Downloads page.

Running into problems? See Troubleshooting for common issues and how to collect logs.

Partners

TestMuAI

We're looking for Partners to join our mission! Partner with us and support while we push the boundaries of peer-to-peer file transfer.

LET'S CHAT

Supported Languages

🇺🇸 🇷🇺 🇫🇷 🇨🇳 🇩🇪 🇯🇵 🇮🇳 🇹🇭 🇮🇹 🇨🇿 🇪🇸 🇧🇷 🇸🇦 🇮🇷 🇰🇷 🇵🇱 🇺🇦 🇹🇷 🇳🇴 🇧🇩 🇭🇺 🇷🇸 🇹🇼 🇰🇭 🇺🇿

Ways to send

Same-network apps appear under Nearby in Settings → Devices and in the Send to a device list while you're sharing. Pick a nearby device and Pair & Send to pair and start the transfer in one step - you can also pair from Settings without sharing. First contact shows a verification code on both screens. Set who can find you in Settings → Network → Your discoverability.

Uses mDNS - often blocked on guest Wi-Fi and VPNs. See Troubleshooting if the list stays empty.

Paired devices

Pair in Settings → Devices with a pairing code (works remotely, over the internet) or via a Nearby request on the same network. After pairing, Send appears next to that device while sharing - no ticket to copy. The receiver gets an in-app prompt. Desktop can keep running in the background and show online paired devices in the tray (Settings → General → Startup & background). Manual tickets and the sendme CLI still work.

While sharing: QR for a camera scan, Share for the system sheet, Copy for the raw ticket. Links use https://app.dashbeam.net/receive?ticket=… - on Android they open the app; elsewhere the web app, so nothing to install (large files are better in the native app). Paste a ticket, link, or full share message into Receive.

Comparison

DashBeam Blip LocalSend Magic Wormhole PairDrop
Networking QUIC via Iroh Unknown HTTPS/REST over TCP encrypted TCP WebRTC/DTLS (SCTP)
Works over the internet ✅ ✅ LAN only ✅ ✅
Saturates gigabit connections ✅ ✅ LAN only ✅ ❌ (SCTP/browser ceiling)
Discover devices on LAN ✅ ❌ ✅ ❌ ❌
Persistent paired devices ✅ ✅ (account) ❌ ❌ ✅
Send folders ✅ ✅ ✅ ✅ ✅ (CLI only, not in browser)
Resumable transfers ✅ ✅ ❌ ❌ ❌
Roaming mid-transfer ✅ ❌ ❌ ❌ ❌
Send to multiple receivers ✅ (broadcast) ❌ ✅ ✅ ❌
Unlimited file size ✅ ✅ ✅ ✅ Limited by browser memory
Open source ✅ ❌ ✅ ✅ ✅
No account required ✅ ❌ ✅ ✅ ✅
End-to-end encryption ✅ ✅ ✅ ✅ ✅
Platforms CLI + desktop + mobile + web Desktop + mobile (no web/CLI) Desktop + mobile (no web/CLI) CLI only Web/PWA + Android app + CLI
The catch WIP Closed source; data handling cannot be audited Same-network only, no resume CLI-only; GUI front-ends are separate, community-maintained WebRTC/SCTP throughput ceiling; browser memory limits

Know more →

Under the hood

DashBeam is built on Iroh, a modern peer-to-peer networking stack that simplifies direct device-to-device communication. In practice, that means devices talk over encrypted QUIC, files move with content-addressed blobs, and relays help when a direct path isn’t available.

The long version: Under the hood walks the same architecture as a narrative - fingerprints instead of filenames, names instead of addresses, hole punching, roaming, and what each intermediary can and cannot see.

The building blocks

Piece What it does here
Blobs (iroh-blobs) Store and stream file data; every chunk is verified with BLAKE3
Tickets One string that tells a peer who to dial and what to fetch
Endpoints Each device’s Iroh identity (Ed25519 key → endpoint id)
QUIC + TLS 1.3 Encrypted transport; multiplexing without head-of-line blocking
Relays + hole punching Bootstrap connections across NATs; the relay carries data while a direct path is negotiated
Control protocol (pairing) Long-lived channel to remember devices and deliver share invites
Local discovery (mDNS) Optional LAN advertising so Nearby devices can find each other without a ticket
Receive links A ticket wrapped in an ordinary https URL - an App Link on Android, the web app everywhere else

Blobs

Files aren’t uploaded to a server. They’re published as blobs: opaque byte sequences addressed by a BLAKE3 hash.

Because that hash is a BLAKE3 tree rather than one digest over the whole file, every chunk verifies on its own against the root. That is what makes resume cheap: a receiver coming back after a dropped connection knows exactly which chunks it already holds and has verified, so it asks only for the gap. Nothing already received is re-sent, and nothing arriving is taken on trust.

Tickets

A share ticket is a single token that packs:

  1. The sender’s endpoint id (so you know you’re talking to the right device)
  2. Enough address / relay info to dial them
  3. The blob hash to download

You only connect to people you share a ticket with: no broadcasting your IP to strangers. That’s the default “cozy network” model Iroh encourages, vs. flooding discovery to the whole swarm.

Tickets that carry only an endpoint id lean on public-key discovery (Pkarr) to find current addresses. Those records are signed by the endpoint key itself, so a tampered one fails verification rather than misdirecting you - the lookup service is trusted for availability, not integrity.

Connecting across networks

When two devices need to meet:

  1. Each registers with a public (or self-hosted) relay so peers can find a path through firewalls and NATs.
  2. Iroh tries QUIC hole punching to upgrade to a direct peer-to-peer link.
  3. If a direct path works, traffic moves over to it. If not, the relay stays in the path as a fallback UDP hop.

Those steps overlap rather than queue. The relay is already carrying your data while hole punching negotiates, so nothing waits on the direct path to succeed - the transfer just gets faster if and when it does. Roughly one transfer in ten never gets a direct path at all (symmetric NAT, locked-down corporate networks) and rides the relay start to finish.

Either way, the payload is end-to-end encrypted. Relays see ciphertext, not your files. More on Iroh relays →

Roaming across networks

A connection is bound to the peer’s key, not to its IP address, so changing networks does not end it. Switch from Wi-Fi to cellular mid-transfer and iroh notices the address change, learns the new candidates, and republishes them to the peer. The relay carries the data throughout, and hole punching simply runs again on the new path.

Addresses are disposable hints, not identity. That is the practical payoff of naming devices by key instead of by location.

QUIC & encryption

QUIC (UDP-based, same foundation as HTTP/3) brings TLS 1.3 into the transport. For DashBeam that buys encryption and authentication, multiple streams with shared congestion control, and fast reconnects when you’ve talked to a peer before.

Paired devices

Pairing doesn’t replace tickets; it delivers them for you.

  1. Devices exchange a short pairing code (the host’s endpoint id) over a dedicated control ALPN.
  2. Each side proves identity by signing connection-bound keying material with its device secret, then remembers the peer locally.
  3. A persistent control connection keeps presence (online/offline).
  4. When you share, DashBeam still creates a normal one-time blob ticket; choosing a paired device ships that ticket as an in-app invite instead of making you copy-paste it.

Manual tickets and the sendme CLI keep working exactly as before.

Nearby (local discovery)

On the same local network, DashBeam can advertise and browse peers with mDNS (desktop and Android; not the web app).

  1. When discoverability is Everyone, the device publishes enough metadata for others to show its name in Nearby.
  2. Paired only still announces presence without exposing the display name to strangers on the LAN.
  3. Off stops advertising; you can still browse and send to others who remain discoverable.
  4. First-contact file invites show a short verification code derived from both devices' public keys so each side can confirm they're talking to the intended peer before accepting.
  5. Accepting a Nearby pair request or file invite creates the same local paired-device records as code-based pairing.

Self-hosting relays and discovery

For how to run your own iroh relay and discovery server, configure DashBeam to use them, and how mixed public/self-hosted setups behave, see infra/README.md (relay: infra/relay/README.md, discovery: infra/dns/README.md).

For the illustrated version of everything above - including a full account of what a relay operator, your ISP, and the lookup service each learn from a transfer - read Under the hood.

Development

See CONTRIBUTING.md for prerequisites, local setup, build instructions, and testing.

Join our Discord to contribute

The best way to contribute is to join our Discord and say hi. Introduce yourself and share what skills or interests you have - whether that’s coding, testing, design, or something else. You can also raise issues, suggest fixes, or pitch ideas. Maintainers are there to guide you every step of the way.

It’s the best place to get context, align on direction, and collaborate with the community.

License

AGPL-3.0

Privacy Policy

See PRIVACY.md for information about how DashBeam handles your data and privacy.

Sponsor Buy Me Coffee

Contributors

Contact

Reach me here for suggestions, feedback or media related communication.

Thank you for checking out this project! If you find it useful, consider giving it a star and helping spread the word.

Built on

iroh

dashbeam (tonyantony300/dashbeam)

Searching Database…

9.9K ·GitHub
Dashbeam
Что это такое?Бесплатный файл-трансфер с открытым исходным кодом: файлы передаются напрямую с устройства на устройство по peer-to-peer соединению, шифруются сквозным шифрованием и никогда не хранятся на облачном сервере.
Это приложение, которое нужно устанавливать, или оно работает в браузере?И то и другое. Есть нативные приложения для Windows, macOS, Linux и Android, CLI размером ~4–5 МБ и веб-приложение размером ~2 МБ, которое работает прямо в браузере без установки — правда, у веб-версии ограничена скорость передачи.
Как мне на самом деле отправить файл другому человеку?Выберите файл или папку, затем отправьте их на устройство поблизости в вашей сети, на устройство, с которым вы один раз выполнили сопряжение, или поделитесь ссылкой, QR-кодом или тикетом — получателю достаточно отсканировать или кликнуть, и передача начнётся.
Человеку, которому я отправляю файл, нужно что-то устанавливать?Нет. Ссылка или QR-код открываются в любом браузере (или в Android-приложении), так что получателю ничего устанавливать не нужно — хотя очень большие файлы лучше передавать через нативное приложение.
О каких подводных камнях стоит знать?У веб-версии ограничена скорость передачи; обнаружение устройств поблизости использует mDNS, который часто блокируется гостевым Wi-Fi и VPN; и примерно каждая десятая передача так и не получает прямое соединение и идёт через ретранслятор весь путь.
Оба устройства должны быть в одной Wi-Fi сети?Нет. Режим «поблизости» находит устройства в одной сети, сопряжённые устройства соединяются удалённо через интернет, а ссылки и QR-коды работают с любого устройства — всё это peer-to-peer.
Мои файлы проходят через сервер, и кто может их увидеть?Файлы передаются напрямую между устройствами в виде зашифрованных блоков с проверкой по BLAKE3 — ретранслятор, если он нужен, видит только шифрованные данные. Никаких аккаунтов, отслеживания или рекламы, а ретрансляторы можно развернуть на своём сервере.
Насколько это быстро на практике?В README указана крупнейшая передача на 452 ГБ, измеренный пик 125 МБ/с (~1 Гбит/с) и 328 ГБ, переданные на скорости 93 МБ/с. Реальная скорость зависит от ваших устройств, сети и пути соединения.
Чем это отличается от LocalSend, WeTransfer или Magic Wormhole?В отличие от LocalSend, это работает через интернет, а не только в одной сети, и умеет возобновлять прерванные передачи. В отличие от WeTransfer или Blip, это open source без аккаунтов, а в отличие от CLI-утилиты Magic Wormhole здесь есть GUI, мобильные и веб-приложения.
Что будет, если соединение оборвётся или я переключусь на другую сеть посреди передачи?Передача продолжится с места остановки: каждый фрагмент проверяется по хеш-дереву BLAKE3, поэтому заново отправляются только недостающие части. Соединения привязаны к ключу устройства, а не к его IP, так что переключение с Wi-Fi на мобильный интернет посреди передачи их не разрывает.
Что такое Iroh?Это peer-to-peer сетевой стек, на котором построен DashBeam. Он обеспечивает шифрованный транспорт на базе QUIC, контентно-адресуемые блоки для данных файлов, сопряжение устройств, обнаружение через mDNS и ретрансляторы с hole punching для соединения через NAT и файрволы.
What are similar projects?localsend, tincan-cli, ente, EnvoyMesh, bitbang, spacedrive, Arachnidium, ZeroNet
Which topics is it in?resumable, end-to-end-encryption, file-sharing, qr-code, privacy-tools, p2p, tauri, wasm, encryption, agpl, networking, rust
Creator
tonyantony300
Size
73.7 MB
Stars
9.9K
Updated
CommitOct 12Releasev0.7.1Sep 01
Age
1y
Commits · 90 Days