ARNscopeDocs

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.

A narrated tour, with captions: browsing, previews, Parquet, compressed objects, event mappings, favourites and the activity log. Sample data.

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.

Folders open with a double-click; an 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
PDF 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
JSON and SQL open formatted and highlighted.
PDFs and images open in place; the file list beside them switches files.
A file without an extension: ARNscope says what the bytes look like, and you choose how to read them.

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.

A .json.gz archive opens as JSON; the details say it was gzip.

Limits

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.

Filter, sort, and expand a JSON column into columns of its own.

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.

Order exports fan out through SNS to a search queue and a queue in another account.

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.

A labelled favourite in the sidebar.

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.

The local activity log, with failures and their errors.

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.