Skip to main content
The File Browser is the core interface of r2Vault, providing a native macOS experience for browsing, organizing, and managing files in your Cloudflare R2 bucket.

Finder-Style Interface

r2Vault’s browser is designed to feel like a natural extension of macOS Finder, with familiar navigation patterns and visual design.

Path Bar Navigation

Breadcrumb-style path bar shows your current location in the bucket hierarchy

View Modes

Switch between Icons and List views to match your workflow

Multi-Select

Select multiple files and folders for batch operations

Quick Actions

Context menus and keyboard shortcuts for fast file management

View Modes

Switch between two view modes to match your workflow:

Icons View

Grid layout with large file thumbnails, perfect for visual browsing of images and media files.
BrowserView.swift:154-192
The icons view uses a lazy grid with adaptive columns that automatically adjust based on window size.

List View

Compact list layout with sortable columns (Name, Kind, Size, Date Modified), ideal for browsing large folders.
BrowserView.swift:196-218
The path bar at the top of the browser shows your current location and allows instant navigation to any parent folder.
BrowserView.swift:82-112
Click any folder name in the path bar to instantly jump to that location in your bucket.

Search and Filtering

The search bar in the toolbar provides real-time filtering of files and folders by name.
BrowserView.swift:40
Filtering logic is implemented in the view model:
AppViewModel.swift:100-131

Quick Look Integration

Double-click any file to instantly preview it using macOS Quick Look. No download required - files stream directly from R2 via presigned URLs.
QuickLookCoordinator.swift:27-45
Quick Look supports images, PDFs, videos, audio, documents, and most common file formats - all streaming directly from R2 without downloading to disk.

Drag and Drop Upload

Drag files or folders from Finder directly into the browser window to upload them to the current folder.
BrowserView.swift:27-32
When files are dropped, the view model handles both individual files and folders recursively:
AppViewModel.swift:359-420
When you drag a folder, r2Vault preserves the complete folder structure in R2, including all subfolders and their contents.

Keyboard Shortcuts

  • ⌘N - New folder
  • ⌘O - Upload files
  • Delete - Delete selected items
  • ⌘R - Refresh current folder
  • ⌘A - Select all
  • ⌘D - Deselect all
  • Click - Single selection
  • ⌘Click - Add to selection

Context Menus

Right-click any file or folder to access quick actions:
BrowserView.swift:353-381
Deleting a folder will recursively delete all files and subfolders inside it. This action cannot be undone.

Toolbar

The browser toolbar provides quick access to common actions:
1

Back/Forward Buttons

Navigate through your browsing history
2

View Mode Toggle

Switch between Icons and List view
3

Upload Menu

Upload files, upload folder, or create new folder
4

Refresh Button

Reload the current folder contents
5

Sort Menu

Sort by Name, Size, Date, or Kind
6

Selection Menu

Select all, deselect, or delete selected items

Status Bar

The status bar at the bottom shows the current selection state:
BrowserView.swift:322-349
The status bar only appears when there are items in the current folder or when items are selected.

Upload System

Learn about concurrent uploads and progress tracking

Menu Bar Widget

Quick uploads from anywhere on your Mac