Repository navigation
Releases
Releases · itsonu/open-transfer
Open Transfer v3.3.0
Added
- Drop targets: while you drag files, every nearby device shows "Drop to send", and the one under the pointer is announced to screen readers. Dropping onto a device that isn't around says so instead of quietly staging the files.
- Send to several devices with one drop: drop onto any selected device to send to all the selected ones, or onto the new Everyone nearby target (it asks first, like Send).
- Favorites: star a device to keep it first in the list, even while it's away.
- Quick send: a favorite gets a send button that goes straight to the file picker and sends to it, no Send bar step. Alt+1…9 does the same for your first nine favorites.
- Bigger device tiles on tablets (iPad, Galaxy Tab), and the star is always visible on touch screens.
- Preview photos, videos, audio, PDFs and text files without leaving the app: ← and → step through the list, Esc closes. Text is always shown as plain text.
- Thumbnails for videos (their first frame), for photos waiting in the Send bar, on transfer cards and in Recent.
- Gallery view: switch the file list to a grid, show only photos, videos or documents, and sort by date, name or size. Your choice is remembered.
- Quick actions: a ⋯ menu (or right-click) on every file: Preview, Copy text / image / link, Save, Share, Delete, and on the device itself Open and Show in folder. Programs and scripts are only ever shown in their folder, never opened from here.
- Paste to send: paste text anywhere (not in a text box) and it's ready to send as a note; Ctrl/⌘+Shift+V or Send what you copied sends the clipboard (text or a picture).
- Ctrl/⌘+C on a file copies its text, the picture itself, or its link.
- Clipboard sharing between paired devices: a Clipboard panel on each app with Share clipboard, an optional auto-share while the window is open, searchable history (keep 20–200 items for 1 day to "as long as they fit"), and per-device switches. Both devices have to switch it on; anything else is refused. Clips travel signed with the pair's key.
- Privacy checks: text that looks like a password, one-time code, card number, private key or API token asks before it's sent or shared, is never auto-shared, is hidden on screen and is never saved to disk.
- Activity: "Recent" is now Activity: everything this device sent and received, plus clipboard shares, grouped by day, with search and filters by device and direction. The app keeps it (the last 1,000, private to your user), so it survives reloads and restarts. It records file names, sizes, who and how it ended, never what was in them.
- Transfer queue: two sends run at a time; more wait in line, and you can move them up or down or take them out.
- Connection quality: a dot on each nearby app shows how quick the connection is (round trip in ms), and each transfer says which way it goes: Direct, Via another device's app, or Via this device.
- Files already here: when someone sends a file you already have (same name and size), the Accept prompt says so and lets you keep both, skip it or replace yours.
- Every file is checked: apps compare a SHA-256 checksum of what was sent with what was written. A file that arrives damaged is removed and the sender is told to retry.
- Notifications: turn them on with the bell, and you'll get a system notification while the window is in the background when someone wants to send you files, a transfer finishes or fails, or a clipboard arrives.
- Keyboard shortcuts:
Ctrl/⌘+Ochoose files,Ctrl/⌘+Entersend,/search,Escclear what's waiting to be sent, and?lists them all.
Fixed
- Two "Are you sure?" questions in a row could get the first one's answer (Cancel), or both get the second one's.
- Accepting with "skip the ones I have" could, for a moment, look to the sender like an ordinary accept; the receiver now settles which files it keeps before it says yes, and a sender with nobody left to send to asks once more before giving up.
Open Transfer v3.2.5
Added
- Every release has a
SHA256SUMSfile, so you can check a download is exactly what was built (see the README). - A command-line build for Intel Macs (
open-transfer-macos-x64-cli.tar.gz), as there already was for Apple silicon. - Homebrew:
brew install --cask itsonu/tap/open-transfer(desktop app) orbrew install itsonu/tap/open-transfer(command line).
Fixed
- Windows: opening the app while it was already running could bring its window forward twice.
Open Transfer v3.2.4
Fixed
- Resuming a transfer that was paused just as its last pieces arrived uploaded the whole file again, even though it had already been delivered (the progress restarted from 0 next to "Delivered"). The device now remembers files it has finished, so a resumed upload sees it is done; and if every piece is there but unconfirmed, only the last one is sent again. Same for big uploads to your own device, which could otherwise save a second copy (#44).
Open Transfer v3.2.3
Added
- Demo video at the top of the README: a 20-second recording of the real app (a Mac sends two files to a Pixel phone and a Galaxy tablet; the phone taps Accept). The README shows a silent loop that plays inline and links to the full video with sound on the website.
scripts/demo/build.pyrecords it again after UI changes.
Fixed
- Sending a file over 4 MB from one app to another failed with "Invalid upload" (since 3.2.0): the receiving device rejected the name of its own chunk store. Big files now arrive in chunks as intended.
- The sender's Recent list said "Received" for files sent to nearby devices, and showed a nonsense speed (e.g. "0.0169 bytes/s") because it mixed two clocks. It now says "Sent" with the real average speed.
- A device reached through a port forward (
adb forward,ssh -L) could lose its real address: its hello arrives from 127.0.0.1, which replaced the address you added, so sending to it failed with "Lost connection" (since 3.0.0). A hello from loopback no longer replaces a real address.
Open Transfer v3.2.2
Fixed
- A device that quit could show as nearby again for up to 15 seconds: a hello still on its way (or the discovery loop's last announcement) could land after its goodbye. Quitting now finishes those first and says goodbye last, refuses new hellos while stopping, and others ignore a hello answer that started before the goodbye.
Open Transfer v3.2.1
Changed
- New app icon ("Beam"): a continuous-corner squircle in a cyan → blue → indigo gradient with faint discovery rings and staggered send/receive arrows, the same on the web app, website, Windows, macOS and Android. Android's launcher icon was a paper plane; it now matches, with an adaptive gradient background, the arrows as foreground and themed (monochrome) icon.
scripts/brand_icon.pydraws it in code and writes every icon asset.
Fixed
- Releases no longer attach the Docker build record (
*.dockerbuild) as a download; only the app, package and APK builds are published. - The Android app reported version 3.0.0 (versionCode 300) since 3.0.0; it now carries the release version.
Open Transfer v3.2.0
Added
- Chunked transfers: files over ~4 MB are split into 2 MiB
Content-Rangepieces (3 in flight, any order, idempotent rewrites) on every leg — browser to app (POST /api/files,PUT /api/send/<job>/files/<n>) and app to app (PUT /api/p2p/v1/offers/<id>/files/<n>) — withGET …/statusendpoints reporting staged ranges, so a dropped connection loses pieces, not the file. - Pause / Resume for chunked uploads (shared-folder and device sends), surviving page reloads via the stored upload id.
- Folder sending: drop or pick a folder and it is zipped in the browser (structure kept as paths, no dependency, offline) then sent through the normal pipeline.
- Recent transfers with per-transfer speed graphs (inline SVG sparklines, live during upload, kept for the last 30 in the browser).
- Single-use guest links (
POST /api/invites,/?invite=…): one visitor past the PIN as a trusted guest, expiring after 10 minutes. GET /api/infolimits now advertisechunk_sizeandchunk_threshold.
Open Transfer v3.1.0
Added
- Retry after decline: declined/failed/expired transfers show a Retry button (per job and per device) backed by
POST /api/send/<job>/retry, so the receiver gets a fresh Accept? prompt. - Share text: the send bar has a Text button that sends typed text as a
.txtfile; received text files get a Copy button.
Fixed
/api/infono longer leaks the PIN to authenticated visitors (owner-only); proxy-spoofed owner bypass closed when--behind-proxyis used.- P2P client no longer throws
UnboundLocalErroron connection errors;ACCEPTED/RECEIVINGsessions expire instead of leaking; visitor/incoming/signal stores are bounded. - Windows: long deduped Unicode names no longer fail deletes (
\\?\extended paths); owner-only 403s drain the request body (no more connection resets). - Web UI: API timeouts, safe WebRTC message parsing, receiver-side direct-transfer size caps, upload timeouts, QR encoding, dialog focus handling.
Open Transfer v3.0.0
Open Transfer becomes AirDrop-like across platforms: every device runs the app, devices find each other, and files go directly to the devices you pick instead of into one shared folder.
Added
- Nearby devices: automatic discovery on the LAN (UDP multicast
239.255.77.77:47823plus HTTP hellos), live presence, device name/type/platform, rename this device. - Targeted sending: one, several or all devices; recipients shown before sending; confirmation before sending to everyone (or 3+ devices); drop files onto a device to send to it.
- Accept / Decline prompts on the receiver with sender and file list; offers expire after 2 minutes; disk space and size limits checked up front.
- One-to-many streaming: one upload is streamed to every accepting receiver at once, with per-receiver progress, cancel, retry and "send now"; a slow or vanished receiver is dropped without stopping the others.
- Pairing with a QR code or 6-digit code (HMAC challenge–response, rate-limited, rotating codes); paired devices auto-accept; requests between them are signed;
--paired-only; unpair. - Browsers without the app join a device's group by link/QR code, get their own "Sent to you" inbox, and can send to any device. Browser → browser transfers go direct over WebRTC (the apps only pass on the connection messages), falling back to the apps when a direct connection isn't possible; files up to 1 GB.
- Desktop apps with a native window (pywebview):
open-transfer-windows-x64.exe, and.appbundles inopen-transfer-macos-arm64.dmg/open-transfer-macos-x64.dmg; single instance per folder; smoke-tested in CI. - Android app (phones and tablets, Android 10+, 64-bit) built with Chaquopy around the same Python code: WebView UI, native file picker, QR scanner, notifications for incoming files, saves to
Download/Open Transfer; built and smoke-tested with a real transfer in an emulator in CI. - Real-device check
scripts/device_check.py: installs the APK over adb and drives the real apps on a computer, phones and tablets through the device checklist (discovery, pairing both ways, every transfer direction byte for byte, one/many/everyone, decline/expiry/cancel), writing a ✅/❌ report. - CLI flags
--name,--form,--peer,--no-discovery,--auto-accept,--paired-only,--share-folder; docs: protocol, updated architecture and API.
Changed
- Default mode is now device-to-device. Browsers that open a device's link no longer see its folder; use
--share-folderfor the classic shared-folder behaviour (the Docker image keeps it on by default, plus--auto-accept). - Requests from the device itself (
127.0.0.1) are its owner: no PIN needed, sees received files and the Accept prompts. - The front end is split into ES modules (
lib.js,nearby.js,app.js); still no build step. - The macOS command-line build is now
open-transfer-macos-arm64-cli.tar.gz; Windows also shipsopen-transfer-windows-x64-cli.exe. - The Docker image runs on Python 3.14 (
python:3.14-slim, was 3.13). - GitHub release notes are now this changelog section (
scripts/release_notes.py); a release fails if the section is missing or undated. - CI and release workflows use the current major versions of their GitHub Actions (Node 24 runtime).
- README and website footers credit the maintainer with a link to their portfolio.
Fixed
- Windows: deleting a file right after it was downloaded or previewed failed with a server error while the file was still open; it now waits a moment, or says the file is in use.
- Package
ChangelogURL pointed at amainbranch that doesn't exist; it now usesmaster.
Known limitations
- Transfers between devices are plain HTTP on the LAN (not encrypted).
- Browser → app transfers still pass through the app the browser joined; no folder transfers; no resume.
- Apps are not code-signed/notarised; the Android APK is signed with a debug key unless release secrets are configured.
Open Transfer v2.0.0
What's Changed
- Open Transfer 2.0: AirDrop-style LAN file sharing — redesigned, secured, tested, self-hostable by @itsonu in #1
- Standalone app, project website on GitHub Pages, and repo rename to open-transfer by @itsonu in #8
- docs: fix Changelog URL branch and credit maintainer by @itsonu in #9
- Release workflow: release via "Run workflow" with a tag input by @itsonu in #10
New Contributors
Full Changelog: https://github.com/itsonu/open-transfer/commits/v2.0.0