gfile

Direct file transfer over WebRTC

Github stars Tracking Chart

Build Status
Go Report Card
Codacy Badge
Coverage Status
License: MIT
Mentioned in Awesome Go

GFile

gfile is a WebRTC based file exchange software.

It allows to share a file directly between two computers, without the need of a third party.

ezgif-5-9936f8008e4d

Note

This project is still in its early stage.

How does it work ?

Schema

The STUN server is only used to retrieve informations metadata (how to connect the two clients). The data you transfer with gfile does not transit through it.

More informations here

Usage

Sender

gfile send --file filename
  • Run the command
  • A base64 encoded SDP will appear, send it to the remote client
  • Follow the instructions to send the client's SDP to your process
  • The file transfer should start

Receiver

# SDP being the base64 SDP gotten from the other client
echo "$SDP", gfile receive -o filename
  • Pipe the other client's SDP to gfile
  • A base64 encoded SDP will appear, send it to the remote client
  • The file transfer should start

Benchmark

gfile is able to benchmark the network speed between 2 clients (1 master and 1 slave) with the bench command.
For detailed instructions, see Sender and Receiver instructions.

This feature is still an experiment.

# Run as 'master'
gfile bench -m

# Run as 'slave'
echo "$SDP", gfile bench

Web Interface

A web interface is being developed via WebAssembly. It is currently not working.

Debug

In order to obtain a more verbose output, it is possible to define the logging level via the GFILE_LOG environment variable.

Example: export GFILE_LOG="TRACE"
See function setupLogger in main.go for more information

Contributors

Special thanks to Sean DuBois for his help with pion/webrtc and Yutaka Takeda for his work on pion/sctp

Main metrics

Overview
Name With OwnerAntonito/gfile
Primary LanguageGo
Program languageMakefile (Language Count: 4)
Platform
License:MIT License
所有者活动
Created At2019-03-08 06:02:16
Pushed At2023-02-25 02:39:13
Last Commit At2019-04-12 19:43:35
Release Count3
Last Release Namev0.1.0 (Posted on )
First Release Namev0.0.1 (Posted on 2019-03-09 20:52:08)
用户参与
Stargazers Count754
Watchers Count16
Fork Count50
Commits Count68
Has Issues Enabled
Issues Count7
Issue Open Count4
Pull Requests Count1
Pull Requests Open Count3
Pull Requests Close Count0
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private