Skip to content
maxomatic458Public

About

peer-to-peer file sharing webapp and cli tool

Topics

Resources

Stars

20 stars

Watchers

1 watching

Forks

Repository files navigation

fsend

fsend is a peer-to-peer file transfer webapp and CLI tool.

Note

fsend-site (the webapp) uses WebRTC for the connection, without a fallback relay. So depending on your network/browser, it may not work. fsend-cli makes use of iroh which provides a fallback relay by default.

Features

  • P2P File Transfer: Directly send files between devices. The relay server only introduces the two peers - file data never passes through it.
  • Web and CLI Interface: fsend is available as a web application and a command-line tool, and the two interoperate.
  • Resumable Transfers: If the connection is lost, the transfer can be resumed from where it left off (see the browser support table below).
  • Files and Folders: Send individual files and whole folders.

Browser support

The webapp needs WebRTC, which every current browser has. What differs is where received files are written and if transfers can be resumed.

Save mode Browsers Size limit Resume
Save to folder (File System Access API) Chromium (Chrome, Edge, Opera) free disk space yes
Save to browser storage (origin private file system) Firefox, Safari the browser's storage quota, which depends on the browser yes
Download as zip all free RAM no

Installation

Debian and Ubuntu (apt)

sudo apt update && sudo apt install -y ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://apt.fsend.sh/key.asc | sudo tee /etc/apt/keyrings/fsend.asc >/dev/null

echo "deb [signed-by=/etc/apt/keyrings/fsend.asc] https://apt.fsend.sh stable main" \
  | sudo tee /etc/apt/sources.list.d/fsend.list

sudo apt update && sudo apt install fsend

Prebuilt binaries

You can download the prebuilt binaries for various platforms here.

From source via cargo

cargo install fsend-cli

Usage

Webapp

  1. Open fsend in your browser.
  2. Either send or receive file(s)
    • As a sender:
      1. Drag and Drop or select the file(s)/folder(s) you want to send.
      2. Share the generated code, the link, or the QR code with the receiver.
    • As a receiver:
      1. Enter the code or open the link provided by the sender.
      2. Choose how to save the files: depending on your browser, either directly to disk, in browser storage, or as a zip download.
      3. Accept the offer and the file(s)/folder(s) will start downloading.

Both tabs have to stay open during the transfer.

CLI

Sending files

$ fsend send <file_path>
Code: K7Q29XMV4P

On the other peer, run:

  fsend receive K7Q29XMV4P

or open in a browser:

  https://fsend.sh/receive#K7Q29XMV4P

Receiving files

$ fsend receive K7Q29XMV4P

Licenses

About

peer-to-peer file sharing webapp and cli tool

Topics

Resources

Stars

20 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages