mirror of
https://github.com/veeso/termscp.git
synced 2026-07-14 12:03:52 +02:00
50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
{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:
|
|
|
|
```text
|
|
{NAME:24} {PEX} {USER} {SIZE} {MTIME:17:%b %d %Y %H:%M}
|
|
```
|