# Workspaces, settings, and shortcuts

> Organize connections with workspaces, tune BucketMate settings, and use keyboard shortcuts

Canonical: https://docs.bucketmate.app/macos/features/workspaces-settings-and-shortcuts

BucketMate stores app organization and preferences locally on your Mac. Use workspaces and settings to keep storage accounts separated and speed up repeated tasks.

## Workspaces

Workspaces group connections, bucket state, custom domains, pinned buckets, hidden buckets, large-bucket state, and last-opened bucket state.

Use workspaces for:

- Personal and work storage
- Client projects
- Staging and production accounts
- Separate teams or environments

The free trial supports the default workspace. Pro unlocks multiple workspaces.

## Connections and buckets

Within each workspace, BucketMate remembers:

- Saved connections
- Expanded connections
- Pinned buckets
- Hidden buckets
- Custom-domain settings
- Large-bucket indexing state
- Last opened connection and bucket

Switching workspaces disconnects the current session, clears workspace-dependent in-memory cache, and loads the selected workspace's saved state.

## General settings

Open **Settings > General** to configure:

- Download folder behavior
- Default download folder
- Upload chunk size
- Light, dark, or system appearance
- Warning before opening or previewing files
- Workspace switcher visibility
- Inline preview
- Anonymous usage analytics
- Automatic update checks outside the App Store build

## Cache and temporary data

Open **Settings > Advanced** to view and clear cached data.

BucketMate uses local cache to make repeated browsing faster. Cache can include bucket lists, object lists, folder metrics, and temporary files used for preview, open, download, and quick edit flows.

Use advanced settings when:

- A bucket changed outside BucketMate and cached data looks stale.
- You want to free disk space used by temporary files.
- You want to choose a different temporary data location.

## Shared links settings

Open **Settings > Shared Links** to manage local share-link history.

You can search history, copy a URL, open a URL, delete an entry, or clear all history. Clearing history does not revoke links that were already created.

## Default keyboard shortcuts

| Action | Shortcut |
| --- | --- |
| Refresh | Command-R |
| Toggle sidebar | Command-B |
| Toggle preview panel | Command-Shift-P |
| Toggle bucket filter | Command-Shift-F |
| Search files | Command-F |
| Open | Command-Down |
| Edit file | Command-E |
| Preview | Space |
| View detail | Command-I |
| Create folder | Command-Shift-N |
| Upload | Command-U |
| Download | Command-Shift-D |
| Copy file name | Command-Option-C |
| Copy URL | Command-Option-U |
| Copy custom-domain URL | Command-Option-Shift-U |
| Rename | Return |
| Delete | Delete |

Open **Settings > Shortcuts** to customize shortcuts or reset them to defaults.