Skip to content

conorjwryan/ShareMaster

Repository files navigation

ShareMaster

ShareMaster is a macOS menu bar utility (and iOS app) for uploading files to S3-compatible storage (Cloudflare R2, AWS S3, etc) and getting a sharable link in one motion.

Features

  • Upload files via ShareMaster and receive sharable links (public or presigned) in one motion
  • Multiple accounts and destinations with different bucket/prefix combinations
  • Customisable naming templates for renaming files automatically on upload using variables ({filename}, {uuid}, {date}, {time}, and more)
  • Multipart uploads and concurrent ranged downloads with configurable parallelism
  • Optional upload/download bandwidth caps, set per account with per-destination overrides
  • Browse your buckets by folder (with breadcrumbs, sorting, and create-folder), or see recent uploads merged across every destination
  • Quick Look preview, copy link, download, and delete
  • Per-destination download folders
  • Credentials stored in the Keychain and synced through iCloud (keeping your credentials secure and accessible across all your devices)
  • Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible storage providers.

MacOS

  • Drag & drop onto the menu bar icon — the popover opens mid-drag so you can drop straight onto a destination
  • Browse a destination's files/folders right in the popover
  • Lightweight footprint — the popover loads on demand and releases memory when idle so it's not using up resources when you're not using it

iOS

The iOS app has the same features as the MacOS app, where opening the app allows you to view destinations and download files, but main focus of the iOS app is being unobtrusive to your workflow by allowing you to upload files through the Share Sheet and quickly get a link to said file.

Documentation

Developer documentation — architecture, the transfer engine, cross-device sync, platform-specific behaviour, and build/contribution notes — lives in docs/.

Note on Installation

I don't have the money right now to spare for an Apple Developer Subscription :(

This means for you to run either the MacOS or iOS apps you're going to have to download and compile this yourself.

You'll probably get a bunch of notisation / security errors as a result.

I'd love to be able to release this and move towards development full time so if you like what I've done here (or any of my other projects) please consider sponsoring me on Ko-Fi.

Setup

While these setup instructions are for the MacOS app, the same process applies for the iOS app.

The good news is that once you have them set up on one system through iCloud sync they'll be available on all your devices.

MacOS Setup

  1. Click the ShareMaster icon in the menu bar
  2. Click the gear icon to open Settings
  3. Add an Account (credentials): Access Key ID, Secret Access Key, Region (auto for Cloudflare R2), and an S3 endpoint for non-AWS services
  4. Add a Destination: pick the account, set the bucket, optional path prefix, naming template, and link mode (public or presigned)

Requirements

  • macOS 14.0 (Sonoma) or later
  • iOS/iPadOS 17.0 or later

Acknowledgements

ShareMaster is developed by Conor Ryan, built on the foundation of BucketDrop by Fayaz Ahmed.

About

ShareMaster is a tiny, open-source menu bar app for uploading files to your own S3-compatible storage. No dashboards. No syncing folders. No vendor lock-in. Just drop a file and get a shareable URL instantly.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Sponsor this project

Contributors

Languages