#image #caption #gallery #image-viewer #command-line

app photo-captioner

一个用于创建和编辑图像画廊标题的工具

3 个版本

0.1.3 2021年9月6日
0.1.1 2019年11月17日
0.1.0 2019年11月16日

命令行工具 中排名第 2727

MIT 许可证

83KB
274

photo-captioner 许可证徽章

这是一个命令行应用程序,用于辅助创建和编辑图像画廊的标题。

edit menu screenshot

安装

cargo install photo-captioner

命令行选项

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 输出文件

Image,Caption
image_filename.jpg,caption

在 Windows 上构建

在 Windows 上构建目前需要您为 cursive 库选择不同的后端。在 cargo/rust 中,似乎不支持特定目标默认功能。

您有几个选择,但设置工作量最小的是 crossterm 库。要选择此库进行构建,请使用以下命令:

cargo build --no-default-features --features crossterm-backend --release

示例

使用 feh 图像查看器在编辑标题时预览图像,并将它们缩放到适合屏幕的大小。

photo-captioner -e -c "feh" -a "\-\-scale-down" "\-B" "black" -- /photo/gallery/path

在 Windows 上使用 Windows 资源管理器图像查看器预览图像

photo-captioner -e -c "explorer.exe" -- /photo/gallery/path

功能

可用的功能已勾选,待办事项直到完成前保持未勾选。

  • 在画廊目录中生成 captions.csv 文件
  • 用于编辑标题的 GUI(终端 UI)编辑器
  • 使用新图像更新 captions.csv
  • 写入/读取 jpg Exif

依赖项

~10MB
~159K SLoC