# S3

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.

<figure class="doc-video">
<video controls playsinline preload="none" poster="/media/docs/s3/s3-explainer.webp?v=1" aria-label="S3 in ARNscope: a narrated tour of under two minutes">
<source src="/media/docs/s3/s3-explainer.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-explainer.mp4?v=1" type="video/mp4">
<track kind="captions" srclang="en" label="English" src="/media/docs/s3/s3-explainer.vtt?v=1" default>
</video>
<figcaption>A narrated tour, with captions: browsing, previews, Parquet, compressed objects, event mappings, favourites and the activity log. Sample data.</figcaption>
</figure>

## 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-browse.webp?v=1" aria-label="Opening folders with a double-click, then typing an S3 URI into the address bar to jump to another folder.">
<source src="/media/docs/s3/s3-browse.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-browse.mp4?v=1" type="video/mp4">
</video>
<figcaption>Folders open with a double-click; an <code>s3://</code> URI jumps anywhere.</figcaption>
</figure>

## 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 |

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-preview.webp?v=1" aria-label="A settlement summary JSON file and a SQL file opening in the preview with syntax colours.">
<source src="/media/docs/s3/s3-preview.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-preview.mp4?v=1" type="video/mp4">
</video>
<figcaption>JSON and SQL open formatted and highlighted.</figcaption>
</figure>

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-pdf-images.webp?v=1" aria-label="An invoice PDF opening in place, another invoice from the file list, then a product photo.">
<source src="/media/docs/s3/s3-pdf-images.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-pdf-images.mp4?v=1" type="video/mp4">
</video>
<figcaption>PDFs and images open in place; the file list beside them switches files.</figcaption>
</figure>

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-bytes.webp?v=1" aria-label="A webhook event stored without an extension: detected as JSON, then shown as hex, text and JSON.">
<source src="/media/docs/s3/s3-bytes.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-bytes.mp4?v=1" type="video/mp4">
</video>
<figcaption>A file without an extension: ARNscope says what the bytes look like, and you choose how to read them.</figcaption>
</figure>

### 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-gzip.webp?v=1" aria-label="A gzipped JSON archive opening as formatted JSON, with Compression gzip in the file details.">
<source src="/media/docs/s3/s3-gzip.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-gzip.mp4?v=1" type="video/mp4">
</video>
<figcaption>A <code>.json.gz</code> archive opens as JSON; the details say it was gzip.</figcaption>
</figure>

### 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-parquet.webp?v=1" aria-label="An orders export in Parquet: a filter on status paid, a sort on total_cents, and the shipping JSON column expanded into its keys.">
<source src="/media/docs/s3/s3-parquet.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-parquet.mp4?v=1" type="video/mp4">
</video>
<figcaption>Filter, sort, and expand a JSON column into columns of its own.</figcaption>
</figure>

## 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-mappings.webp?v=1" aria-label="Mapping badges on folders; the exports mapping opens to show S3 to SNS to SQS to Lambda, and a second path into another account.">
<source src="/media/docs/s3/s3-mappings.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-mappings.mp4?v=1" type="video/mp4">
</video>
<figcaption>Order exports fan out through SNS to a search queue and a queue in another account.</figcaption>
</figure>

## 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-favourites.webp?v=1" aria-label="Adding the settlement reports folder as a favourite with a label; it appears under Favourites in the sidebar.">
<source src="/media/docs/s3/s3-favourites.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-favourites.mp4?v=1" type="video/mp4">
</video>
<figcaption>A labelled favourite in the sidebar.</figcaption>
</figure>

## 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/s3/s3-activity.webp?v=1" aria-label="The activity log: downloads, copies, renames and uploads with their status, including a failed request.">
<source src="/media/docs/s3/s3-activity.webm?v=1" type="video/webm">
<source src="/media/docs/s3/s3-activity.mp4?v=1" type="video/mp4">
</video>
<figcaption>The local activity log, with failures and their errors.</figcaption>
</figure>

## 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.

Source: https://arnscope.com/docs/s3
