qft/README.md

27 lines
1.2 KiB
Markdown
Raw Normal View History

2022-08-13 12:29:47 +02:00
# qft
QFT is a small command line application for Quick Peer-To-Peer UDP file transfer.
## Usage:
- Find a public QFT helper (for example tudbut.de:4277)
- On the sender PC, enter `qft sender <helper> <shared-phrase> <filename>`.
- On the receiver PC, enter `qft receiver <helper> <shared-phrase> <filename>`.
- Both PCs should start transferring after a short while. If they don't, try again.
## Tips 'n Tricks
- You can add a number to the end of both of your commands (after the filename) to
boost transfer speeds (higher = faster), but a too large number might cause unreliability
due to local network conditions or VPNs.
2022-08-14 20:28:03 +02:00
- To use qfts and qftr aliases on linux or mac, run:
```sh
2022-08-15 12:26:07 +02:00
echo 'alias qftr="qft receiver tudbut.de:4277"' >> ~/.(shell)rc
echo 'alias qfts="qft sender tudbut.de:4277"' >> ~/.(shell)rc
2022-08-14 20:28:03 +02:00
```
2022-08-13 12:29:47 +02:00
## Troubleshooting
### It constantly says `CONNECTING`
One of your ends didn't correctly connect to the helper. Stop the transfer on both ends
2022-08-15 12:14:06 +02:00
and try again. If it still doesn't work, make SURE the time and date on both ends are within an
error of <0.1 seconds! Holepunching strongly relies on the time and date matching. (If you have any
suggestion on how I can mitigate this reliance on time, please open an issue!)