May the source be with you, but remember the KISS principle ;-)
Home Switchboard Unix Administration Red Hat TCP/IP Networks Neoliberalism Toxic Managers
(slightly skeptical) Educational society promoting "Back to basics" movement against IT overcomplexity and  bastardization of classic Unix

WinSCP Tips

News WinSCP Recommended Links Recommended Papers OFM Book History of WinSCP development OFM Standards
Scripting interface SSH for System Administrators Passwordless SSH login  scp sftp Humor Etc

WinSCP is a very good, flexible SFTP client, SCP  client, FTPS  client and FTP client  for Windows.  It uses PuTTY format of SSH keys. It can execute PuTTYgen and Pageant (from  Tools menu on Login dialog). With a  built-in editor that works for remote files it beats competition such as FAR or Total Commander.

The most important advantage of WinSCP over similar tools is that several sessions are supported simultaneously and you can "stack" them  in a way you wish.  Switching is via convenient horizontal tabs. 

WinSCP provides very convenient integrated environment for working with Linux servers because it integrates well with Putty (a unique feature of WinSCP). No need to remember passwords anymore. It can launch Putty with the parameters stored on in WinSCP “sessions" allowing you to connect without further authentication. This ability to launch Putty with authentication settings taken from existing "session" in WinSCP makes it perfect launcher for Putty even if you do not use WinSCP features much.

Multiple sessions can be creates – one for each of your machines. Directories can be compared and newer file transferred to remote server or from the remote server with one click.

You can also compare individual files, which few other OFMs can do.

WinSCP take working with "directories favorites" to a new level. This is actually a very weak feature of FAR and it is absent from Total Commander. In WinSCP you can store frequently used directories inside you session or globally. The same true for windows desktop. If also provides you an ability to store favorites in two ways: per session and globally.  computer). This makes it a better sysadmin tool then many other OFMs, as navigating to the necessary directory in other OFMs is a more cumbersome process. 


WinSCP allows to edit files on the remote machine using built-in editor which is more user friendly that anything I know. This is unique capability to use standard windows style editor for editing files directly on Linux/Unix server. This is a notepad class editor, simple but very functional:

If your file requires a more complex editor you can configure if for specific extension, for example  for *.pl you can use Nodepad++ which allow you to use Perl aware editor on remote files without manually transferring files back and forth.

for some extensions instead of editor you can use some other application for example viewer.

There is a setting to allow to open command line at the bottom. The results of the command entered are displayed in a separate screen. There is a built-in history of commands in this screen. Actually a pretty neat implementation of the "third" windows of OFM in GUI environment.

WinSCP also  allows to view hidden files and directories Ctrl-Alt-H. Attributes of files can be not only viewed and changed but also changed recursively.

Standard for OFMs command line at the bottom can be activated via Shift-Ctrl-N. Execution of command invoke the third window which has history of commands.  

You can synch directories between Windows desktop and remote server and several other more complex things that enhance your productivity (it is a scriptable tool)

Like in any OFM files can be displayed using mask  (basic regular expressions) like in ls.

In many corporation this is a default tool for working with Linux servers

It is free and is licensed under GNU license. See History of WinSCP development for more details.

Scripting interface

WinSCP offers scripting interface that you can use to automate many operations that it supports, including file transfers, synchronization and other operations. You can use either Windows command interpreter which is adequate for simple tasks, or Windows Scripting Host.  For example here is a script that uploads a single file:

option batch abort
option confirm off
open [email protected]
put examplefile.txt /home/user/

Assemble the commands into a script file. You can name the script file as you like. Use the /script command line option to pass the script to the WinSCP executable. You can embed the complete command line into a Windows batch file (.bat), like as follows:

@echo off /script=myscript.txt

Make shortcut to it on desktop to ease execution. Either make shortcut to batch file (.bat) or enter full command line to shortcut itself.

