Skip to content

Latest commit

 

History

History
110 lines (73 loc) · 2.29 KB

README.md

File metadata and controls

110 lines (73 loc) · 2.29 KB

ImagerNamer-Go Documentation

Command Line Interface

Rename

Usage

imagenamer-go rename [arguments] [flags]

Descriptipon

Use this command to rename images in directories after your configuration in your config file. Provide the paths as an argument.

Options

  -e, --exclude strings   Exclude folders in given paths
  -h, --help              help for rename
  -s, --safe              Disable or enable safe rename function (default: true)
  -y, --yes               Confirm all question with yes (default: false)

Global Options

      --config string   ocation of the configuration file (default: $HOME/.imagenamer/config.yaml)
      --debug           Show debug messages
  -h, --help            help for imagenamer-go
  -v, --version         version for imagenamer-go

Configuration

In the configuration file you can change default values to adjust to your perfect use cause and preferences. It will be automatically generated by the first startup of the program and can be found under $HOME/.imagenamer-go/config.yaml.

Template

With template you determine how your file will be renamed. Note that no file extensions may be included. You can insert values in the file name with the following commands:

{{.CameraModel}} - Camera model {{.DateTime}} - Original datetime (Format: yyyyMMdd_HHmmss)

Example:

Template: IMG_{{.DateTime}}_{{.CameraModel}}

Output: IMG_20210423_175628_Pixel3a.jpg

Extensions

In extensions it is specified which file extensions are used to rename images. Only images with this file extensions can be renamed.

Example:

Extensions:

- .jpg
- .png

Output:

test.jpg         true
test.cr2         false
test.png         true
test.txt         false

Safe Strings

In Safe Strings you specifie strings. If file names contains this strings and Safe Rename is enabled this images will be not renamed.

Example:

Safe Strings:

- test
- IMG

Output:

test_image.jpg    true
image.jpg         false
IMG_image.png     true
tes.png           false

Copy Separator

The copy_separator specifies which character is to be used to separate the copy number from the file name.

Example:

copy_separator: "~"

Output:

test_image.jpg
test_image~1.jpg
test_image~2.jpg
test.jpg