Elara6331/opensend
Archived
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
This repository has been archived on 2021-07-08. You can view files and clone it, but cannot push or open issues or pull requests.
32 Commits 1 Branch 0 Tags 127 KiB
Go 99%
Makefile 1%
029b16a1a3
Go to file
Arsen Musayelyan 029b16a1a3
All checks were successful
metroline Metroline pipeline status (https://metroline.io).
Details
Add metroline CI
2020-12-29 19:54:22 -08:00
.gitignore Add --skip-mdns to allow full bypassing of zeroconf. This allows operation within iOS 2020-12-04 02:12:32 -08:00
.metroline.yml Add metroline CI 2020-12-29 19:54:22 -08:00
config.go Gofmt all files 2020-12-20 23:18:42 -08:00
deviceDiscovery.go Gofmt all files 2020-12-20 23:18:42 -08:00
fileCrypto.go Gofmt all files 2020-12-20 23:18:42 -08:00
files.go Gofmt all files 2020-12-20 23:18:42 -08:00
go.mod Implement dir type and add Zstd compression 2020-12-05 16:47:04 -08:00
go.sum Implement dir type and add Zstd compression 2020-12-05 16:47:04 -08:00
keyCrypto.go Gofmt all files 2020-12-20 23:18:42 -08:00
keyExchange.go Gofmt all files 2020-12-20 23:18:42 -08:00
logging.go Gofmt all files 2020-12-20 23:18:42 -08:00
main.go Gofmt all files 2020-12-20 23:18:42 -08:00
Makefile Add macOS rule to makefile and add information to readme 2020-12-05 00:19:03 -08:00
README.md Clarify README and add dir type to it 2020-12-05 16:58:19 -08:00

README.md

OpenSend

Send files between systems quickly and securely

Usage

Receiver

  • Use opensend -r to start the receiver

Sender

  • Use opensend -s -t <type> -d <data>
  • type can be
    • url
    • file
    • dir
  • data can be
    • A website URL
    • A file path
    • A directory path
  • Example: opensend -s -t url -d "https://google.com"
  • Example: opensend -s -t file -d ~/file.txt
  • Example: opensend -s -t dir -d /home/user

Building

  • This project uses go modules, so building is easy
  • First, go 1.14+ must be installed (use buster-backports on debian)
  • Then, run make inside the project's directory.
  • This will get the dependencies and compile all the files.

Installing

To install, simply follow the building instructions and then run

  • Linux: sudo make install
  • macOS: sudo make install-macos

Using on iOS

Opensend can run on iOS using the iSH app.

  • Install go using apk add go
  • Clone this repository
  • Run make
  • Use opensend as normal, but skip device discovery
    • Device discovery does not work properly in iSH due to Alpine Linux
    • When running receiver, add --skip-mdns
    • When running sender, add --send-to <IP>
    • This applies bidirectionally
  • Known issues
    • Opensend takes a while to become ready on iOS

Ports to whitelist

  • TCP 9797 for key exchange
  • TCP 9898 for file transfer