Settings and appearance

Choose light or dark mode, your terminal app, your downloads folder and a few defaults. Open AirSCP ▸ Settings… (⌘,). Every change applies at once.

Settings: Appearance, Files and Security

Appearance

System (the default) follows your Mac’s light or dark mode. Light or Dark keeps AirSCP in one of them.

  • Light is the Paper look: white panes on a grey background, and black for the selected row, the active tab and the main buttons.
  • Dark is the Night Harbor look: a deep blue-grey, with a colour for each kind of thing (servers blue, Remote Desktop purple, proxies orange) and glowing dots for connected servers.

Your Mac’s accent colour, Increase contrast and Reduce transparency (System Settings ▸ Accessibility ▸ Display) still apply. With Increase contrast on, the dark look drops its blue tint.

AirSCP's window; it follows the appearance you choose

Files

Setting What it does
Open terminals in Terminal (default) or iTerm, for Open Terminal, Run in Terminal and Kill with sudo.
Open Terminal Here and Run in Terminal in the Terminal tab Off by default. On: a server folder’s Open Terminal Here and Run in Terminal go to the host’s Terminal tab in AirSCP instead: typed at an empty prompt, else in a new tab.
Downloads folder Where Download To… starts, and where Download as .tar.gz puts the archive when the other pane isn’t this Mac. Drags and the Download button go to the folder shown.
Show hidden files in new panes Off by default. Each pane can still switch with ⇧⌘..
Copied files keep their original date Off by default: copies are dated now. On: they keep the file’s own date (scp -p).
Verify transfers with SHA-256 Off by default. On: each copied file is compared with the original once it arrives. See Check a copy with its checksum.
Ask before deleting on a server On by default.
Always calculate folder sizes Off by default: folders show “—” until you click Σ.

The App Store version has neither terminal setting: it always uses the Terminal tab.

Security

How new hosts check their server’s key, and new desktops their server’s certificate. Ask unless you change it. See Self-signed certificates and corporate networks.

Keys

New keys go in: the folder where New Key Pair and Import Key save keys. ~/.ssh by default, where ssh finds them by itself.

SSH folder (the App Store version only): the folder ssh uses for your keys, known hosts and config. Click Choose… and choose ~/.ssh (the panel opens there). Until you do, AirSCP keeps its own. See The App Store version.

Apple Intelligence

Use Apple Intelligence for Ask AirSCP and Explain: on by default, on a Mac that has it. Answers come from Apple’s model on this Mac. See Shortcuts, Siri & Apple Intelligence.

Agents

Allow AI agents to control AirSCP (MCP): off by default. See AI agents (MCP).

Ask before agents change things: on by default. Before an agent deletes, copies or runs something, a small window asks you: Deny, Allow Once or Allow for 15 Minutes. Agents can’t turn it off. See Allow or deny what an agent changes.

Advanced

Debug logging: off by default. On, AirSCP writes a detailed log of connections and transfers, to help find what went wrong. Turn it off when done. See Turn on debug logs.

Settings: Advanced, with Debug logging

Tips

  • The ? button at the bottom of Settings opens this page.