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:
$ winget install Tagiswild.tdrop
$ brew install tagiswild/tap/tdrop
# Install globally
$ npm install -g tdrop
# Or run directly without installation
$ npx tdrop <file>
$ curl -fsSL https://tdrop.link/install.sh | bash
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).