FeaturesTemplatesShowcaseTownie
AI
BlogDocsPricing
Log inSign up
wolf

wolf

FileDumpThing

Share files with a paste!
Public
Like
10
FileDumpThing
Home
Code
7
backend
2
cli
2
frontend
3
shared
2
.vtignore
README.md
deno.json
Branches
1
Pull requests
Remixes
5
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
cli
/
README.md
Code
/
cli
/
README.md
Search
4/20/2025
Viewing readonly version of main branch: v119
View latest version
README.md

File Dumper CLI

A simple CLI tool for uploading files to the File Dumper service.

Installation

You can install the CLI tool globally using Deno:

deno install -grAf --allow-npm -n=fdt https://esm.town/v/wolf/FileDumpThing/cli/upload.ts

This command:

  • Installs the tool globally (-g)
  • Reloads all dependencies to ensure the latest version (-r)
  • Grants all necessary permissions (-A)
  • Forces overwrite of any existing installation (-f)
  • Names the command fdt (-n=fdt)

After installation, you can use the tool with the fdt command:

cat image.png | fdt image.png

Usage

# Upload a file cat path/to/file.jpg | fdt file.jpg # Upload text echo "Hello World" | fdt note.txt # Upload without copying to clipboard cat image.png | fdt image.png --no-copy # Or use the full Deno command if not installed cat path/to/file.jpg | deno run --allow-net --allow-npm https://esm.town/v/wolf/FileDumpThing/cli/upload.ts file.jpg

The filename argument is optional but helps identify the file in the URL.

Command Line Options

  • --no-copy: Disables automatic copying of the URL to clipboard

Clipboard Support

By default, the CLI automatically copies the generated URL to your clipboard using the same library as the web interface. This works across all platforms without requiring any additional software.

If you don't want the URL to be copied, use the --no-copy flag.

Smart Content Detection

The CLI automatically detects whether the input is text or binary:

  • Text content is uploaded as plain text (with .txt extension)
  • Binary content is uploaded as a file (with .bin extension if no extension is provided)

This detection happens by checking for null bytes in the content.

Examples

# Upload and open in browser cat image.png | fdt image.png | xargs open # Upload without copying to clipboard cat document.pdf | fdt document.pdf --no-copy # Upload text from clipboard (macOS) pbpaste | fdt notes.txt

Alternative: Shell Alias

If you prefer not to install, you can create a shell alias:

# Add to your .bashrc, .zshrc, etc. alias fdt='deno run --allow-net --allow-npm https://esm.town/v/wolf/FileDumpThing/cli/upload.ts'

Then use:

cat image.png | fdt image.png

How It Works

The CLI tool:

  1. Reads content from stdin
  2. Automatically detects if it's text or binary
  3. Uploads it to the API at filedumpthing.val.run
  4. Returns a shareable URL
  5. Automatically copies the URL to your clipboard (unless --no-copy is specified)
FeaturesVersion controlCode intelligenceCLI
Use cases
TeamsAI agentsSlackGTM
ExploreDocsShowcaseTemplatesNewestTrendingAPI examplesNPM packages
PricingNewsletterBlogAboutCareersBrandhi@val.townStatus
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Terms of usePrivacy policyAbuse contact
© 2025 Val Town, Inc.