Interface Layout

Once connected, the main window is divided into five areas:

• Toolbar (top) — Upload, Download, New Folder, Presigned URL, View toggle, Sort, Search, and Settings.
• Sidebar (left) — Expandable bucket list with lazy-loaded folder tree.
• Breadcrumb bar (top of main area) — Shows the current path. Click any segment to jump up.
• File panel (center) — List or grid view of the current folder's contents.
• Status bar (bottom) — Object count, total size, and selected-items summary.
• Transfer queue (bottom-right button) — Collapsible panel showing upload/download progress.

Profile Management

Profiles let you save credentials for multiple Spaces regions or S3 accounts.

• Create — From the Connection screen, fill in the profile form and click Save Profile.
• Edit — Click the pencil icon next to a saved profile. Change any field and save.
• Delete — Click the trash icon. The profile and its encrypted secret are permanently removed.
• Switch — Click Disconnect in the toolbar, then connect with a different profile.

Navigation

Buckets and folders are displayed in the left sidebar. Click a bucket to open it. Click a folder row to select it, or double-click to enter it.

• Breadcrumbs — click any segment of the path to jump up.
• Back / Forward — toolbar arrows (or Cmd ← / Cmd →) navigate your history.
• Up — toolbar up-arrow (or Cmd ↑) moves one level up.
• Sidebar tree — expand folders with the chevron to drill down without leaving the current view.

File Views

Toggle between List and Grid view using the icons in the toolbar.

• List view — shows Name, Size, Modified date, Storage class, and an Actions column. Click column headers to sort.
• Grid view — shows thumbnail previews for images; generic icons for other types.

Sort by Name, Size, or Last Modified in ascending or descending order using the sort dropdown in the toolbar.

Uploading Files

There are three ways to upload:

1. Toolbar button — Click the Upload button (Cmd U). A file picker opens; select one or more files.
2. Drag & drop — Drag files from Explorer/Finder directly onto the file panel. A highlighted border appears when the drag enters the drop zone.
3. Context menu — Right-click an empty area in the file panel (feature depends on OS file association support).

Large files are handled automatically. Progress is tracked in the Transfer Queue.

Downloading Files

1. Select one or more files (click to select, Ctrl/Cmd click to multi-select, Shift click for range).
2. Click the Download toolbar button (Cmd D).
3. A folder picker appears. Choose the destination folder on your computer.
4. Downloads run in the background — check the Transfer Queue for progress.

File Operations

Rename

Select a file or folder, then press F2 or right-click → Rename. Type the new name and press Enter.

Copy & Move

Right-click a file → Copy or Move. A modal appears where you type or pick a destination prefix within the same bucket. Click Execute to proceed.

Delete

Select items and press Delete (or right-click → Delete). A confirmation dialog appears.

• For a single item — you must type the exact file or folder name to confirm.
• For multiple items — you must type delete to confirm.

The Delete button stays disabled until the typed text matches exactly, preventing accidental deletions.

Create Folder

Click the New Folder button in the toolbar (or Cmd Shift N). Type a name in the dialog and click Create.

Folder Size Calculation

Object storage doesn't store folder sizes natively — they must be calculated by summing all objects inside.

In List view, every folder row has an Actions column with a Calculate button.

1. Click Calculate next to a folder. A spinner appears while the app counts all nested objects.
2. The result is shown in the Size column: total bytes and object count (e.g. 4.2 MB · 318 obj).
3. Click Refresh (same button) to recalculate after changes.

File Preview

Double-click any previewable file to open it in the preview pane. Supported types:

Press Escape or click outside the pane to close the preview.

Presigned URLs

Presigned URLs give temporary public access to private objects — useful for sharing a file without making the bucket public.

1. Select a single file.
2. Click the Link icon in the toolbar (Cmd L), or right-click → Get Presigned URL.
3. Choose an expiry duration (1 hour, 24 hours, 7 days, or custom).
4. Click Generate. The URL is shown and automatically copied to your clipboard.

Transfer Queue

All uploads and downloads run in the background. Click the Transfers button in the bottom-right corner to open the queue panel.

• Progress bar — shows per-file byte progress and transfer speed.
• Cancel — click the ✕ on an in-progress transfer to abort it.
• Retry — failed transfers show a retry button.
• Clear completed — removes finished items from the list.

Bucket Management

Right-click a bucket in the sidebar (or use the ⋯ menu) to access bucket-level actions:

• Create Bucket — click the + button at the top of the sidebar. Enter a name and select a region.
• Delete Bucket — the bucket must be empty first. A confirmation dialog requires you to type the bucket name exactly before deletion proceeds.
• Bucket Info — shows CORS settings, versioning status, and lifecycle rules (read-only view).

Search & Filter

The search box in the toolbar filters the current folder's visible list in real time. It matches against file and folder names (case-insensitive). It does not search across subfolders — navigate into a subfolder to search inside it.

Keyboard Shortcuts

Appearance

Click the sun / moon icon in the toolbar to toggle between light and dark mode. The preference is saved and restored on the next launch.