Preview, share, and edit files
Use the preview panel, Quick Look, file details, presigned links, share history, and quick edit in BucketMate for macOS to work with S3 files faster.
BucketMate helps you inspect files before downloading them and share objects without leaving the app.
Preview panel
The preview panel on the right side of the window shows a preview and details for the selected file.
Show or hide it with the Preview toolbar button, View > Show Preview, or Command-Shift-P.
The panel previews these file types inline:
- Images
- Text and code files up to 10 MB. Large text files show the first 200 KB.
- PDF files
For other files up to 100 MB, choose Show preview in the panel to load a Quick Look preview.
Quick Look preview
Select a file and press Space, or choose Preview from the context menu. BucketMate downloads the file to a temporary folder and opens it in Quick Look.
View file details
Use View detail from the context menu, or press Command-I, to open the preview panel for the selected file.
The panel can show:
- Kind, size, and modified date
- Storage class and restore status, when the provider supports storage classes
- ETag
- Bucket and path
- Object URL
- Custom-domain URL, for Cloudflare R2 connections with a custom domain
- Versions, when versioning is on for the bucket
Use the copy buttons next to Path, URL, and Custom URL to copy them.
When you select a folder, the panel shows its item count and size. When you select several items, it shows how many files and folders are selected.
Open files
Use Open from the context menu or panel, or press Command-Down Arrow, to download a temporary copy and open it with the default macOS app.
BucketMate shows a warning before opening or previewing files. Turn it off with Show warning before opening or previewing file in Settings > General.
Quick edit text files
For text files up to 10 MB, use Edit to change the file and upload it back to the same object key.
- Select a text file.
- Choose Edit from the context menu or panel, or press Command-E.
- Make your changes.
- Choose Save & upload.
BucketMate asks you to save or discard changes before you switch to another file.
Edit in another app
- Open the file with Edit.
- Choose Edit in default app.
- Edit and save the file in the other app.
- When BucketMate detects local edits, it shows Upload changes. Choose Upload to replace the object, or Later to decide later.
Create share links
BucketMate can create presigned URLs for files.
- Right-click a file.
- Choose Share link.
- Choose 30 minutes, 1 hour, 1 day, or 1 week. BucketMate copies the link right away.
For another duration:
- Choose Share link > Custom duration....
- Enter a duration in minutes, hours, or days.
- Choose Copy link.
The Share menu in the preview panel has the same options.
Most S3 providers limit presigned URLs to 7 days. BucketMate warns when the selected duration is longer and caps the link at 7 days.
Share-link history
BucketMate stores created share links in local history so you can copy or open them later.
History entries can include:
- URL
- File name
- Bucket
- Object key
- Connection
- Creation time
- Expiration time
- Duration
Choose Share link > View history, or open Settings > Shared Links, to search history, open a link, copy a URL, delete one entry, or choose Clear History.
Revoking share links
Removing an item from share-link history does not revoke the link. A presigned URL remains valid until it expires.
To invalidate a link before expiration, rename the object, delete the object, or rotate the credentials used to create the link.
Copy direct URLs
Besides presigned links, BucketMate can copy direct object URLs and Cloudflare R2 custom-domain URLs. Direct URLs work only when the object and bucket are publicly reachable through that URL.