diff options
| author | Xavier Del Campo Romero <xavi.dcr@tutanota.com> | 2023-07-22 04:14:41 +0200 |
|---|---|---|
| committer | Xavier Del Campo Romero <xavi.dcr@tutanota.com> | 2023-11-24 02:08:42 +0100 |
| commit | 15e75d95f3cbe51dc6cc9022e4a93a597309b066 (patch) | |
| tree | 262cb680b0ce84d6fe9b996c7db7e461bd9619e3 /README.md | |
| parent | 73d22e349c4f6cd36323de26b8d31eda6724b52a (diff) | |
| download | slcl-15e75d95f3cbe51dc6cc9022e4a93a597309b066.tar.gz | |
README.md: Update according to thumbnail generation
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 33 |
1 files changed, 31 insertions, 2 deletions
@@ -23,6 +23,9 @@ portability, minimalism, simplicity and efficiency. - Uses [`libweb`](https://gitea.privatedns.org/xavi/libweb), a tiny web framework. - A simple JSON file as the credentials database. - No JavaScript. +- Thumbnail generation can be optionally provided via a +[separate application](thumbnail/README-md) and enabled by `slcl` via a command +line option. Inter-process communication is achieved via a named pipe. ### TLS @@ -123,16 +126,32 @@ anything users put into them. **Note:** `slcl` creates the given directory if it does not exist. +[Generated thumbnails](thumbnail/README.md) are stored into another directory, +namely `thumbnails`, which is automatically created with directory mode bits +set to `0700`. + +``` +. +├── db.json +├── public +├── thumbnails +└── user +``` + A more complete example: ``` . ├── db.json ├── public -│ └── 44e03ab1bc3b0eff1567c76619186596 -> user/alice/file.txt +│ └── 44e03ab1bc3b0eff1567c76619186596 -> user/alice/file.jpg +├── thumbnails +│ ├── alice +│ │ └── file.jpg +│ └── john └── user ├── alice - │ └── file.txt + │ └── file.jpg └── john └── file2.txt ``` @@ -199,6 +218,16 @@ temporary directory to the database, which might be an expensive operation. Therefore, in order to avoid expensive copies, define a custom temporary directory that resides on the same filesystem. +#### Thumbnail generation and rendering + +Optionally, `slcl` displays thumbnails when listing a directory, if available +from the `thumbnails/` directory. In order to update these thumbnails when +files are added/removed to/from the database, a separate application must be +executed. See its [`README.md`](thumbnail/README.md) for further reference. + +`slcl` provides the `-F` command line option to enable the use of a named pipe +that shall be used by the [thumbnail generation tool](thumbnail/). + ## Why this project? Previously, I had been recommended Nextcloud as an alternative to proprietary |
