Skip to content

File Transfers (SFTP)

PhanTerm deeply integrates a graphical SFTP file tree sidebar. It reuses your current SSH connection channel, requiring no additional connections or open ports.

  • Toggle Sidebar: Press Space to toggle the visibility of the sidebar.
  • Navigate & Expand: Use j/k to move up and down, l (or Enter) to expand a directory, and h to collapse a directory.
  • Show Hidden Files: Hidden files starting with . (e.g., .bashrc) are displayed by default in a dimmed style directly within the tree; no extra toggle is required.
  • Sticky Headers: When you scroll deep into a directory hierarchy, the parent directory path remains pinned at the top of the list, ensuring you never lose track of your current depth.
  • Quick Filter: Press / to enter search mode, allowing you to instantly filter the currently expanded files by name.

When focus is on the file tree:

  • dd: Delete a file or directory (with a security confirmation prompt).
  • r: Rename a file or directory.
  • p: Summon the system file picker to upload local files into the currently selected remote directory.
  • Ctrl+S: Instantly download the selected remote file to your local system.

Need to quickly tweak a configuration file on the remote server? No need to struggle with terminal-based Vim or Nano—you can use your favorite local editor directly:

  1. Select the remote file and press e.
  2. PhanTerm automatically downloads it to a local temporary directory and opens it using your system’s default application.
  3. Edit and save the file in your local application.
  4. After a brief delay, PhanTerm will display a prompt asking if you want to upload the updates. Press y to instantly transmit and overwrite the remote file!

All download and upload tasks are submitted to a background asynchronous concurrent queue. During the transfer, you are completely free to switch to other tabs and continue executing your terminal commands. Press t at any time to open or collapse the Transfer Center in the bottom right corner to view current progress and history.