Differences
This shows you the differences between the selected revisions of the page.
| task_download 2019-03-27 | task_download 2023-04-20 (current) | ||
| Line 1: | Line 1: | ||
| ====== Downloading Files ====== | ====== Downloading Files ====== | ||
| - | The simplest way to download files is to drag them from [[ui_file_panel|remote panel]] of WinSCP to local panel or Windows Explorer. See section [[task_upload#dragdrop|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. | For alternative ways, advanced options and automation see further sections. | ||
| Line 14: | Line 14: | ||
| &screenshotpict(download_dragdrop) | &screenshotpict(download_dragdrop) | ||
| - | You can also drop the files to Windows Explorer or other application. Possible external transfer destinations and the way they are handled depend on [[ui_pref_dragdrop|configured drag&drop download mode]]. | + | 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]]//. | 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]]//. | ||
| Line 23: | Line 23: | ||
| If you prefer controlling application using keyboard, you will probably find [[ui_commander|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|Commander interface]] make sure that [[ui_file_panel|remote panel]] is still active. Then use //File(s) > Download// 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|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]]//. | 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]]//. | ||
| - | If you use //File(s) > Download > Download and Delete// (or corresponding keyboard shortcut), the files will be moved to local directory (i.e. transferred and deleted from remote directory). | + | 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). |
| ===== [[copy_paste]] Using Copy&paste ===== | ===== [[copy_paste]] Using Copy&paste ===== | ||
| - | You can also download files using the Windows clipboard. First select the files you want to download in the [[ui_file_panel|remote panel]]. | + | 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 use //Paste// command in the local panel ([[ui_commander|Commander interface]] only) or in Windows Explorer. | + | 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]]. | 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]]. | ||
| - | ===== Using File URL ===== | + | ===== [[url]] Using File URL ===== |
| - | WinSCP can be [[integration_url|registered to handle protocol URL Addresses]]. When it is, you can type in 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. For supported URL format see [[commandline|command-line options]]. | + | 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 Download ===== | + | ===== Automating Downloads ===== |
| To automate the file download, use the scripting command ''[[scriptcommand_get|get]]'' or .NET assembly method ''[[library_session_getfiles|Session.GetFiles]]''. | To automate the file download, use the scripting command ''[[scriptcommand_get|get]]'' or .NET assembly method ''[[library_session_getfiles|Session.GetFiles]]''. | ||
| - | |||
| - | ===== [[unc]] Downloading Files To UNC Paths (Network shares) ===== | ||
| - | While WinSCP cannot browse UNC paths (network shares) in local [[ui_file_panel|panel]] of [[ui_commander|Commander interface]], it can download files therein. You can [[ui_copy#target_directory|type target UNC path manually]], you can use %%UNC%% paths in [[scripting]], you can or use any other mean of downloading as described on this page. | ||
| - | |||
| - | //The latest beta version of WinSCP can browse %%UNC%% paths.// &beta (* with stable, mark as &recent, and eventually remove whole section*) | ||
| ===== Downloading Found Files ===== | ===== Downloading Found Files ===== | ||
| You can also initiate a download from [[ui_find|find results]]. | You can also initiate a download from [[ui_find|find results]]. | ||