How do I make WinSCP show localized and/or UTF-8 encoded (Unicode) filenames correctly?

SFTP

SFTP protocol specification requires that client and server uses UTF-8 encoding (Unicode) for file names.

Advertisements:

With the latest release, WinSCP by default uses UTF-8 encoding. You can force non-default behaviour using session option UTF-8 encoding for filenames, particularly when your server does not use UTF-8.

With previous releases, WinSCP by default expects that the local machine and the server uses the same encoding (no conversion is done) for SFTP-3 and lower1), and uses UTF-8 encoding for newer versions. You can force non-default behaviour using session option UTF-8 encoding for filenames. This is useful especially for servers that use UTF-8 natively, thus even for older versions of SFTP.

Please be aware that if your server does not support UTF-8 encoding, but uses its local legacy encoding instead, it is its fault. The problem is not on WinSCP side. You should push your server provider to add support for UTF-8, and not ask for support of legacy encoding in WinSCP.

FTP

For FTP protocol, usage of UTF-8 is also controlled by session option UTF-8 encoding for filenames.

SCP

For SCP protocol filename encoding conversion is not supported at all.

1) SFTP specification before version 4 has not required UTF-8 explicitly.
 
  faq_utf8.txt · Last modified: by prikryl
 

Search Documentation

This page

Donate

About donations

$9   $19   $49   $99

About donations

Recommend

Associations

Site design by Black Gate