Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iamd3vil/torshare
Share files between computers securely over Tor
https://github.com/iamd3vil/torshare
Last synced: 9 days ago
JSON representation
Share files between computers securely over Tor
- Host: GitHub
- URL: https://github.com/iamd3vil/torshare
- Owner: iamd3vil
- License: gpl-3.0
- Created: 2019-11-27T10:08:57.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-01-07T09:36:15.000Z (almost 5 years ago)
- Last Synced: 2024-06-20T10:09:37.339Z (5 months ago)
- Language: Go
- Size: 39.1 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TorShare :rocket: :zap:
TorShare enables file sharing between two parties over Tor.
### Design
TorShare needs a relay server which just relays information between two parties. The relay server can't see the data being relayed since the data is encrypted using a shared key agreed between two parties. Also the relay server will be another onion service.
The sender starts a Tor hidden service for the file which needs to be transmitted and the address is sent to the receiver using the relay server. The hidden node address and the file name to be received is encrypted using a password agreed between both sender and receiver.
When the sender starts the hidden node and sends the info the relay, the relay will return a channel name of 6 word phrases. The receiver needs to know both the password and the channel name to receive the file.
The relay shouldn't be able to figure out anything related to the transfer. Since the file transfer is also done over the Tor network, the transfer is encrypted as well.
Once the transfer is completed, the receiver will send a message directly to sender and sender will teardown the Tor hidden service.
### Installation
Latest version of Tor has to be installed before running the binary.
For ubuntu, instead of installing ubuntu's repos, see [here](https://2019.www.torproject.org/docs/debian.html.en) and use Option two in that page to get the latest version of Tor.
Precompiled binaries can be downloaded from [here](https://github.com/iamd3vil/torshare/releases).
### Usage
```bash
$ torshare -h
Usage of ./dist/torshare.bin:
-file string
File Path
-relay string
Relay Address (default "http://torwg7vip577vofy2rqtervn7r42f6rh5ptsijmyhkmepr4e6vrddsid.onion")
```
#### Sending a file
```bash
$ torshare -file sample.jpeg
Enter Password: **********
2019/12/07 23:18:22 Channel Name(Has to be communicated with Receiver): luckily-slogan-twitter-haunt-joystick-earwig
```
Channel name and password has to be shared with the receiver
#### Receiving a file
```bash
$ torshare
Enter channel name: luckily-slogan-twitter-haunt-joystick-earwig
Enter Password: **********
2019/12/08 14:19:07 Starting download for Burton Stein - The New Cambridge History of India_ Vijayanagara-Cambridge University Press (1990).pdf
757.84 KiB / 9.04 MiB [===============>-----------------------------------] 8.19% 86.77 KiB/s 01m37s
```