Differences

This shows you the differences between the selected revisions of the page.

task_download 2017-01-15 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 10: Line 10:
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|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.+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.
&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 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 transferred 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.+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. 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 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]]//.
If you hold ''Shift'' key while dragging the files, they will be moved to local directory (i.e. transferred and deleted from remote directory). If you hold ''Shift'' key while dragging the files, they will be moved to local directory (i.e. transferred and deleted from remote directory).
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).
-===== Using File URL ===== +===== [[copy_paste]] Using Copy&paste ===== 
-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]]. +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 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]]''.
 +===== Downloading Found Files =====
 +You can also initiate a download from [[ui_find|find results]].
- 
-===== [[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 [[#dragdrop|drag]] the files to Windows Explorer or another application, you can use UNC paths in [[scripting]], you can [[ui_copy#target_directory|type target UNC path manually]], or use any other mean of downloading as described on this page. 

Last modified: by martin