Uploading Files

Upload Methods

r2Vault supports three ways to upload files to your R2 bucket:

Drag & Drop

Drop files from Finder directly into the browser window

File Picker

Click the + button and choose Upload Files…

Menu Bar Widget

Drop files into the menu bar drop zone for instant upload

Drag-and-Drop from Finder

The fastest way to upload files:

Select files in Finder

Choose one or more files (or an entire folder)

Drag to r2Vault

Drop them anywhere in the browser window. A blue overlay appears when the drop zone is active.

Upload begins

Files are queued and uploaded concurrently with live progress.

Files are uploaded to the current folder shown in the breadcrumb path. Navigate to a folder first to upload files there.

Folder Uploads

Dragging a folder recursively enumerates all files and preserves the folder structure:

Drop: vacation/
  ├── photos/
  │   ├── beach.jpg
  │   └── sunset.png
  └── videos/
      └── drone.mp4

Uploaded as:
  vacation/photos/beach.jpg
  vacation/photos/sunset.png
  vacation/videos/drone.mp4

Source: AppViewModel.swift:360-420 (source: Fiaxe/ViewModels/AppViewModel.swift:360-420)

Upload Files Button

Use the toolbar button for more control:

Click the + button

Opens the upload menu with options:

Upload Files…
Upload Folder…
New Folder…

Choose Upload Files…

Opens the macOS file picker

Select files

Choose one or more files. Press ⌘A to select all, or ⌘-click for multi-select.

Confirm

Click Open to start the upload

The file picker uses security-scoped bookmarks to preserve access to files even after the picker closes, enabling background uploads.

Implementation: AppViewModel.swift:458-469 (source: Fiaxe/ViewModels/AppViewModel.swift:458-469)

Concurrent Uploads with Progress

Uploads run in parallel for maximum speed:

Queue Behavior

Up to multiple files upload simultaneously
Each upload has its own progress bar
Queue updates in real-time as files complete
Failed uploads stay in the queue for review

Progress Display

Main Window
Menu Bar Widget

The browser refreshes automatically when uploads complete, showing newly added files.

Source: MenuBarView.swift:188-221 (source: Fiaxe/Views/MenuBarView.swift:188-221)

Upload Lifecycle

Status	Description
Pending	Queued, waiting for an available slot
Uploading	Active transfer with live progress
Completed	Successfully uploaded to R2
Failed	HTTP error or network issue
Cancelled	User cancelled via Cancel button

Source: UploadTask.swift:23-29 (source: Fiaxe/Models/UploadTask.swift:23-29)

Canceling Uploads

Stop uploads in progress:

Cancel individual files

From the menu bar widget, click the × button next to any uploading file.

Cancel all uploads

Click Cancel All in the menu bar upload progress section.

Cancelled uploads are not retried automatically. Partially uploaded data may remain in R2 until the object is completed or manually deleted.

Cancellation implementation: UploadTask.swift:41-45 (source: Fiaxe/Models/UploadTask.swift:41-45)

Auto-Copy Public URL to Clipboard

When an upload completes successfully:

Upload finishes

File is written to R2 and appears in the browser

URL generated

r2Vault constructs the public URL:

Uses custom domain if configured
Falls back to R2 endpoint: https://<account>.r2.cloudflarestorage.com/<bucket>/<key>

Clipboard copy

URL is automatically copied to the system clipboard

Toast notification

A green toast appears in the menu bar:

✓ Link copied!
photo.jpg

No extra clicks needed — paste the URL immediately into your browser, Slack, or anywhere else!

Source: AppViewModel.swift:559-578 (source: Fiaxe/ViewModels/AppViewModel.swift:559-578)

Custom Domain URLs

If you’ve configured a custom domain in Settings:

- https://abc123.r2.cloudflarestorage.com/my-bucket/photo.jpg
+ https://cdn.example.com/photo.jpg

The custom domain URL is used for:

Clipboard auto-copy
Upload history
“Copy URL” context menu action

Implementation: R2Credentials.swift:36-45 (source: Fiaxe/Models/R2Credentials.swift:36-45)

Upload Service Details

Uploads use the S3-compatible PUT API with AWS Signature Version 4:

Request Details

Method: PUT
Endpoint: https://<account>.r2.cloudflarestorage.com/<bucket>/<key>
Headers:
- Content-Type: MIME type (auto-detected from file extension)
- Content-Length: File size in bytes
- Authorization: AWS4-HMAC-SHA256 signature

Progress Tracking

Uses URLSessionTaskDelegate to receive real-time byte counts:

func urlSession(
    _ session: URLSession,
    task: URLSessionTask,
    didSendBodyData bytesSent: Int64,
    totalBytesSent: Int64,
    totalBytesExpectedToSend: Int64
)

Progress is calculated as totalBytesSent / totalBytesExpectedToSend.

Error Handling

Uploads fail if:

HTTP status code is not 2xx
Network connection is lost
Task is cancelled by user
File permissions prevent reading

Error messages are displayed in the upload queue.

Source: R2UploadService.swift:19-50 (source: Fiaxe/Services/R2UploadService.swift:19-50)

Get Started

User Guide

Features

Uploading Files

Upload Methods

Drag & Drop

File Picker

Menu Bar Widget

Drag-and-Drop from Finder

Folder Uploads

Upload Files Button

Concurrent Uploads with Progress

Queue Behavior

Progress Display

Upload Lifecycle

Canceling Uploads

Auto-Copy Public URL to Clipboard

Custom Domain URLs

Upload Service Details

Next Steps

Menu Bar Widget

Managing Files

Get Started

User Guide

Features

​Upload Methods

Drag & Drop

File Picker

Menu Bar Widget

​Drag-and-Drop from Finder

​Folder Uploads

​Upload Files Button

​Concurrent Uploads with Progress

​Queue Behavior

​Progress Display

​Upload Lifecycle

​Canceling Uploads

​Auto-Copy Public URL to Clipboard

​Custom Domain URLs

​Upload Service Details

​Next Steps

Menu Bar Widget

Managing Files

Upload Methods

Drag-and-Drop from Finder

Folder Uploads

Upload Files Button

Concurrent Uploads with Progress

Queue Behavior

Progress Display

Upload Lifecycle

Canceling Uploads

Auto-Copy Public URL to Clipboard

Custom Domain URLs

Upload Service Details

Next Steps