Skip to content

sftp.md

Latest commit

 

History

History
83 lines (55 loc) · 3.59 KB

sftp.md

File metadata and controls

83 lines (55 loc) · 3.59 KB
Raw

SFTP Support

Furman includes a built-in SFTP client for browsing, transferring, viewing, and editing files on remote servers over SSH.

Connecting

Press Cmd+S to open the Connection Manager, then click SFTP in the sidebar. You can authenticate using:

  • Password — stored securely in the system keychain
  • SSH Key — specify a path to a private key file (e.g. ~/.ssh/id_rsa) with optional passphrase
  • SSH Agent — use keys loaded in your running SSH agent

Enter the host, port (default 22), and username, then click Connect or Save & Connect to store the profile for later use.

Saved SFTP connections appear in the Connection Manager sidebar. Press Cmd+S again while connected to disconnect.

Host key verification

Furman verifies SSH server keys against ~/.ssh/known_hosts. Unknown or changed keys are rejected. Before connecting to a new server, verify its fingerprint through a trusted channel and add it with OpenSSH, for example:

ssh-keyscan -p 22 example.com | ssh-keygen -lf -
ssh-keyscan -p 22 example.com >> ~/.ssh/known_hosts

Replace 22 with the configured SSH port. Do not add a key until its displayed fingerprint matches the server administrator's fingerprint.

Browsing & Navigation

  • Browse remote directories with standard dual-pane navigation
  • Breadcrumb bar shows user@host with clickable path segments
  • SFTP icon badge in the panel header — click it for connection info
  • Create, rename, and delete files and directories
  • Quick filter works the same as local panels

Transfers

  • Download (SFTP → local) and upload (local → SFTP) with Copy/Move commands or OS drag-and-drop
  • SFTP-to-SFTP copy between two SFTP connections (via local temp directory)
  • Cross-protocol transfers — copy between S3 and SFTP in either direction
  • Transfer queue with the same progress tracking, pause/resume, and bandwidth controls as S3

Viewing & Editing

  • View (F3 / Cmd+3) — downloads the remote file to a temp directory and opens the viewer (text, image, or hex)
  • Edit (F4 / Cmd+E) — downloads the remote file, opens the built-in editor, and saves changes back to the server on Cmd+S

Sync

Directory comparison and sync are not currently available for SFTP panels. Copy and move operations remain available between SFTP, local, and S3 panels.

Bookmarks

Press Cmd+D while browsing an SFTP connection to bookmark the current path. Bookmarks appear in the sidebar under SFTP BOOKMARKS and reconnect automatically when clicked.

Properties

Press Cmd+I on a remote file to view its properties (size, modified date, permissions, owner, group). Click the SFTP icon in the panel header to view connection info (host, port, username, protocol).

Connection Tuning

SFTP connection timeouts are configurable in Preferences (Network tab, SFTP section):

  • Inactivity Timeout — disconnect after a period of no activity (default 5 min)
  • Keepalive Interval — send keepalive packets to prevent idle disconnects (default 30s)
  • Operation Timeout — max wait time for a single SFTP operation (default 60s)

Changed settings apply to new connections only.

Keyboard Shortcuts

Shortcut Action
Cmd+S Connection Manager / disconnect SFTP
Cmd+D Bookmark current SFTP path
Cmd+I File properties / connection info
Cmd+Y Sync between panels
F3 / Cmd+3 View remote file
F4 / Cmd+E Edit remote file
F5 / Cmd+C Copy to other panel
F6 / Cmd+M Move to other panel
F7 / Cmd+N Create directory
F8 / Cmd+Backspace Delete