filcuc / thumbnailer Goto Github PK

View Code? Open in Web Editor NEW

11.0 2.0 3.0 130 KB

App for creating thumbnails according to the Linux XDG standard

License: GNU General Public License v3.0

Rust 100.00%

thumbnails xdg xdg-specs nautilus gnome kde dolphin

thumbnailer's Introduction

Thumbnailer

Thumbnailer is an app for creating thumbnails following the XDG standard version 0.8.0.

Useful for creating thumbnails in advance for big folders if you use a file manager complaint with the xdg standard (for example Gnome Nautilus aka "Files" or KDE Dolphin).

Supported features

Creation of normal thumbs
Creation of large thumbs
Saving in XDG directory
Saving original image last modification image in thumb PNG metadata
Threaded image creation
Shared repositories

Usage

Thumbnailer.

Usage:
  thumbnailer [-v] [-r] [--jobs=<num>] (-n|-l|-n -l) (--output=<dir>|-x) <directory>
  thumbnailer [-v] [--jobs=<num>] (-n|-l|-n -l) -s <directory>
  thumbnailer (-h | --help)
  thumbnailer (-v | --verbose)

Options:
  -h --help           Show this screen.
  --version           Show version.
  -v --verbose        Verbose output.
  -r --recursive      Recursive scan.
  -n --normal         Generate normal thumbs.
  -l --large          Generate large thumbs.
  -j --jobs=<num>     Number of parallel jobs [default: 1]
  -o --output=<dir>   Output to custom directory
  -x --xdg            Output to XDG directory
  -s --shared         Output to shared repository directory

Building

cargo build --release

thumbnailer's People

Contributors

Stargazers

Watchers

Forkers

kennylevinsen chrysn-pull-requests stokito

thumbnailer's Issues

Avoid recreating thumbnails if not necessary

If a thumbnail already exists and its modification time matches the source don't create a new thumbnail.

As far I understood only JPEG and PNG are currently supported. https://github.com/filcuc/thumbnailer/blob/master/src/main.rs#L98
Maybe other formats like WEBP aren't needed for now but I'm anyway interested to know possibilities.
Could you please explain from where their support comes from? How many other formats are supported?

Currently I looking for a thumbnailer that will work on OpenWRT on my router and disk space is very limited. So if the underlying image library supports dozens of file formats then I'm afraid that the final binary wont' fit into a small flash disk.

Support XDG thumbnail attributes in created thumbnails

This should store the original image creation timestamp

Handle CTRL-C

Thumb::Uri chunks is not properly escaped

Support shared repositories

See xdg standard for shared repositories

why GPL3?

This is probably the most controversial license
https://en.wikipedia.org/wiki/GNU_General_Public_License#GPLv3_criticism

Shared thumbnail file URI seems incorrect

The URI used for shared thumbnails is relative to file being thumbnailed. E.g., for a picture /home/user/picture.png, a relative URI to the picture would be like so: picture.png. However, thumbnailer uses file://picture.png.

The wording in the spec is rather confusing, but picture.png is what the in-progress glib work uses (https://gitlab.gnome.org/GNOME/glib/-/issues/654), and how the URI RFC defines relative URIs.

(I'll post a PR later.)

Support multi thread thumbnail creation

Move to destination not atomic

When creating thumbnails, thumbnailer creates temporary files in what is returned by std::env::temp_dir() (this will generally be /tmp), and then runs the mv command to move them into place.

Move can only be atomic within the same filesystem, using the rename system call. As /tmp is commonly tmpfs, the move will commonly be crossing filesystem boundaries, this is not possible, and the mv command ends up doing a copy instead.

This renders the entire operation moot, as this copy is no better than just writing straight to the destination in the first place.

The way this is usually dealt with is to use the destination for the temp file using temporary name (e.g. <MD5_OF_URI>_tmp.png or <MD5_OF_URI>.png.tmp).

Fix log verbosity

It's not implemented. Use default rust log library