|0.1.3||Sep 6, 2021|
|0.1.1||Nov 17, 2019|
|0.1.0||Nov 16, 2019|
#2028 in Command line utilities
This is a command line application to aid in the creation and editing of captions for a gallery of images.
cargo install photo-captioner
Command Line Options:
USAGE: photo-captioner [FLAGS] [OPTIONS] [--] [gallery-dir] FLAGS: -e, --edit whether or not to edit the captions -h, --help Prints help information -V, --version Prints version information OPTIONS: -n, --output-name <output-name> The name of the output file (if there is one). Will be "captions.csv" by default for the "csv" output-type. -t, --output-type <output-type> The type of output, available options: "csv" [default: csv] -c, --view-command <view-command> The command used to launch an image viewer upon editing the caption for an image in order to view the image who's caption is being edited -a, --view-command-args <view-command-args>... The command used to launch an image viewer upon editing the caption for an image in order to view the image who's caption is being edited. Escape dash "-" symbols with a backslash: "\-". For example: -a "\-\-some" "command" ARGS: <gallery-dir> Directory of the gallery to generate captions for
CSV output file:
Building on Windows
Building on Windows currently requires you to select a different backend for the cursive library. Target specific default features doesn't appear to be well supported in cargo/rust at the moment.
You have a few choices, but the one with the least effort required to setup is the crossterm library. To select this for building use the command:
cargo build --no-default-features --features crossterm-backend --release
Using the feh image viewer to preview images while editing captions, and scale them nicely to fit the screen.
photo-captioner -e -c "feh" -a "\-\-scale-down" "\-B" "black" -- /photo/gallery/path
Using Windows Explorer image viewer on Windows to preview images:
photo-captioner -e -c "explorer.exe" -- /photo/gallery/path
Features available are ticked, todo items remain unchecked until completed.
- generate captions.csv file in gallery directory
- gui (terminal ui) editor for editing captions
- update captions.csv with new images
- write/read to jpg exif