⚡ Lightning-fast file sharing via Cloudflare R2
Upload any file and get instant shareable links. Supports images, videos, documents, and more.
- ⚡ Lightning Fast - Upload files instantly using rclone
- 📁 Any File Type - Images, videos, PDFs, archives, documents
- 🔗 Instant Links - Get public URLs immediately after upload
- 📋 Smart Output - Markdown, HTML, and embed codes auto-generated
- 🎨 Beautiful CLI - Colorful output with progress indicators
- 🔒 Secure - Credentials stored with 600 permissions
- 📱 Cross-Platform - macOS and Linux support
- 🚀 Multiple Aliases - Use
quick-share,qshare, orshare
npm install -g quick-share-cliyarn global add quick-share-clibrew tap jack/quick-share
brew install quick-share-cliYou'll need rclone installed:
# macOS
brew install rclone
# Linux
curl https://rclone.org/install.sh | sudo bash
# Windows (via WSL)
winget install Rclone.RcloneRun the setup wizard to configure your Cloudflare R2 credentials:
quick-share setupYou'll need:
- Cloudflare Account ID
- R2 Access Key ID
- R2 Secret Access Key
- Bucket Name
- Public URL (e.g.,
https://pub-xxxxx.r2.dev)
Get credentials: Go to Cloudflare Dashboard → R2 → Manage R2 API Tokens
# Upload any file
quick-share photo.png
quick-share document.pdf
quick-share video.mp4
# Or use shortcuts
qshare archive.zip
share presentation.pptxquick-share <file>quick-share upload myfile.pdf --config ./custom-config.jsonquick-share config$ quick-share screenshot.png
Uploading screenshot.png...
✓ Upload complete!
URL: https://pub-xxxxx.r2.dev/screenshot.png
Size: 245 KB
Type: image/png
Markdown: 
HTML: <img src="https://pub-xxxxx.r2.dev/screenshot.png" alt="file">
✓ URL copied to clipboard$ quick-share demo.mp4
Uploading demo.mp4...
✓ Upload complete!
URL: https://pub-xxxxx.r2.dev/demo.mp4
Size: 15.2 MB
Type: video/mp4
Video: <video controls><source src="https://pub-xxxxx.r2.dev/demo.mp4" type="video/mp4"></video>
✓ URL copied to clipboard$ quick-share report.pdf
Uploading report.pdf...
✓ Upload complete!
URL: https://pub-xxxxx.r2.dev/report.pdf
Size: 2.4 MB
Type: application/pdf
✓ URL copied to clipboardConfiguration is stored securely in ~/.quick-share/config.json with 600 permissions.
{
"accountId": "your-account-id",
"accessKeyId": "your-access-key-id",
"secretAccessKey": "your-secret-access-key",
"bucketName": "my-bucket",
"publicUrl": "https://pub-xxxxx.r2.dev",
"endpoint": "https://your-account-id.r2.cloudflarestorage.com"
}You can maintain multiple configuration files for different projects:
# Personal bucket
quick-share upload photo.jpg --config ~/.quick-share/personal.json
# Work bucket
quick-share upload report.pdf --config ~/.quick-share/work.jsonSee examples/ for more configuration examples.
| Category | Types |
|---|---|
| Images | JPG, PNG, GIF, WebP, SVG |
| Videos | MP4, MOV, WebM |
| Audio | MP3, WAV, OGG |
| Documents | PDF, TXT, JSON, DOC, DOCX, XLS, XLSX |
| Archives | ZIP, TAR, GZ |
| Other | Any file type supported! |
# Clone the repository
git clone https://github.com/jack/quick-share-cli.git
cd quick-share-cli
# Install dependencies
npm install
# Run tests
npm test
# Run linting
npm run lintSee CONTRIBUTING.md for more details.
See CHANGELOG.md for version history.
Contributions are welcome! Please read our Contributing Guidelines before submitting PRs.
MIT © Jack
- Cloudflare R2 - Object storage
- rclone - rsync for cloud storage
- Commander.js - CLI framework
Made with ⚡ by Jack