11 releases
Uses old Rust 2015
0.1.1 | Jun 8, 2018 |
---|---|
0.1.0-alpha | Apr 21, 2018 |
0.0.9-alpha | May 18, 2017 |
0.0.6-alpha | Aug 31, 2016 |
0.0.1-prealpha.1 | Jul 31, 2016 |
#7 in #scp
62KB
1.5K
SLoC
🏎🏎🏎 shoop 🏎🏎🏎
SCP for the modern era. If I were better at marketing I might call this "insanely" fast.
security and stability
This is so incredibly alpha. not alpha like how fraternities use it. alpha like unverified.
DO NOT USE THIS FOR SECURITY SENSITIVE MATERIAL.
THIS IS A PREVIEW. As time passes, software gets more secure assuming I keep my unlaziness. Also right now, the protocol isn't stabilized, so you will need to keep the binaries on the server and client at (more or less) the same revision until we leave pre-alpha state.
what's it do
Shoop is a high-speed encrypted file transfer tool reminiscent of scp. It uses SSH to bootstrap authentication and encryption, then uses UDT (a reliable protocol from the 2000s) instead of TCP (a reliable protocol from the 1970s).
It is particularly useful in connections that are "bursty".
From Vietnam, for example, it typically speeds up my downloads by about 2x, if not more for larger files.
install
The server-side and client-side use the same binary (at least for now). Follow these instructions for both sides (at the moment, I'm not distributing binaries until this is more stable). If you're familiar with mosh
, it's a very similar setup.
macOS
- get Command Line Tools for Xcode:
xcode-select --install
, https://developer.apple.com/downloads or Xcode - get rust (easily via rustup
curl https://sh.rustup.rs -sSf | sh
) cargo install shoop
debian (if you're on another linux, you know the difference)
- get build-essentials
sudo apt install build-essentials
- get rust (easily via rustup
curl https://sh.rustup.rs -sSf | sh
) cargo install shoop
windows
yes sorry
server
If you have a firewall, the default port range shoop uses is 55000-55050 (if you want 50 simultaneous connections). In Ubuntu this might look like:
sudo ufw allow 55000:55050/udp
your typical performance example
☁ shoop [master] ⚡ time scp host-in-germany:~/125mb.file .
1.65s user 2.20s system 2% cpu 2:15.39 total
☁ shoop [master] ⚡ time shoop host-in-germany:~/125mb.file
2.39s user 4.53s system 8% cpu 1:18.53 total
why should i use it
- It deals with unreliable/shoddy connections much more gracefully
- It survives network interruptions
but isn't there tool X, Y, and Z already for this?
no, actually, not really.
Dependencies
~9–16MB
~303K SLoC