Overview of the tdrop CLI

The tdrop command-line utility provides the fastest way to upload files, directories (as auto-tarballs), and piped command output directly from your shell. It supports interactive animated progress bars, live transfer speed calculation, QR code rendering inside modern ANSI terminals, and instant clipboard copy.

Installation Options

Choose your preferred package manager or operating system below:

Windows (WinGet)
$ winget install Tagiswild.tdrop
macOS & Linux (Homebrew)
$ brew install tagiswild/tap/tdrop
Node.js / NPM (Cross-Platform)
# Install globally
$ npm install -g tdrop

# Or run directly without installation
$ npx tdrop <file>
Unix Shell Script (Linux / macOS / WSL)
$ curl -fsSL https://tdrop.link/install.sh | bash
Windows PowerShell (Standalone Native Executable)
PS> irm https://tdrop.link/install.ps1 | iex

Command-Line Syntax & Usage

The basic syntax for uploading a file is:

tdrop [options] <file-path>
cat <file> | tdrop [options]

Available Flags & Options

Flag Default Description
-t, --ttl <duration> 24h Retention duration. Valid values are 1h (1 hour), 24h (24 hours), or 7d (7 days).
-n, --filename <name> Basename / stdin.txt Explicit filename to assign to the download (especially useful when streaming piped stdin).
--json false Output machine-readable JSON containing shortcode, URL, filename, and expiry timestamp.
-q, --quiet false Suppress progress bars and banners; prints only the final download URL.
--qr false Render an ANSI ASCII QR code directly in the terminal for rapid mobile scanning.
--no-ad false Suppress sponsor blip text in terminal output.
-v, --version — Print the current CLI version and exit.
-h, --help — Display help and options manual.

Practical Real-World Examples

1. Ephemeral Log Drop with 1-Hour Expiration

Send a quick debug log to a colleague that auto-deletes in 60 minutes:

$ tdrop --ttl 1h debug.log
Uploading [████████████] 100% | 1.4 MB/s
Upload complete
  Scan: Verified Clean (ClamAV)
  Link: https://tdrop.link/k8mP2x1
  TTL:  1 hour (auto-incinerates at 15:42 UTC)

2. Piping Stdin from Commands

Stream command output without creating temporary files on your hard drive:

# Share the last 500 lines of systemd journal
$ journalctl -u nginx -n 500 | tdrop --filename nginx-journal.log

# Share git diff output with a coworker
$ git diff HEAD~1 | tdrop --filename pr-review.patch

3. Scripting with Machine-Readable JSON Output

Integrate tdrop into bash scripts or CI/CD pipelines using --json and jq:

$ DROP_JSON=$(tdrop build.tar.gz --json)
$ DROP_URL=$(echo "$DROP_JSON" | jq -r '.url')
$ echo "Artifact ready at: $DROP_URL"

Troubleshooting & Exit Codes

The CLI returns standard POSIX exit codes to simplify automation:

  • 0: Upload succeeded and verified clean by ClamAV.
  • 1: General network or server connection failure.
  • 2: File size exceeded the 25MB limit.
  • 3: Malicious binary detected by ClamAV antivirus engine (upload rejected).