If the wrapping batch file takes filename as command line parameter (see below) you can: Make shortcut to it on desktop and use it by dropping files on the icon. Windows automatically run the batch file and passes path to dropped file as command-line parameter.

In a similar way you can put the shortcut to the batch file into Explorer’s ‘Send To’ context menu (c:\documents and settings\username\sendto). 

Working as a plugin with FAR and  Altap Salamander

WinSCP is also available as a plugin for other file managers.  FAR has such a plugin (older version, no longer supported). Much less populat Altap Salamander also has a plugin.

Top Visited
Past week
Past month


Old News ;-)

[May 23, 2013] How to Connect to an iPod Using WinSCP eHow

SSH transfers only work with a jailbroken iPod Touch.

The file transfer program WinSCP allows you to transfer files between your iPod and computer. While the iTunes program does not allow you to put your own files on the iPod, WinSCP allows you to do this over a Wi-Fi connection. After you connect to your iPod through Wi-Fi, you can then upload videos, songs or applications, that you did not purchase from iTunes.

[May 23, 2013] Added commands to execute PuTTYgen and Pageant to Tools menu on Login dialog.

Stopping WinSCP filepart errors by Mike Laverick

Last week a student on my course gave me a tip. Personally, I prefer to use Veeam's FastSCP for ESX Server when transferring files from my Windows Desktop to ESX 3. However, occasionally in the lab environments I work in I have to use WinSCP which is slower. One thing I have observed is if I copy a file such as an ISO to a VMFS volume, then WinSCP gives me an error. Basically, what happens is though the files get copied to the VMFS volume – and error occurs when renaming the file from say – w2k3sp2.iso.filepart to w2k3sp2.iso. This is caused by the "Resume" feature in WinSCP which is intended to pickup an upload when it fails from where it failed, rather than starting the upload from the beginning. It appears as VMFS doesn't support this functionality.

The solution to this problem is a work-around. To disable the "Resume" feature in the WinSCP software. I don't mind doing this. Everything is gigabit in the lab environments I work in and very reliable so I don't really need the resume feature. To disable the WinSCP "Resume" feature do the following:

In the menu choose, Options and Preferences
Under Transfer, select Resume
Under "Enable transfer resume for", select Disable
Under "Automatic Reconnect", disable "Automatic reconnect session, if it breaks during transfer"

[ Oct 19, 2012 ] WinSCP 5.1 released


This version is the first stable release of 5.x branch. The new features of 5.x include:

30 Cool Open Source Software I Discovered in 2013

WinSCP works fine under Wine, and has support for encrypted PuTTY keys, unlike FileZilla. That's why I've dumped FZ and installed Wine+WinSCP, it's more work but well worth it.

Recent Version History WinSCP

Ctrl+Backspace works in path edit boxes to deletes the word before cursor

Site tree on Login dialog responds to mouse wheel

Local path pattern (!\) for custom commands.

Remembering the last working directories in a workspace

Holding down Ctrl and Shift keys while running a local custom command copies the command to clipboard instead of executing it.

Support Microsoft Passport authentication to allow WebDAV access to Microsoft OneDrive.

Found files can be downloaded and deleted on the Find dialog

Using !P pattern in PuTTY command implies that password should be remembered.

The -pw argument is added to PuTTY command-line, even when !P pattern is used.

Custom commands can be distributed in a form of WinSCP extension.

