S3
Last updated 16 October 2026
The S3 page opens the buckets of the AWS profile you choose in the title bar. Folders open with a double-click, any s3:// URI typed in the address bar jumps straight there, and selecting a file previews it in the app. The AWS console would make you download it first. S3 connects only through your AWS profiles (~/.aws/config and ~/.aws/credentials, including SSO). ARNscope stores no access keys.
Browsing
The bucket list comes from ListAllMyBuckets for the profile. Inside a bucket, folders are S3 prefixes: each level is one ListObjectsV2 call with a / delimiter, so a folder opens without listing everything under it.
- Address bar. Paste or type
s3://bucket/prefix/(or a file’s URI) and press Enter. - Filter. Typing in the search field filters what is already loaded. Enter searches the bucket by name instead; that search reads at most the first 5,000 keys, so narrow it with a prefix in a large bucket.
- Back, forward and up work like a browser.
s3:// URI jumps anywhere.Previews
Double-click a file to open it beside the folder’s file list, and maximize it for a full-width view with its details. A preview reads the object into memory (GetObject); nothing is written to your Downloads folder.
| File | Opens as |
|---|---|
| JSON, YAML, SQL, Markdown, code and text | Highlighted text, JSON formatted, with line wrapping and copy |
| Images (JPEG, PNG, GIF, WebP, SVG) | The image |
| The PDF, in the built-in viewer | |
| Parquet | A table you can filter, sort and page through; see below |
| No extension, or one ARNscope does not know | What the bytes look like (JSON, text, image, PDF or binary), with Open as Text, JSON, Image, PDF or Hex |
Compressed objects
An object whose bytes start with a gzip or Zstandard signature is decompressed as it opens, whatever its name, and its details show Compression. For other formats, Decompress as tries zlib, raw deflate, LZ4, Snappy (framed or raw) or Brotli on the bytes you opened.
.json.gz archive opens as JSON; the details say it was gzip.Limits
- Objects up to 100 MB are read whole. Larger ones open from their first 64 KB (as stored, never decompressed), or download them.
- A file without a known extension is read whole up to 8 MB, otherwise from its first 64 KB; views that need the whole file (JSON, image, PDF) are then unavailable.
- A decompressed preview stops at 256 MB, so a small compressed object cannot expand without bound.
Parquet, queried as a table
A Parquet object opens as a table without a download to your Downloads folder: ARNscope copies it to a temporary file (gzip or Zstandard-compressed files are decompressed first) and reads it with DuckDB on your Mac. Each column header shows its Parquet type.
- Filters: up to 12, combined with AND: is, is not, contains, starts with, less or greater than, at most, at least, is empty, is not empty. Apply filters runs them.
- Sort by any column from its header.
- Expand JSON into columns (right-click a text or struct column) turns the keys of a JSON value into columns of their own, which you can filter and sort too.
- Rows come a page at a time; Export loaded rows as CSV and Copy work on what is loaded.
Event mappings: what an upload triggers
Folders and files show small badges for the bucket’s event wiring: S3 notifications and EventBridge rules to SNS, SQS, Lambda and Step Functions. Click a badge to see each path that matches, its events and filters, and the chain hop by hop. A hop in another account is resolved through whichever local profile signs in to that account; without one, the hop says No local profile. Discovery only reads (GetBucketNotification, ListRules, ListSubscriptionsByTopic, GetQueueAttributes and similar), and its result is kept for the session.
Favourites
The ☆ in the address bar keeps the current folder, a file or a glob pattern as a favourite, with an optional label. A favourite remembers the profile it was made with, so opening it switches to that profile and goes there. Favourites are stored on this Mac only.
Changes and the activity log
Upload, create folder, rename, copy, move and delete are available from the toolbar and the context menu. Deletes ask first and list exactly what will go. Every upload, download, copy, rename, edit and delete is recorded, with its result, in an activity log kept in a local database on your Mac (sidebar → Activity). It covers actions made through ARNscope only.
Permissions
| Action | Used for |
|---|---|
s3:ListAllMyBuckets |
The bucket list |
s3:ListBucket |
Folders, search, folder sizes |
s3:GetObject |
Previews, Parquet, downloads, links |
s3:PutObject |
Upload, create folder, copy, rename |
s3:DeleteObject |
Delete, rename, move |
s3:GetBucketNotification, events:ListRules, events:ListTargetsByRule, sns:ListSubscriptionsByTopic, sqs:GetQueueAttributes, lambda:ListEventSourceMappings and related reads |
Event mappings |
Objects encrypted with a customer-managed KMS key also need kms:Decrypt on that key.