shoop

scp has a run-in with mosh (alpha)

Github stars Tracking Chart

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

Main metrics

Overview
Name With Ownermcginty/shoop
Primary LanguageRust
Program languageRust (Language Count: 1)
Platform
License:MIT License
所有者活动
Created At2016-07-29 11:53:27
Pushed At2021-08-26 06:04:32
Last Commit At2019-06-07 22:26:25
Release Count11
Last Release Name0.0.8-alpha (Posted on )
First Release Name0.0.1-prealpha.1 (Posted on )
用户参与
Stargazers Count457
Watchers Count23
Fork Count25
Commits Count210
Has Issues Enabled
Issues Count34
Issue Open Count20
Pull Requests Count4
Pull Requests Open Count1
Pull Requests Close Count3
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private