Session name (!N) and port number (!#) patterns for custom commands and terminal client path

Handling ssh:// URLs and opening them in PuTTY.

Hidden files are hidden by default.

Keyboard shortcut Ctrl+Alt+F for Filter command

Alternate delete on Shift-Click on Delete command in file context menu

Session can be opened in PuTTY from Login dialog

Pattern !U in Custom command and PuTTY path works even with password entered only during authentication.

Ctrl+Space shortcut for toggling selection of focused file works in Commander-style selection mode.

Ctrl+W shortcut for closing tab (session).

Special characters ;,|<> in file masks can be used as literals by doubling them.

Computer can be suspended when operation completes.

Command to copy find results to clipboard

Configurable file panel font size.

Internal Text Editor WinSCP

WinSCP has an integrated simple text editor you can use to edit remote or local text files. If you want to use a more complex editor or edit binary files, you need to set up external editor. The editor capabilities are similar to those of Notepad (simple editor shipped with Windows):

  • Clipboard operations: Copy (Ctrl+C), Cut (Ctrl+X), Paste (Ctrl+V).
  • Undo (Ctrl+Z), Redo (Ctrl+Y).
  • Find (Ctrl+F), Replace (Ctrl+H), Find next (F3).
  • Go to line number (Ctrl+G).
  • Save (Ctrl+S).
  • Save All (Shift+Ctrl+S).
  • Reload (Ctrl+R)

Behavior of internal text editor can be configured in preferences.

Finding Files WinSCP

To find files or subdirectories in remote directory1) go to Commands > Find Files.

You will be prompted with Find dialog to specify filter for finding. The results of search will appear in the same dialog.

Searching for text in files is not supported using the Find dialog. But you can use an official extension Search recursively for text in remote directory.

Tips n Tricks PuTTY-WinSCP Import-Export

Tips to export/import putty/Winscp sessions

Exporting your PuTTy saved sessions

1. Click Start->Run and type "RegEdt32" in the "Open" dialog. Click "Ok"

2. Drill into HKEY_CURRENT_USER\Software\SimonTatham

3. Click File->Export. Give your file an appropriate name like, "putty.reg" and click "Save"

4. We're done! Save the putty.reg file somewhere safe. The file doesn't contain any passwords or actual SSH key values so, it's relatively safe from prying eyes. Still, it does contain your configuration and that kind of data is a private matter.

Importing your PuTTy Configuration

1.To import your saved PuTTy configuration on any other Windows computer simply copy your exported registry key, right click on the file and click "Merge
2.Windows will ask you for confirmation that you want to import this set of registry values.

Recommended Links

Google matched content

Softpanorama Recommended

Top articles


Basic Tasks WinSCP

Check the list below to find help for task you want to do with WinSCP:

Also see Guides to using WinSCP.

WinSCP Free SFTP and FTP client for Windows

Automate file transfers (or synchronization) to FTP server or SFTP server WinSCP

Advanced FTP-SFTP scripting WinSCP



Groupthink : Two Party System as Polyarchy : Corruption of Regulators : Bureaucracies : Understanding Micromanagers and Control Freaks : Toxic Managers :   Harvard Mafia : Diplomatic Communication : Surviving a Bad Performance Review : Insufficient Retirement Funds as Immanent Problem of Neoliberal Regime : PseudoScience : Who Rules America : Neoliberalism  : The Iron Law of Oligarchy : Libertarian Philosophy


War and Peace : Skeptical Finance : John Kenneth Galbraith :Talleyrand : Oscar Wilde : Otto Von Bismarck : Keynes : George Carlin : Skeptics : Propaganda  : SE quotes : Language Design and Programming Quotes : Random IT-related quotesSomerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose BierceBernard Shaw : Mark Twain Quotes


Vol 25, No.12 (December, 2013) Rational Fools vs. Efficient Crooks The efficient markets hypothesis : Political Skeptic Bulletin, 2013 : Unemployment Bulletin, 2010 :  Vol 23, No.10 (October, 2011) An observation about corporate security departments : Slightly Skeptical Euromaydan Chronicles, June 2014 : Greenspan legacy bulletin, 2008 : Vol 25, No.10 (October, 2013) Cryptolocker Trojan (Win32/Crilock.A) : Vol 25, No.08 (August, 2013) Cloud providers as intelligence collection hubs : Financial Humor Bulletin, 2010 : Inequality Bulletin, 2009 : Financial Humor Bulletin, 2008 : Copyleft Problems Bulletin, 2004 : Financial Humor Bulletin, 2011 : Energy Bulletin, 2010 : Malware Protection Bulletin, 2010 : Vol 26, No.1 (January, 2013) Object-Oriented Cult : Political Skeptic Bulletin, 2011 : Vol 23, No.11 (November, 2011) Softpanorama classification of sysadmin horror stories : Vol 25, No.05 (May, 2013) Corporate bullshit as a communication method  : Vol 25, No.06 (June, 2013) A Note on the Relationship of Brooks Law and Conway Law


