NAME

imgcopyright - Easily add copyright information to your images

Coverage Status

SYNOPSYS

Modified copy of images will be placed into a new ci directory within the directory you specify. If no directory is specified, we'll create it in the current working directory. All new images will be prefixed with ci_.

    # set copyright

    imgcopyright -i picture.jpg -n "Steve Bertrand" -e "steveb@cpan.org"

    # all pics in a directory

    imgcopyright -i /home/user/Pictures -n "Steve Bertrand"

    # find images without copyright info

    imgcopyright -i /home/user/Pictures -c

    # specify an alternate output directory

    imgcopyright -i /home/user/Pictures -n "steve" -d ~/mypics

    # replace a previous copyright

    imgcopyright -i picture.jpg -n "steve" -f

DESCRIPTION

This imgcopyright application allows you to add copyright information to the EXIF data within image files. It also allows you to check images for missing copyright info and remove info.

It works on individual files, as well as recurses (top-level only) of a supplied directory.

It does NOT modify the original file (except for remove). We create a subdirectory named ci in whatever path you specify (current working directory if a path is not sent in), and we then take a copy of each original file, modify it, prefix the filename with a ci_, and place it into the new ci directory.

ARGUMENTS

-i, --image

Mandatory in all cases.

Name of a single image file, or a directory containing image files. In the case of a directory, we'll iterate over the top level, and work on all image files found.

-n, --name

Mandatory, unless using --check.

This is the name that will be used in the copyright string for the Copyright EXIF tag, as well as the Creator tag.

-e, --email

Optional.

This is appended to the --name when populating the Creator EXIF tag if it is sent in.

-c, --check

Optional.

Checks for missing Copyright and/or Creator EXIF tags in the image(s) sent in with the --image option.

-d, --dst

Optional.

By default, we use the directory sent in with --image (current working directory if a path isn't provided), and put all modified images in a new ci directory under it.

Send in a directory path with this option and we'll put the image files there instead.

-r, --remove

Optional.

WARNING: This option DOES edit the original file, and does NOT make a copy first.

Removes copyright EXIF information for files sent in with --image.

-f, --force

By default, if an image already has EXIF copyright information, we skip over it and do nothing. Set this option to overwrite any found copyright info.

AUTHOR

Steve Bertrand, <steveb at cpan.org>

LICENSE AND COPYRIGHT

Copyright 2016,2017,2018 Steve Bertrand.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.