Differences
This shows you the differences between the selected revisions of the page.
| task_download 2005-04-25 | task_download 2023-04-20 (current) | ||
| Line 1: | Line 1: | ||
| ====== Downloading Files ====== | ====== Downloading Files ====== | ||
| - | ===== Using Drag&drop (Mouse) ===== | + | The simplest way to download files is to drag them from [[ui_file_panel|remote panel]] of WinSCP to local panel or Windows File Explorer. See section [[task_upload#dragdrop|Using Drag&drop (Mouse)]]. |
| + | |||
| + | For alternative ways, advanced options and automation see further sections. | ||
| + | |||
| + | ===== [[dragdrop]] Using Drag&drop (Mouse) ===== | ||
| First [[ui_file_panel#selecting_files|select the remote files or directories]] you want to download. You can select the files in the [[ui_file_panel|remote panel]], either in file list or in directory tree (one directory only). | First [[ui_file_panel#selecting_files|select the remote files or directories]] you want to download. You can select the files in the [[ui_file_panel|remote panel]], either in file list or in directory tree (one directory only). | ||
| Then drag your selection and drop it on local directory. | Then drag your selection and drop it on local directory. | ||
| - | If you are using [[ui_commander|Norton Commander interface]] you can drop the files on its [[ui_file_panel|local panel]]. If you drop the files on empty place on file list, the files will be downloaded to current local directory. If you drop the files on local directory icon (either in the file list or directory tree), the files will be downloaded to that directory. | + | If you are using [[ui_commander|Commander interface]] you can drop the files on its [[ui_file_panel|local panel]]. If you drop the files on empty place on file list, the files will be downloaded to current local directory.((You may consider turning off //[[ui_pref_commander#panels|Full row select]]// option to be able to drop files everywhere except directory files names to download them to current local directory.)) If you drop the files on local directory icon (either in the file list or directory tree), the files will be downloaded to that directory. |
| - | You can also drop the files to Windows Explorer or other application. Possible external transfer destinations and the way thay are handled depends on whether you have or not installed the [[dragext|drag&drop shell extension]]. If you have installed it, you can drag the files to Windows Explorer (including desktop) only. On the other hand, the files will be transfered directly to the destination. If you have not installed the extension, you can drag the files to the most applications supporting drag&drop (for example archivers). Drawback is that the files need to be downloaded to temporary directory first. | + | &screenshotpict(download_dragdrop) |
| - | Before the download actually starts, the [[ui_copy|transfer options dialog]] will show. There you will have a chance to change the transfer options or the target directory. The target directory is not shown and cannot be changed if you drag files to external application and the [[dragext|drag&drop shell extension]] is not installed. You can avoid the dialog being shown on //Environment tab// of Preferences dialog. | + | You can also drop the files to Windows File Explorer or other application. Possible external transfer destinations and the way they are handled depend on [[ui_pref_dragdrop|configured drag&drop download mode]]. |
| + | |||
| + | Before the download actually starts, the [[ui_copy|transfer options dialog]] will show. There you will have a chance to change the transfer options or the target directory. You can avoid the dialog being shown in [[ui_pref_environment#confirmations|preferences]]. In such case you can change the transfer options by selecting preset on //[[ui_toolbars#transfer|Transfer Settings toolbar]]//. | ||
| + | |||
| + | If you hold ''Shift'' key while dragging the files, they will be moved to local directory (i.e. transferred and deleted from remote directory). | ||
| ===== Using Keyboard ===== | ===== Using Keyboard ===== | ||
| - | If you prefer controlling application using keyboard, you will probably find [[ui_commander|Norton Commander interface]] useful. | + | If you prefer controlling application using keyboard, you will probably find [[ui_commander|Commander interface]] useful. |
| - | First select the remote files or directories you want to download. With [[ui_commander|Norton Commander interface]] make sure that [[ui_file_panel|remote panel]] is still active. Then use //File(s) > Copy// or corresponding keyboard shortcut. | + | First select the remote files or directories you want to download. With [[ui_commander|Commander interface]] make sure that [[ui_file_panel|remote panel]] is still active. Then use //Files > Download// or corresponding keyboard shortcut. |
| - | Before the upload actually starts, the [[ui_copy|transfer options dialog]] will show. There you will have a chance to change the transfer options or the target directory. The target directory is by default the current local directory with [[ui_commander|Norton Commander interface]] and the last used local directory with [[ui_explorer|Explorer-like interface]]. | + | Before the upload actually starts, the [[ui_copy|transfer options dialog]] will show. There you will have a chance to change the transfer options or the target directory. The target directory is by default the current local directory with [[ui_commander|Commander interface]] and the last used local directory with [[ui_explorer|Explorer interface]]. You can avoid the dialog being shown in [[ui_pref_environment#confirmations|preferences]]. In such case you can change the transfer options by selecting preset on //[[ui_toolbars#transfer|Transfer Settings toolbar]]//. |
| - | ===== Using File URL ===== | + | If you use //Files > Download > Download and Delete// (or corresponding keyboard shortcut), the files will be moved to local directory (i.e. transferred and deleted from remote directory). |
| - | WinSCP can be registered to handle [[integration#scp_and_sftp_protocols_url_addresses|SCP and SFTP Protocols URL Addresses]]. When it is, you can type in file URL to your favourite web browser or Window's //Start > Run// box or even include the file URL to some web page. WinSCP will handle the URL and offers you to download the file. For supported URL format see [[commandline|command-line options]]. | + | |
| + | ===== [[copy_paste]] Using Copy&paste ===== | ||
| + | You can also download files [[clipboard|using the Windows clipboard]]. First select the files you want to download in the [[ui_file_panel|remote panel]] and [[clipboard#copy|copy them to the clipboard]]. | ||
| + | |||
| + | Then [[clipboard#paste|use //Paste// command]] in the local panel ([[ui_commander|Commander interface]] only) or in Windows File Explorer. | ||
| + | |||
| + | Before the download actually starts, the [[ui_copy|transfer options dialog]] will show. There you will have a chance to change the transfer options. You can disable the dialog in [[ui_pref_environment|preferences]]. | ||
| + | |||
| + | ===== [[url]] Using File URL ===== | ||
| + | WinSCP can be [[integration_url|registered to handle protocol URL Addresses]]. When it is, you can type in [[session_url#file|file URL]] to your favorite web browser or Window's //Start > Run// box or even include the file URL to some web page. WinSCP will handle the URL and offers you to download the file. | ||
| ===== Download on Background ===== | ===== Download on Background ===== | ||
| By default the download starts on foreground, blocking the WinSCP window until it finishes. Learn how to schedule the [[transfer_queue|background transfer]]. | By default the download starts on foreground, blocking the WinSCP window until it finishes. Learn how to schedule the [[transfer_queue|background transfer]]. | ||
| + | |||
| + | ===== Automating Downloads ===== | ||
| + | To automate the file download, use the scripting command ''[[scriptcommand_get|get]]'' or .NET assembly method ''[[library_session_getfiles|Session.GetFiles]]''. | ||
| + | |||
| + | ===== Downloading Found Files ===== | ||
| + | You can also initiate a download from [[ui_find|find results]]. | ||