Differences

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

ui_file_panel 2017-08-18		ui_file_panel 2024-02-15 (current)
	Line 14:		Line 14:

	* [[ui_commander#selecting_files\|Selecting files in Commander interface]]		* [[ui_commander#selecting_files\|Selecting files in Commander interface]]
-	* Selecting files in Explorer interface is the same as you know from Windows Explorer.	+	* Selecting files in Explorer interface is the same as you know from Windows File Explorer.

	Commands for selecting files are available from //Mark// menu.		Commands for selecting files are available from //Mark// menu.
	Line 24:		Line 24:
	^ Column ^ Panel ^ Description ^		^ Column ^ Panel ^ Description ^
	\| //Name// \| Both \| File name. \|		\| //Name// \| Both \| File name. \|
-	\| //Size// \| Both \| File size. Display format of the size column can be set in [[ui_pref_panels#common\|preferences]]. ··\|	+	\| //==Size==// \| Both \| File size. Display format of the size column can be set in [[ui_pref_panels#common\|preferences]]. \\ To display ==directory sizes==, select the directories and go to //Files > Calculate directory sizes//. \|
	\| //Type// \| Both \| Description of the file type (if known). \|		\| //Type// \| Both \| Description of the file type (if known). \|
	\| //Changed// \| Both \| Time of the last modification of the file. \|		\| //Changed// \| Both \| Time of the last modification of the file. \|
	\| //Attr// \| Local \| File attributes. ''a'' stands for archive, ''r'' for read-only, ''h'' for hidden, ''c'' for compressed, ''s'' for system. \|		\| //Attr// \| Local \| File attributes. ''a'' stands for archive, ''r'' for read-only, ''h'' for hidden, ''c'' for compressed, ''s'' for system. \|
-	\| //Rights// \| Remote \| File permissions. \\ Usually three groups of three letters. The first group for owner, the second for group and the last for others (so called world). ''r'' stands for read, ''w'' for write and ''x'' for execute (for directories it means permissions to open/enter the directory). \\ With FTP protocol: If the server does not support UNIX-style permissions, permissions can be displayed in format defined by RFC 3659 ([[https://tools.ietf.org/html/rfc3659#section-7.5.5\|Perm fact]]). \\ With WebDAV protocol: UNIX-style permissions are not supported. //Locked// keyword or 🔒 (lock icon) &win8 is displayed for [[task_lock\|locked files]]. //Executable// keyword or ⚙ (gear icon) &win8 can be displayed for executable files.((mod_dav Apache module only.)) \|	+	\| //==Rights==// \| Remote \| File permissions. \\ Usually three groups of three letters. The first group for owner, the second for group and the last for others (so called world). ''r'' stands for read, ''w'' for write and ''x'' for execute (for directories it means permissions to open/enter the directory). \\ With FTP protocol: If the server does not support UNIX-style permissions, permissions can be displayed in format defined by RFC 3659 ([[https://datatracker.ietf.org/doc/html/rfc3659#section-7.5.5\|Perm fact]]). \\ With WebDAV protocol: UNIX-style permissions are not supported. //Locked// keyword or 🔒 (lock icon) &win8 is displayed for [[task_lock\|locked files]]. //Executable// keyword or ⚙ (gear icon) &win8 can be displayed for executable files.((mod_dav Apache module only.)) \|
	\| //Owner// \| Remote \| File owner. \|		\| //Owner// \| Remote \| File owner. \|
	\| //Group// \| Remote \| File group. \|		\| //Group// \| Remote \| File group. \|
	Line 34:		Line 34:

	To show/hide columns use [[ui_context_menu\|context menu]] of the column titles. Alternatively use the main menu		To show/hide columns use [[ui_context_menu\|context menu]] of the column titles. Alternatively use the main menu
-	(//View > Show Columns// in [[ui_explorer\|Explorer interface]],	+	(//View > Columns// in [[ui_explorer\|Explorer interface]],
-	//Local (Remote) > Show Columns// in [[ui_commander\|Commander interface]]).	+	//Local/Remote/Left/Right > Columns// in [[ui_commander\|Commander interface]]).

-	To change column order, drag the column title. To change column width, drag the separator between the column titles.	+	To change column order, drag the column title.

-	Note that the SFTP servers may not provide all file attributes in directory listing (like owner and group). To force WinSCP to explicitly request them, invoke [[ui_properties\|Properties dialog]].	+	To change column ==width==, drag the separator between the column titles. To automatically size all columns to fit their contents, use //Columns > Size Automatically// in context menu of the column titles. To reset the original columns layout (including their visibility, order and width), use //Reset Layout// command in the same menu. The commands are also available in the main menu (//View > Columns// in [[ui_explorer\|Explorer interface]], //Local/Remote/Left/Right > Columns// in [[ui_commander\|Commander interface]]).
		+
		+	Note that some SFTP servers may not provide all file attributes in directory listing (like owner and group). To force WinSCP to explicitly request them, invoke [[ui_properties\|Properties dialog]].

	===== [[directory_tree]] Directory Tree =====		===== [[directory_tree]] Directory Tree =====
	Line 48:		Line 50:
	To show/hide the tree use keyboard shortcut ''Ctrl+Alt+T'', toolbar button or the main menu		To show/hide the tree use keyboard shortcut ''Ctrl+Alt+T'', toolbar button or the main menu
	(//View > Tree// in [[ui_explorer\|Explorer interface]],		(//View > Tree// in [[ui_explorer\|Explorer interface]],
-	//Options / Local (Remote) Panel > Tree// in [[ui_commander\|Commander interface]]).	+	//Options > Left/Right Panel > Tree// in [[ui_commander\|Commander interface]]).

	===== [[sorting_files]] Sorting Files =====		===== [[sorting_files]] Sorting Files =====
	Line 60:		Line 62:
	Alternatively the sorting can be set from the main menu		Alternatively the sorting can be set from the main menu
	(//View > Sort// in [[ui_explorer\|Explorer interface]],		(//View > Sort// in [[ui_explorer\|Explorer interface]],
-	//Local (Remote) > Sort// in [[ui_commander\|Commander interface]]).	+	//Local/Remote/Left/Right > Sort// in [[ui_commander\|Commander interface]]).
		+
		+	By default files are sorted using natural order numerical sorting (e.g. “2” comes before “11”). To switch to pure alphabetical sorting (e.g. “2” comes after “11”), uncheck the //Use natural order numerical sorting// on the [[ui_pref_panels\|//Panels// page]] of Preferences dialog. On the same preferences page, you can also opt to //Always sort directories by name//.

	===== [[filtering]] Filtering =====		===== [[filtering]] Filtering =====
	Line 67:		Line 71:

	Enable filtering from main menu (//View > Filter// in [[ui_explorer\|Explorer interface]],		Enable filtering from main menu (//View > Filter// in [[ui_explorer\|Explorer interface]],
-	//Local (Remote) > Filter// in [[ui_commander\|Commander interface]]). [[ui_filter\|Filter dialog]] will appear.	+	//Local/Remote/Left/Right > Filter// in [[ui_commander\|Commander interface]]). [[ui_filter\|Filter dialog]] will appear.

	Number of files filtered out (if any) is displayed on status bar. In [[ui_commander\|Commander interface]], current filter is shown on [[#path_label\|path label]].		Number of files filtered out (if any) is displayed on status bar. In [[ui_commander\|Commander interface]], current filter is shown on [[#path_label\|path label]].
		+
		+	===== [[incremental_search]] Incremental Search =====
		+
		+	You can incrementally search for a file in the active panel by typing a part of its name. Then you can use ''Tab'' (or ''Shift-Tab'') to search the next (previous) matching files. Press ''Esc'' to cancel searching. On [[ui_pref_panels\|//Panels page// of Preferences dialog]], you can select different modes of the incremental search.

	===== [[path_label]] Path Label =====		===== [[path_label]] Path Label =====
	Line 78:		Line 86:

	===== [[view_style]] View Style =====		===== [[view_style]] View Style =====
-	In [[ui_explorer\|Explorer interface]] you can change view style of the file panel. The styles are the same as you know from Windows Explorer: large icons, small icons, list and details. To change style use //View// menu or toolbar icon.	+	In [[ui_explorer\|Explorer interface]] you can change view style of the file panel. The styles are the same as you know from Windows File Explorer: large icons, small icons, list and details. To change style use //View// menu or toolbar icon.

	The [[ui_commander\|Commander interface]] allows only details view for both panels.		The [[ui_commander\|Commander interface]] allows only details view for both panels.

	===== [[special_files]] Special Files =====		===== [[special_files]] Special Files =====
-
	&screenshotpict(special_files)		&screenshotpict(special_files)

-	At some files you can see special overlay image on their icon. There are tree types:	+	==== Overlay Images ====
-	* Arrow on the white square - [[task_link\|Symbolic link]] (remote panel) or shortcut (local panel).	+
-	* Arrow on the red square - Broken symbolic link (remote panel only).	+	At some files you can see a special overlay image on their icon. There are four types:
-	* Torn sheet (or file) - Partial file (remnant of an [[resume\|interrupted transfer]]).	+	* Arrow on the white square: [[task_link\|Symbolic link]] (remote panel) or shortcut (local panel).
		+	* Arrow on the red square: Broken symbolic link (remote panel only).
		+	* Torn sheet (or file): Partial file (remnant of an [[resume\|interrupted transfer]]).
		+	* Lock: [[file_encryption\|Encrypted file]] (remote panel only).
		+
		+	==== [[hidden_files]] Hidden Files ====
		+
		+	Some files are rendered in gray color. It denotes hidden file, i.e. the file that should not be generally visible to user. Thus WinSCP by default does not show such files. You can display them using //[[ui_pref_panels#common\|Show hidden files]]// on //Panels page// of Preferences dialog. If some files are hidden, their number is indicated on status bar (clicking that display also shows them).
		+
		+	Note that with FTP protocol some servers do not list hidden files when ''[[ui_login_ftp#protocol_options\|MLSD]]'' command is used. You may need to disable ''MLSD'' to switch to ''LIST'' and make sure that [[ui_login_ftp#protocol_options\|''-a'' switch is used]].
		+
		+	===== [[file_colors]] File Colors =====
		+
		+	On [[ui_pref_file_colors\|//File Colors// page of Preferences dialog]], you can define rules to color files in file panels according to a [[file_mask\|file mask]].
		+
		+	===== [[disconnected]] Disconnected Panel =====

-	Some files are rendered in gray color. It denotes hidden file, i.e. the file that should not be generally visible to user. Thus WinSCP by default does not show such files. You can display them using //[[ui_pref_panels#common\|Show hidden files]]// on //Panels page// of Preferences dialog. If some files are hidden, their number is indicated on status bar. Note that with FTP protocol some servers do not list hidden files when ''[[ui_login_ftp#protocol_options\|MLSD]]'' command is used. You may need to disable ''MLSD'' to switch to ''LIST'' and make sure that ''-a'' [[ui_login_ftp#protocol_options\|switch is used]].	+	A remote file panel of a [[task_connections#closing\|disconnected session]] features //Reconnect// button, that can be used to reconnect the session.

ui_file_panel 2017-08-18		ui_file_panel 2024-02-15 (current)
	Line 14:		Line 14:

	* [[ui_commander#selecting_files\|Selecting files in Commander interface]]		* [[ui_commander#selecting_files\|Selecting files in Commander interface]]
-	* Selecting files in Explorer interface is the same as you know from Windows Explorer.	+	* Selecting files in Explorer interface is the same as you know from Windows File Explorer.

	Commands for selecting files are available from //Mark// menu.		Commands for selecting files are available from //Mark// menu.
	Line 24:		Line 24:
	^ Column ^ Panel ^ Description ^		^ Column ^ Panel ^ Description ^
	\| //Name// \| Both \| File name. \|		\| //Name// \| Both \| File name. \|
-	\| //Size// \| Both \| File size. Display format of the size column can be set in [[ui_pref_panels#common\|preferences]]. ··\|	+	\| //==Size==// \| Both \| File size. Display format of the size column can be set in [[ui_pref_panels#common\|preferences]]. \\ To display ==directory sizes==, select the directories and go to //Files > Calculate directory sizes//. \|
	\| //Type// \| Both \| Description of the file type (if known). \|		\| //Type// \| Both \| Description of the file type (if known). \|
	\| //Changed// \| Both \| Time of the last modification of the file. \|		\| //Changed// \| Both \| Time of the last modification of the file. \|
	\| //Attr// \| Local \| File attributes. ''a'' stands for archive, ''r'' for read-only, ''h'' for hidden, ''c'' for compressed, ''s'' for system. \|		\| //Attr// \| Local \| File attributes. ''a'' stands for archive, ''r'' for read-only, ''h'' for hidden, ''c'' for compressed, ''s'' for system. \|
-	\| //Rights// \| Remote \| File permissions. \\ Usually three groups of three letters. The first group for owner, the second for group and the last for others (so called world). ''r'' stands for read, ''w'' for write and ''x'' for execute (for directories it means permissions to open/enter the directory). \\ With FTP protocol: If the server does not support UNIX-style permissions, permissions can be displayed in format defined by RFC 3659 ([[https://tools.ietf.org/html/rfc3659#section-7.5.5\|Perm fact]]). \\ With WebDAV protocol: UNIX-style permissions are not supported. //Locked// keyword or 🔒 (lock icon) &win8 is displayed for [[task_lock\|locked files]]. //Executable// keyword or ⚙ (gear icon) &win8 can be displayed for executable files.((mod_dav Apache module only.)) \|	+	\| //==Rights==// \| Remote \| File permissions. \\ Usually three groups of three letters. The first group for owner, the second for group and the last for others (so called world). ''r'' stands for read, ''w'' for write and ''x'' for execute (for directories it means permissions to open/enter the directory). \\ With FTP protocol: If the server does not support UNIX-style permissions, permissions can be displayed in format defined by RFC 3659 ([[https://datatracker.ietf.org/doc/html/rfc3659#section-7.5.5\|Perm fact]]). \\ With WebDAV protocol: UNIX-style permissions are not supported. //Locked// keyword or 🔒 (lock icon) &win8 is displayed for [[task_lock\|locked files]]. //Executable// keyword or ⚙ (gear icon) &win8 can be displayed for executable files.((mod_dav Apache module only.)) \|
	\| //Owner// \| Remote \| File owner. \|		\| //Owner// \| Remote \| File owner. \|
	\| //Group// \| Remote \| File group. \|		\| //Group// \| Remote \| File group. \|
	Line 34:		Line 34:

	To show/hide columns use [[ui_context_menu\|context menu]] of the column titles. Alternatively use the main menu		To show/hide columns use [[ui_context_menu\|context menu]] of the column titles. Alternatively use the main menu
-	(//View > Show Columns// in [[ui_explorer\|Explorer interface]],	+	(//View > Columns// in [[ui_explorer\|Explorer interface]],
-	//Local (Remote) > Show Columns// in [[ui_commander\|Commander interface]]).	+	//Local/Remote/Left/Right > Columns// in [[ui_commander\|Commander interface]]).

-	To change column order, drag the column title. To change column width, drag the separator between the column titles.	+	To change column order, drag the column title.

-	Note that the SFTP servers may not provide all file attributes in directory listing (like owner and group). To force WinSCP to explicitly request them, invoke [[ui_properties\|Properties dialog]].	+	To change column ==width==, drag the separator between the column titles. To automatically size all columns to fit their contents, use //Columns > Size Automatically// in context menu of the column titles. To reset the original columns layout (including their visibility, order and width), use //Reset Layout// command in the same menu. The commands are also available in the main menu (//View > Columns// in [[ui_explorer\|Explorer interface]], //Local/Remote/Left/Right > Columns// in [[ui_commander\|Commander interface]]).
		+
		+	Note that some SFTP servers may not provide all file attributes in directory listing (like owner and group). To force WinSCP to explicitly request them, invoke [[ui_properties\|Properties dialog]].

	===== [[directory_tree]] Directory Tree =====		===== [[directory_tree]] Directory Tree =====
	Line 48:		Line 50:
	To show/hide the tree use keyboard shortcut ''Ctrl+Alt+T'', toolbar button or the main menu		To show/hide the tree use keyboard shortcut ''Ctrl+Alt+T'', toolbar button or the main menu
	(//View > Tree// in [[ui_explorer\|Explorer interface]],		(//View > Tree// in [[ui_explorer\|Explorer interface]],
-	//Options / Local (Remote) Panel > Tree// in [[ui_commander\|Commander interface]]).	+	//Options > Left/Right Panel > Tree// in [[ui_commander\|Commander interface]]).

	===== [[sorting_files]] Sorting Files =====		===== [[sorting_files]] Sorting Files =====
	Line 60:		Line 62:
	Alternatively the sorting can be set from the main menu		Alternatively the sorting can be set from the main menu
	(//View > Sort// in [[ui_explorer\|Explorer interface]],		(//View > Sort// in [[ui_explorer\|Explorer interface]],
-	//Local (Remote) > Sort// in [[ui_commander\|Commander interface]]).	+	//Local/Remote/Left/Right > Sort// in [[ui_commander\|Commander interface]]).
		+
		+	By default files are sorted using natural order numerical sorting (e.g. “2” comes before “11”). To switch to pure alphabetical sorting (e.g. “2” comes after “11”), uncheck the //Use natural order numerical sorting// on the [[ui_pref_panels\|//Panels// page]] of Preferences dialog. On the same preferences page, you can also opt to //Always sort directories by name//.

	===== [[filtering]] Filtering =====		===== [[filtering]] Filtering =====
	Line 67:		Line 71:

	Enable filtering from main menu (//View > Filter// in [[ui_explorer\|Explorer interface]],		Enable filtering from main menu (//View > Filter// in [[ui_explorer\|Explorer interface]],
-	//Local (Remote) > Filter// in [[ui_commander\|Commander interface]]). [[ui_filter\|Filter dialog]] will appear.	+	//Local/Remote/Left/Right > Filter// in [[ui_commander\|Commander interface]]). [[ui_filter\|Filter dialog]] will appear.

	Number of files filtered out (if any) is displayed on status bar. In [[ui_commander\|Commander interface]], current filter is shown on [[#path_label\|path label]].		Number of files filtered out (if any) is displayed on status bar. In [[ui_commander\|Commander interface]], current filter is shown on [[#path_label\|path label]].
		+
		+	===== [[incremental_search]] Incremental Search =====
		+
		+	You can incrementally search for a file in the active panel by typing a part of its name. Then you can use ''Tab'' (or ''Shift-Tab'') to search the next (previous) matching files. Press ''Esc'' to cancel searching. On [[ui_pref_panels\|//Panels page// of Preferences dialog]], you can select different modes of the incremental search.

	===== [[path_label]] Path Label =====		===== [[path_label]] Path Label =====
	Line 78:		Line 86:

	===== [[view_style]] View Style =====		===== [[view_style]] View Style =====
-	In [[ui_explorer\|Explorer interface]] you can change view style of the file panel. The styles are the same as you know from Windows Explorer: large icons, small icons, list and details. To change style use //View// menu or toolbar icon.	+	In [[ui_explorer\|Explorer interface]] you can change view style of the file panel. The styles are the same as you know from Windows File Explorer: large icons, small icons, list and details. To change style use //View// menu or toolbar icon.

	The [[ui_commander\|Commander interface]] allows only details view for both panels.		The [[ui_commander\|Commander interface]] allows only details view for both panels.

	===== [[special_files]] Special Files =====		===== [[special_files]] Special Files =====
-
	&screenshotpict(special_files)		&screenshotpict(special_files)

-	At some files you can see special overlay image on their icon. There are tree types:	+	==== Overlay Images ====
-	* Arrow on the white square - [[task_link\|Symbolic link]] (remote panel) or shortcut (local panel).	+
-	* Arrow on the red square - Broken symbolic link (remote panel only).	+	At some files you can see a special overlay image on their icon. There are four types:
-	* Torn sheet (or file) - Partial file (remnant of an [[resume\|interrupted transfer]]).	+	* Arrow on the white square: [[task_link\|Symbolic link]] (remote panel) or shortcut (local panel).
		+	* Arrow on the red square: Broken symbolic link (remote panel only).
		+	* Torn sheet (or file): Partial file (remnant of an [[resume\|interrupted transfer]]).
		+	* Lock: [[file_encryption\|Encrypted file]] (remote panel only).
		+
		+	==== [[hidden_files]] Hidden Files ====
		+
		+	Some files are rendered in gray color. It denotes hidden file, i.e. the file that should not be generally visible to user. Thus WinSCP by default does not show such files. You can display them using //[[ui_pref_panels#common\|Show hidden files]]// on //Panels page// of Preferences dialog. If some files are hidden, their number is indicated on status bar (clicking that display also shows them).
		+
		+	Note that with FTP protocol some servers do not list hidden files when ''[[ui_login_ftp#protocol_options\|MLSD]]'' command is used. You may need to disable ''MLSD'' to switch to ''LIST'' and make sure that [[ui_login_ftp#protocol_options\|''-a'' switch is used]].
		+
		+	===== [[file_colors]] File Colors =====
		+
		+	On [[ui_pref_file_colors\|//File Colors// page of Preferences dialog]], you can define rules to color files in file panels according to a [[file_mask\|file mask]].
		+
		+	===== [[disconnected]] Disconnected Panel =====

-	Some files are rendered in gray color. It denotes hidden file, i.e. the file that should not be generally visible to user. Thus WinSCP by default does not show such files. You can display them using //[[ui_pref_panels#common\|Show hidden files]]// on //Panels page// of Preferences dialog. If some files are hidden, their number is indicated on status bar. Note that with FTP protocol some servers do not list hidden files when ''[[ui_login_ftp#protocol_options\|MLSD]]'' command is used. You may need to disable ''MLSD'' to switch to ''LIST'' and make sure that ''-a'' [[ui_login_ftp#protocol_options\|switch is used]].	+	A remote file panel of a [[task_connections#closing\|disconnected session]] features //Reconnect// button, that can be used to reconnect the session.

Differences

Documentation

Support

Associations

Follow Us