Differences

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

2005-06-26 2006-01-10
created (martin) made more general in respect to other encodings (martin)
Line 1: Line 1:
-====== How do I make WinSCP show UTF-8 encoded (Unicode) filenames correctly? ====== +====== How do I make WinSCP show localized and/or UTF-8 encoded (Unicode) filenames correctly? ====== 
-[[protocols#sftp|SFTP protocol]] specification requires that client and server uses UTF-8 encoding (Unicode) for file names only since protocol version 4. So, as long as your server supports at least version 4 of SFTP, WinSCP will show UTF-8 encoded filename correctly automatically. However some implementations use UTF-8 encoding even for older version of protocol. In such case you have to enable UTF-8 manually. See session option //[[ui_login_sftp#protocol_options|Server does not use UTF-8]]//.+[[protocols#sftp|SFTP protocol]] specification requires that client and server uses UTF-8 encoding (Unicode) for file names.
-With [[protocols#scp|SCP protocol]] WinSCP does not support UTF-8 at all.+ WinSCP can operate in two modes, either it expects that the local machine and the server uses the same encoding (no conversion is done) or treats remote filenames as UTF-8 (Unicode) encoded. By default, the first mode is used for [[protocols#sftp|SFTP protocol]] version 3 and lower ((SFTP specification before version 4 has not required UTF-8 explicitly)), the latter mode is used for newer versions. You can force non-default behaviour using session option //[[ui_login_sftp#protocol_options|Server does not use UTF-8]]//. 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 manufacturer for add support for UTF-8, and not ask for support of legacy encoding in WinSCP. 
 + 
 +For [[protocols#scp|SCP protocol]] filename encoding conversion is not supported at all.

Last modified: by martin