diff --git a/CHANGELOG.md b/CHANGELOG.md index 4c9a61f..628fd00 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -16,6 +16,10 @@ FIXME: Released on +- **Explorer Formatter**: + - Added possibility to customize the format when listing files in the explorers (Read more on README) + - Added `file_fmt` key to configuration (if missing, default will be used). + - Added the text input to the Settings view to set the value for `file_fmt`. - Bugfix: - Solved file index in explorer files at start of termscp, in case the first entry is an hidden file - SCP File transfer: when listing directory entries, check if a symlink points to a directory or to a file diff --git a/README.md b/README.md index db87795..cd8e8e7 100644 --- a/README.md +++ b/README.md @@ -30,6 +30,7 @@ FIXME: Current version: 0.3.2 (18/01/2021) - [How do I configure the text editor ๐Ÿฆฅ](#how-do-i-configure-the-text-editor-) - [Configuration โš™๏ธ](#configuration-๏ธ) - [SSH Key Storage ๐Ÿ”](#ssh-key-storage-) + - [File Explorer Format](#file-explorer-format) - [Keybindings โŒจ](#keybindings-) - [Documentation ๐Ÿ“š](#documentation-) - [Known issues ๐Ÿงป](#known-issues-) @@ -292,6 +293,25 @@ You can access the SSH key storage, from configuration moving to the `SSH Keys` > Q: Wait, my private key is protected with password, can I use it? > A: Of course you can. The password provided for authentication in termscp, is valid both for username/password authentication and for RSA key authentication. +### File Explorer Format + +It is possible through configuration to define a custom format for the file explorer. This field, with name `File formatter syntax` will define how the files will be displayed in the file explorer. +The syntax for the formatter is the following `{KEY1}... {KEY2}... {KEYn}...`. +Each key in bracket will be replaced with the related attribute, while everything outside brackets will be left unchanged. +These are the keys supported by the formatter: + +- `ATIME`: Last access time (with syntax `%b %d %Y %H:%M`) +- `CTIME`: Creation time (with syntax `%b %d %Y %H:%M`) +- `GROUP`: Owner group +- `MTIME`: Last change time (with syntax `%b %d %Y %H:%M`) +- `NAME`: File name (Elided if longer than 24) +- `PEX`: File permissions (UNIX format) +- `SIZE`: File size (omitted for directories) +- `SYMLINK`: Symlink (if any `-> {FILE_PATH}`) +- `USER`: Owner user + +If left empty, the default formatter syntax will be used: `{NAME} {PEX} {USER} {SIZE} {MTIME}` + --- ## Keybindings โŒจ