Allows for fast and efficient downloads of files and directories from a VSCode Remote SSH session to your local machine.
Demo
Features
保存路径弹出窗口
Fast File Downloads: Quickly download files or directories from remote servers connected via SSH directly to your local machine.
Multiple File Selection: Supports downloading multiple files or directories simultaneously.
Rsync-Based Transfers: Utilizes rsync for optimized and reliable synchronization between remote servers and your local machine.
Automatic Rsync Installation and Version Check: Automatically checks if rsync is installed and up-to-date on your local machine, providing guidance for installation or updates.
Passwordless SSH Authentication Detection: Detects if passwordless SSH authentication is not set up and provides clear instructions for configuration.
Benefits
Speed and Efficiency: Uses rsync's differential transfer capability, ensuring only changed files are copied, making downloads faster and more efficient.
Seamless Workflow: Download files directly from the VSCode Explorer context menu without switching to external tools like FileZilla.
Enhanced Security: Encourages the use of SSH keys for passwordless authentication, improving security while reducing the hassle of entering passwords.
Requirements
Visual Studio Code: Version 1.60.0 or higher.
Remote SSH Extension: The official VSCode Remote - SSH extension for connecting to remote servers.
Rsync: Installed on both the local and remote machines.
MacOS: Ensure rsync version 3.0.0 or higher is installed (the default version on macOS is outdated).
Linux: Most distributions include rsync by default.
Passwordless SSH Authentication: Configure SSH key-based authentication for seamless operation.
Platform Support
✅ macOS: Full support with Homebrew for rsync installation
✅ Linux: Full support with apt-get for rsync installation
✅ Windows: Supported via scp
Usage
Connect to a Remote SSH Session:
Use the Remote - SSH extension to connect to your remote server.
Download Files or Directories:
In the Explorer view, select one or multiple files or directories.
Right-click on the selection.
Choose "Fast Download" from the context menu.
When prompted, enter the destination path on your local machine (default is your Downloads folder).
The extension will use rsync to transfer the selected items from the remote server to your local destination.
Monitor Progress:
The extension will display progress and output in the "Fast Download" output channel.
Notifications will inform you when the download is complete or if any errors occur.
Extension Settings
fastDownload.defaultDownloadLocation:
Allows you to set a default download directory on your local machine.
Default: "".
Known Issues
Outdated Rsync on macOS:
The default version of rsync on macOS is outdated. Use Homebrew to install or update rsync to version 3.0.0 or higher.
Windows Prerequisites:
Windows users need to have Scoop package manager installed for automatic rsync installation.
Alternatively, manually install cwRsync, Git Bash, or WSL for SSH/rsync functionality.
Passwordless SSH Authentication:
Passwordless SSH authentication is required for the extension to function properly. If not set up, the extension will guide you through the setup process.
Contributing
Contributions are welcome! Please submit issues or pull requests to the GitHub repository.
