simple-file-transfer 0.1.1

A simple file transfer service for temporary file sharing

Simple File Transfer (SFT)

A simple, temporary file transfer service for sharing files between machines.

Installation

pip install simple-file-transfer

Quick Start

Server Setup (Digital Ocean)

doctl compute droplet create sfts-droplet \
  --region fra1 \
  --size s-1vcpu-1gb \
  --image ubuntu-22-04-x64 \
  --ssh-keys <your-ssh-key-id> \
  --user-data '#cloud-config
runcmd:
  - apt-get update
  - apt-get install -y python3-pip
  - pip3 install simple-file-transfer
  - sfts serve --port 12345 &
' \
  --wait

Or run manually:

pip install simple-file-transfer
sft serve --port 12345

Upload a File (Machine A)

export SFT_SERVICE=my-server.digitalocean.com:12345
sft upload ./my-file.tgz 1h

Output:

Uploaded my-file.tgz 5GB sha256:...
The file will be deleted in 1h (2025-01-01 00:01:00)
To download your file, enter: sft download 763298

Download a File (Machine B)

export SFT_SERVICE=my-server.digitalocean.com:12345
sft download 763298

Output:

File downloaded my-file.tgz 5GB sha256:...
The file will be deleted in 55min (2025-01-01 00:01:00)

Configuration

Set the server address using the SFT_SERVICE environment variable:

export SFT_SERVICE=your-server.com:12345

Or use the --service flag:

sft upload --service your-server.com:12345 ./file.txt 1h

Time Formats

Supported time formats for expiry:

• 1h - 1 hour
• 30m - 30 minutes
• 2d - 2 days
• 1w - 1 week

Docker Deployment

docker build -t sft-server .
docker run -p 12345:12345 -v /data/sft:/data sft-server

Features

• Simple CLI interface
• Automatic file expiry
• SHA256 checksums for integrity
• Minimal dependencies
• Easy deployment