A clean room rebuild of the Droplr menu bar app for macOS 15 and later. It uploads to your own S3 compatible storage (Cloudflare R2, AWS S3, Backblaze B2, MinIO) instead of Droplr's service.
See the project site at 1stevengrant.github.io/dropshot for features, hotkeys and setup.
The behaviour was derived from Droplr 5.9.19 using REA with the Ghidra provider. The findings are in re/SPEC.md. No Droplr code, assets or keys are included.
xcodegen generate
xcodebuild -project Dropshot.xcodeproj -scheme Dropshot -derivedDataPath build build
open build/Build/Products/Debug/Dropshot.appRun the tests with the same command, replacing build at the end with test.
On first launch the Settings window opens. Under Storage, enter the endpoint, bucket, access key and secret, plus the public base URL that serves the bucket (for R2, a custom domain or the r2.dev URL). Use Test Upload to confirm the object is publicly readable. macOS asks for Screen Recording permission on the first capture.
| Feature | Default hotkey |
|---|---|
| Upload clipboard (files, images, text, or a URL to shorten) | ⌥D |
| Screenshot (drag a region, or press Space to pick a window) | ⌥⇧4 |
| Screenshot and annotate | ⌥⇧3 |
| Record video (MOV) | ⌥⇧5 |
| Record GIF | ⌥⇧2 |
| Record with camera | none (set one in Settings) |
| Upload file | ⌥⇧6 |
| New note | ⌥⇧N |
| Finish recording | ⇧⌘D |
| Pause or resume recording (while recording) | ⌥⇧7 |
| Mute or unmute the microphone (while recording) | ⌥M |
| Cancel and delete the recording (while recording) | Esc |
Screenshots use the system screencapture tool, so selection is the native macOS one. Recordings use ScreenCaptureKit: drag to record an area, click or press Space to record a window, press Return for the whole screen, or Esc to cancel. A countdown (3 seconds by default, set under Settings › Capture) runs before recording starts. While recording, a control bar next to the area has stop, pause, mute and delete buttons. It never appears in the video. The Dropshot menu offers the same controls. System audio and the microphone are recorded separately, then mixed into one audio track when the recording finishes, because browsers only play a movie's first audio track. Paused time is cut from the movie. GIFs record without sound.
Record with Camera (in the menu, or dropshot://record?camera=1) adds a round, mirrored camera bubble in the bottom left corner of the recorded area. The bubble is part of the video and can be dragged while you record. Choose the camera and the bubble size (small, medium or large) under Settings › Capture.
With Automatically upload macOS screenshots turned on (Settings › Capture), screenshots and recordings you take with ⌘⇧3, ⌘⇧4 or ⌘⇧5 upload as soon as macOS saves them. The originals are left where they are.
You can also drop files or text on the menu bar icon, or use Upload with Dropshot in the Finder Services menu. Folders and multiple files are zipped. The link is copied to the clipboard as soon as an upload starts. Anyone who opens it before the upload finishes sees a Still uploading page that refreshes until the drop is ready. Turn off instant links under General to copy the link only once the upload is done. The menu lists recent drops, each with copy link, Markdown and HTML formats, and a Manage item that opens the drop's management page.
Under General › Drops you choose the privacy (public, password or private), self destruct time and download permission for new drops. They are sent as object metadata and applied by the Worker when it registers the drop. Passwords are hashed on the Mac (the plaintext stays in your Keychain), and a password drop without a valid hash is registered as private.
The annotation editor has arrow, line, rectangle, filled rectangle, ellipse, pen, highlighter, text, pixelate, step number and emoji stamp tools, with undo and redo. You can upload, copy or save the result.
Automation URLs: dropshot://screenshot, annotate, record (add ?camera=1 for the camera bubble), gif, stop, pause, mute, clipboard, note, and upload?path=/absolute/file.
extension/ captures the tab you're looking at, including anything that needs you to be signed in, and uploads it as a drop. A full page capture scrolls one screen at a time and stitches the result, like GoFullPage. Pages that scroll inside a panel (mail, docs, dashboards) capture that panel, and very long pages are saved as JPEG once they pass WebP's height limit.
cd extension
npm install
npm run buildOpen chrome://extensions, turn on Developer mode, choose Load unpacked and pick extension/dist. Sign in once at https://d.ghijk.nz/app, because the extension uploads with that Cloudflare Access session. Then click the Dropshot icon or press ⌥⇧D for the full page. To capture part of it, press ⌥⇧S or right click and choose Capture area with Dropshot: click an element (even one taller than the screen), or drag a rectangle. The arrow keys move the outline to the parent or child element, Enter captures it and Esc cancels. Either way the link is copied and the drop opens in a new tab. If the session has expired, the icon shows ! and the sign in page opens; capture again afterwards. After rebuilding, reload the extension on chrome://extensions.
Droplr features left out of this version: per app plugins.