Fifty glorious years (1950-2000): the triumph of the US computer engineering : Donald Knuth : TAoCP and its Influence of Computer Science : Richard Stallman : Linus Torvalds  : Larry Wall  : John K. Ousterhout : CTSS : Multix OS Unix History : Unix shell history : VI editor : History of pipes concept : Solaris : MS DOSProgramming Languages History : PL/1 : Simula 67 : C : History of GCC developmentScripting Languages : Perl history   : OS History : Mail : DNS : SSH : CPU Instruction Sets : SPARC systems 1987-2006 : Norton Commander : Norton Utilities : Norton Ghost : Frontpage history : Malware Defense History : GNU Screen : OSS early history

Classic books:

The Peter Principle : Parkinson Law : 1984 : The Mythical Man-MonthHow to Solve It by George Polya : The Art of Computer Programming : The Elements of Programming Style : The Unix Hater’s Handbook : The Jargon file : The True Believer : Programming Pearls : The Good Soldier Svejk : The Power Elite

Most popular humor pages:

Manifest of the Softpanorama IT Slacker Society : Ten Commandments of the IT Slackers Society : Computer Humor Collection : BSD Logo Story : The Cuckoo's Egg : IT Slang : C++ Humor : ARE YOU A BBS ADDICT? : The Perl Purity Test : Object oriented programmers of all nations : Financial Humor : Financial Humor Bulletin, 2008 : Financial Humor Bulletin, 2010 : The Most Comprehensive Collection of Editor-related Humor : Programming Language Humor : Goldman Sachs related humor : Greenspan humor : C Humor : Scripting Humor : Real Programmers Humor : Web Humor : GPL-related Humor : OFM Humor : Politically Incorrect Humor : IDS Humor : "Linux Sucks" Humor : Russian Musical Humor : Best Russian Programmer Humor : Microsoft plans to buy Catholic Church : Richard Stallman Related Humor : Admin Humor : Perl-related Humor : Linus Torvalds Related humor : PseudoScience Related Humor : Networking Humor : Shell Humor : Financial Humor Bulletin, 2011 : Financial Humor Bulletin, 2012 : Financial Humor Bulletin, 2013 : Java Humor : Software Engineering Humor : Sun Solaris Related Humor : Education Humor : IBM Humor : Assembler-related Humor : VIM Humor : Computer Viruses Humor : Bright tomorrow is rescheduled to a day after tomorrow : Classic Computer Humor

The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

Copyright © 1996-2021 by Softpanorama Society. was initially created as a service to the (now defunct) UN Sustainable Development Networking Programme (SDNP) without any remuneration. This document is an industrial compilation designed and created exclusively for educational use and is distributed under the Softpanorama Content License. Original materials copyright belong to respective owners. Quotes are made for educational purposes only in compliance with the fair use doctrine.

FAIR USE NOTICE This site contains copyrighted material the use of which has not always been specifically authorized by the copyright owner. We are making such material available to advance understanding of computer science, IT technology, economic, scientific, and social issues. We believe this constitutes a 'fair use' of any such copyrighted material as provided by section 107 of the US Copyright Law according to which such material can be distributed without profit exclusively for research and educational purposes.

This is a Spartan WHYFF (We Help You For Free) site written by people for whom English is not a native language. Grammar and spelling errors should be expected. The site contain some broken links as it develops like a living tree...

You can use PayPal to to buy a cup of coffee for authors of this site


The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

Last modified: March 12, 2019