SFTP File Transfer

NyaTerm's remote file workflow is built on top of SSH sessions. That means the file explorer, SFTP transfers, and local-edit-then-upload-back workflow are only available in SSH sessions. Local Terminal, Telnet, and Serial do not expose this set of features.

File explorer

After connecting an SSH session, the file explorer panel lets you browse remote directories directly.

Core capabilities include:

• Automatically entering the remote user's home directory
• Entering folders, going up, and jumping by typing a path
• Refreshing the current directory
• Syncing with the terminal's working directory
• Disabling auto-sync when the session does not support path tracking

Common file operations

From the file list or the context menu, you can perform:

Operation	Description
Open	Download to a local temp directory, then open with the default editor
Upload File	Upload a local file to the current remote directory
Upload Folder	Upload a full local directory tree
Download	Download a file or an entire directory
Rename	Change the remote name
Move	Move a file or directory to another path
Delete	Remove a file or directory
Properties	View size, timestamps, UID/GID, permissions, and more
New File / Folder / Symlink	Create entries directly in the current directory; symlinks use OpenSSH-compatible handling

The Open action is not just a preview. It prepares the round-trip editing flow.

Uploads and downloads

Upload

Use the toolbar, context menu, or drag and drop to upload local content into the current remote directory.

• Multiple files are queued one by one
• Folder uploads preserve directory structure
• Good for syncing scripts, config files, or release packages

External drag-and-drop upload

The file explorer supports dragging files or folders from your system file manager directly into the NyaTerm file browser for upload.

Typical flow:

1. Open an SSH session and switch to the file explorer
2. Drag a local file or folder into the file list area
3. Release when the drag overlay appears
4. NyaTerm adds the dropped items to the upload flow automatically

Notes:

• Upload is only triggered when you drop onto the file browser list area
• Some drag sources do not expose a real local file path. In that case, NyaTerm cannot resolve the dropped item directly and will prompt you to use Upload File or Upload Folder instead

Download

Downloads usually follow one of two workflows:

• Save directly into a default download directory
• Ask for a destination every time for ad hoc troubleshooting or task-based organization

Both file downloads and directory downloads are supported.

Transfer panel and transfer settings

NyaTerm puts uploads and downloads into a shared transfer queue so you can inspect:

• Current progress
• Real-time transfer speed
• Success, paused, canceled, and failed states
• Concurrent transfers
• The current download target

Each transfer item supports:

• Pause
• Resume
• Cancel
• Retry after failure
• Remove after completion

The panel also provides bulk actions:

• Pause All
• Resume All
• Cancel All
• Clear Completed

In Settings → Transfer, you can adjust:

• Upload / download thread count
• Conflict handling strategy
• Maximum retry count
• Transfer buffer size
• Whether to preserve timestamps
• Whether to continue resumable transfers
• Default file permissions
• Default download path
• Whether to ask for the save location every time
• The local editor used when opening remote files

Duplicate target handling

When an upload or download reaches an existing file, the duplicate target dialog lets you choose:

• Overwrite — replace the target file
• Overwrite and do not ask again for this task — keep overwriting for the current batch
• Skip — keep the target file and skip the current item

If you often sync the same directories in batches, tune the default conflict strategy in Settings → Transfer to reduce repeated prompts.

SFTP reliability and performance

The newer SFTP backend improves directory handling, symlinks, known-size downloads, and large uploads. You usually do not need to think about the implementation details; the visible result is clearer speed feedback, more specific errors, and directory/symlink behavior that is closer to OpenSSH.

NyaTerm also limits how many SFTP channels run concurrently on a single SSH connection, and automatically retries with backoff when a channel open hits a transient failure. This keeps multiple file operations on the same host more stable, so a momentary shortage of channel resources is less likely to surface as an error. These are backend behaviors with no settings to configure.

Zmodem transfers (rz / sz)

Besides SFTP, NyaTerm supports the Zmodem transfers common in the terminal — the ones triggered when you run rz (upload to the remote) or sz (download from the remote) on the host.

• When rz is detected, NyaTerm prompts you to pick the local files to upload; before uploading it probes the remote directory for name conflicts and resolves them
• When sz is detected, NyaTerm prompts you for a local save directory
• Zmodem transfers appear as items in the transfer queue with live progress

Note that the controls available for Zmodem transfers differ from regular SFTP transfers:

• Zmodem items do not support pause, resume, retry, or cancel
• Once a transfer finishes, you can only remove it from the list
• The panel's Pause all / Resume all / Retry all actions skip Zmodem items automatically

This is because the Zmodem protocol is driven directly by both ends of the terminal; NyaTerm only handles progress display and file selection, and does not intervene in the protocol's own pause/resume behavior.

Sync with terminal paths

The file explorer can work together with the current SSH terminal path:

• Manual Sync — jump the explorer to the terminal's current directory
• Auto Sync — automatically follow when the terminal changes directories

This is useful when you are moving around in a deploy or log directory and want the file panel to stay aligned.

Edit locally and upload back automatically

This is one of NyaTerm's most practical workflows for real operations work.

How it works

1. In the SSH file explorer, choose Open on a remote file
2. NyaTerm downloads it into a local temp directory
3. A file watcher is started
4. After you save in your local editor, NyaTerm opens an upload prompt

NyaTerm fingerprints the watched file by content (it hashes the content for smaller files and falls back to size and modification time for larger ones). The upload prompt only fires when the file's content actually changes; saves that only touch the timestamp or that write identical content will not trigger a spurious upload. This also handles atomic saves (write a temp file, then rename) correctly.

Upload prompt window

After the file changes, you can choose:

• Upload once
• Always upload
• Cancel

If you choose Always upload for a file, later saves in the current session are sent back automatically without prompting again.

Good fits

• Editing remote config files
• Tweaking deploy scripts
• Pulling a file locally for inspection, then sending changes back
• Preparing screenshots that demonstrate the round-trip editing flow

File properties and permissions

The Properties view shows:

• File size
• Modified time and access time
• Owner and group
• UID / GID
• Octal permission values

If your workflow requires checking permissions before replacing a file, this is often clearer than relying only on ls -l.

Screenshot suggestion

• Suggested image path: /img/docs/file-transfer/remote-file-browser.png
• Show an SSH session with the file browser, toolbar, and context menu visible
• Another good image path: /img/docs/file-transfer/auto-upload-dialog.png
• Open a remote text file, save it in a local editor, and capture the auto-upload prompt