为什么值得关注

它本地签署 S3 请求并直接与 R2 通信，无需中间服务器，让您完全掌控数据，操作简单如拖拽。

适合谁使用

经常分享文件的 Mac 用户
熟悉 Cloudflare 和自托管的开发者
希望自建文件分享基础设施以保护隐私的用户

典型使用场景

快速分享大型视频或媒体文件并生成可分享链接
团队成员共同上传和整理文档与媒体文件
个人文件分享，不再依赖第三方服务

项目优势

无需中间服务器——本地签署请求并直接发送至 R2
除 Cloudflare R2 存储和流量费用外无额外成本
仅需一个 Cloudflare API 令牌即可快速开始使用
生成静态分享页面，支持固定/归档操作且不改变 URL

使用前须知

仅支持 macOS（需 macOS 14 或更高版本）
需要拥有 Cloudflare 账户并配置 R2 存储桶
源代码可用许可限制了公开发布和商业用途

README 快速开始

Dropper

Drop a file. Get a link.

Dropper lives in your Mac's menu bar. Drag files onto it and they upload to your own Cloudflare R2 bucket — a share page link lands on your clipboard in seconds. Free, no middleman, your bucket, your domain.

There is no server in the middle: the app signs S3 (SigV4) requests locally and talks directly to R2. Share pages are static HTML the app generates and uploads alongside your files. Onboarding takes a single Cloudflare API token, from which the app derives its S3 credentials.

Website & download: dropper.page

Repository layout

Path	What it is
`Sources/Dropper`	The menu bar app (SwiftPM executable): UI, uploads, share pages, media conversion, onboarding
`Tests/DropperTests`	Unit tests for Dropper's upload, configuration, and share-page behavior
`site/`	Marketing site on Cloudflare Workers — see `site/README.md`
`workers/`	Small native Worker serving `/share/*` directly from R2, outside Next/OpenNext
`Makefile`, `build.conf`, `scripts/`	Local build and the release pipeline (build → sign → notarize → dmg → upload → tag)
`tools/`	Build-time helpers (app icon generator)

Share bundle format

Every share is a self-contained folder in the configured R2 prefix. The folder name is a readable, sanitized version of the first filename followed by a random suffix. A single-file share and a collection use the same format.

For example, a two-file collection might look like this:

share/site/launch-demo-4adcb0b260c14b669777ab8c98f6772e/
├── index.html
├── manifest.json
├── launch-demo.mp4
├── notes.md
├── .thumb.launch-demo.mp4.jpg
├── .poster.launch-demo.mp4.jpg
└── .pinned

The objects have distinct jobs:

Object	Purpose
`index.html`	The generated, static share page and public entry point.
`manifest.json`	The authoritative list, order, display metadata, and ownership record for the share.
``	An uploaded media or document object. Filenames are sanitized and deduplicated within the share.
`.thumb..jpg`	Optional small preview used by the Dropper menu.
`.poster..jpg`	Optional larger video poster used by the generated share page.
`.pinned`	Zero-byte marker indicating that the active share is pinned.
`.archived`	Zero-byte marker indicating that the share is

项目描述

Drop a file on your Mac's menu bar, get a beautiful share page link on your clipboard — served from your own Cloudflare R2 bucket. No middleman, no subscription, your domain.

dropper