Settings
Connection details, external payload rules, local data management, and licensing.
Open Settings from the mode tabs or with ⌘/Ctrl + ,. Four sections:
Connection
Read-only view of the active connection — target (AWS or AWS-compatible), credential method, and the resolved identity (account-name (account-id)). Edit AWS connection reopens the credentials modal; saving a new connection resets the queue list, selection, and staged state for a clean slate. See Connecting to AWS.
External Payloads
Controls how S3 payloads are detected and retrieved:
| Setting | Default | Notes |
|---|---|---|
| Auto-retrieve max size | 262,144 bytes (256 KiB) | Objects at or below this are fetched automatically on receive. Maximum 10 MiB. |
| S3 bucket properties | — | Extra body field names that hold a bucket name. Built-ins (s3BucketName, s3Bucket, bucketName, bucket) always apply. |
| S3 key properties | — | Extra field names for the object key. Built-ins: s3Key, s3ObjectKey, objectKey, key. |
| S3 full-path properties | — | Field names holding a complete s3://bucket/key or S3 URL. |
Custom property names are matched exactly (case-sensitive) and take precedence over the built-in conventions. Manual retrieval is always hard-capped at 10 MiB regardless of the threshold.
Tune the threshold to your payloads
If your offloaded payloads are routinely 1–2 MB and you inspect them often, raise the auto-retrieve threshold so the S3 tab is just there when you open a message. If you browse huge queues over a metered or slow connection, lower it — every auto-retrieval is an S3 GET.
Local Data
- Open logs folder — jumps to Tarmac's log directory; attach these when reporting an issue.
- Delete all local data — wipes cached messages, search indexes, queue metadata, staged actions, and saved preferences (including the stored connection), then reloads the app. License and trial state are preserved. This is the "start fresh" button — and a data-hygiene control: if you've been inspecting queues with sensitive payloads on a shared machine, this removes every local copy.
Remember the scope of local operations: Clear Cache, Delete all local data, and unstaging actions never touch SQS. Tarmac has no queue-purge operation at all — the only things that ever modify a queue are published staged actions.
License
Activate a license key, refresh entitlement, or deactivate the current device. Tarmac's free trial runs on usage days — only days you actually use the app count toward the 14. When the trial ends the app goes read-only: fetching, live tail, and publishing are disabled, but everything already in your local cache stays searchable and inspectable.