photodrop-share
v1.0.3
Published
Share photos from your SD card or folder via a secure tunnel. No upload. No cloud. One command, one link.
Maintainers
Readme
PhotoDrop
Share photos from your SD card or folder — no upload, no cloud. One command, one link.
PhotoDrop serves a gallery from your local files over a secure Cloudflare Tunnel. Recipients browse thumbnails, preview full-size, and download originals. Your photos never leave your machine.
Features
- RAW support — CR2, ARW, NEF, DNG, and more. Extracts embedded JPEG previews automatically.
- Secure tunnel — Cloudflare Tunnel creates a public HTTPS link. No port forwarding, no account needed.
- Date filtering — Share only photos from a specific date (e.g. an event day).
- Batch download — Recipients select photos and download as ZIP.
- Zero upload — Files are served directly from your machine. Nothing is copied anywhere.
Quick Start
brew install node cloudflared # one-time setup (macOS)
npx photodrop-share /Volumes/SD # run each timeA public URL prints in terminal. Send it to anyone.
Usage
# Serve all photos in a folder
npx photodrop-share /path/to/photos
# Serve only photos from a specific date
npx photodrop-share /path/to/photos 2026-02-15
# Serve from SD card (macOS)
npx photodrop-share /Volumes/UntitledHow It Works
- Scans your folder (including subdirectories) for image files
- Generates thumbnails and previews into a
.photodropcache folder - Starts a local Express server on port 3000
- Opens a Cloudflare Tunnel for public access (if
cloudflaredis installed) - Prints the shareable URL
Requirements
- Node.js 18+ (
brew install node) - cloudflared for public sharing (
brew install cloudflared) — optional, works on localhost without it
License
MIT — Eric San (https://ericsan.io)
