Skip to content

mcginty/shoop

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

🏎🏎🏎 shoop 🏎🏎🏎 Build Status

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

  1. get Command Line Tools for Xcode: xcode-select --install, https://developer.apple.com/downloads or Xcode
  2. get rust (easily via rustup curl https://sh.rustup.rs -sSf | sh)
  3. cargo install shoop

debian (if you're on another linux, you know the difference)

  1. get build-essentials sudo apt install build-essentials
  2. get rust (easily via rustup curl https://sh.rustup.rs -sSf | sh)
  3. cargo install shoop

windows

  1. 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.