Files
termscp/docs/en-US/configuration/explorer-format.md
2026-06-08 10:16:00 +02:00

2.4 KiB

File explorer format

You can define a custom format for the file explorer through the configuration. This is possible for both the local and the remote host, so you can use two different syntaxes. The fields are named File formatter syntax (local) and File formatter syntax (remote), and they define how the file entries are displayed in the file explorer.

Syntax

The syntax for the formatter is the following:

{KEY1}... {KEY2:LENGTH}... {KEY3:LENGTH:EXTRA} {KEYn}...

Each key in braces is replaced with the related attribute, while everything outside braces is left unchanged.

  • The key name is mandatory and must be one of the keys below.
  • LENGTH describes the width reserved to display the field. Static attributes do not support it (GROUP, PEX, SIZE, USER).
  • EXTRA is supported only by some keys and provides an additional option. See the keys below to check whether EXTRA is supported.

Keys

These are the keys supported by the formatter:

Key Description
ATIME Last access time (default %b %d %Y %H:%M); EXTRA is the time format (e.g. {ATIME:8:%H:%M})
CTIME Creation time (default %b %d %Y %H:%M); EXTRA is the time format (e.g. {CTIME:8:%H:%M})
GROUP Owner group
MTIME Last change time (default %b %d %Y %H:%M); EXTRA is the time format (e.g. {MTIME:8:%H:%M})
NAME File name (folders between root and first ancestors are elided if longer than LENGTH)
PATH File absolute path (folders between root and first ancestors are elided if longer than LENGTH)
PEX File permissions (UNIX format)
SIZE File size (omitted for directories)
SYMLINK Symlink target (if any, -> {FILE_PATH})
USER Owner user

Default format

If left empty, the default formatter syntax is used:

{NAME:24} {PEX} {USER} {SIZE} {MTIME:17:%b %d %Y %H:%M}