Welcome to tdrop

tdrop (Terminal Drop) is an ultra-fast, zero-friction, ephemeral file sharing service designed specifically for software engineers, systems administrators, DevOps pipelines, and everyday users. It eliminates the tedious overhead of authentication, email verifications, and permanent storage debt when you simply need to move an archive, log file, build artifact, or image across devices.

Core Philosophy: Zero Storage Debt

Every file sent through tdrop is strictly temporary. Files automatically self-destruct after your chosen retention period (1 hour, 24 hours, or 7 days). We store zero activity logs, require zero accounts, and never track your identity.

Quickstart in 10 Seconds

tdrop works wherever you have a command line or a browser. No configuration files or API keys are required:

Terminal (Node / npx)
# Drop any file directly from your terminal
$ npx tdrop my-file.tar.gz

# Upload with custom 1-hour expiration
$ npx tdrop server.log --ttl 1h

# Pipe raw output directly from another command
$ cat /var/log/nginx/error.log | npx tdrop --filename nginx-error.log
cURL (Native on Linux, macOS & Windows)
# Multipart upload via cURL
$ curl -F "file=@archive.zip" https://tdrop.link/upload

# Raw binary streaming via stdin
$ cat backup.sql | curl -H "X-TDrop-Filename: backup.sql" --data-binary @- https://tdrop.link/upload/raw

High-Level System Architecture

Traditional file upload services buffer the entire file into server memory or local disk before forwarding it to cold object storage. tdrop uses an edge-native streaming pipeline built on Cloudflare Workers and Cloudflare R2:

[Client: CLI / cURL / Web]
         │
         ▼  (TLS 1.3 / HTTP/3 Edge Ingestion)
[Cloudflare Edge Worker (Anycast PoP)]
   ┌─────┴───────────────────────────────────┐
   │ 1. Multipart stream chunking            │
   │ 2. Streaming ClamAV virus scan pipeline │
   │ 3. Generate 7-char Base62 shortcode     │
   └─────┬───────────────────────────────────┘
         ├───────────────────────────────────┐
         ▼                                   ▼
[Cloudflare R2 Object Storage]        [Cloudflare KV Metadata]
  • AES-256 Encrypted at rest           • Shortcode mapping
  • $0 Egress Bandwidth                 • Expiration TTL
  • Direct streaming chunks             • Anonymized telemetry
         │                                   │
         ▼                                   ▼
[Target Receiver / Phone QR Code]     [Auto-Incinerator Purge]

Key Features & Highlights

Feature Specification Benefit
Direct-to-R2 Streaming Zero disk writes, zero RAM buffer Eliminates edge latency; transfers begin streaming immediately.
ClamAV Engine Real-time streaming heuristic inspection Ensures malware, ransomware, and malicious binaries are blocked before distribution.
Auto-Incinerate TTL 1 Hour, 24 Hours, or 7 Days Guaranteed deletion. Compliant with GDPR data minimization principles.
Universal Installation WinGet, Homebrew, NPM, curl, irm Native setup on Windows, macOS, Linux, and FreeBSD.
Resumable HTTP Range RFC 7233 206 Partial Content Supports interrupted downloads and multithreaded accelerators (curl -C -).
QR Code Mobile Share Client-side SVG generation Instant terminal-to-smartphone transfers without typing long URLs.

Next Steps