EXIV2(1)

NAME

exiv2 - Image metadata manipulation tool

1 SYNOPSIS

exiv2 [ option [ arg ] ]+ [ action ] file ...

2 DESCRIPTION

exiv2 is a program to read and write image metadata, including Exif, IPTC, XMP, image comments, ICC Profile, thumbnails, image previews and many vendor makernote tags. The program optionally converts between Exif, IPTC and XMP tags, as recommended by their respective standards/specifications and the Metadata Working Group guidelines.

SYNOPSIS
DESCRIPTION
FILE TYPES
ACTIONS
COMMAND SUMMARY
OPTIONS
EXIV2 GROUPS, TYPES AND VALUES
1. Exiv2 key syntax
2. Exiv2 tags
3. Exif/IPTC/XMP types
4. Multiple elements
5. Duplicate tags
6. Date/Time formats
7. Exif 'Comment' values
8. XMP namespaces
9. XMP LangAlt values
10. XMP structs
PREVIEW IMAGES AND THUMBNAILS
ICC PROFILES
IMAGE COMMENTS
'MODIFY' COMMANDS
1. Quotations with 'modify' commands
2. 'Modify' command format
3. Modifying a value
4. 'Modify' examples
5. 'Modify' command file
CONFIGURATION FILE
EXAMPLES
RETURN VALUE
ENVIRONMENT
NOTES
BUGS
COPYRIGHT
AUTHORS
SEE ALSO

3 FILE TYPES

The following image formats and metadata categories are supported:

Type	Exif	IPTC	XMP	Image Comments	ICC Profile	Thumbnail
ARW	Read/Write	Read/Write	Read/Write	-	Read/Write	Read/Write
AVIF	Read	Read	Read	-	-	Read
BMP	-	-	-	-	-	-
CR2	Read/Write	Read/Write	Read/Write	-	Read/Write	Read/Write
CR3	Read	Read	Read	-	-	Read
CRW	Read/Write	-	-	Read/Write	-	Read/Write
DCP	Read/Write	-	-	-	-	-
DNG	Read/Write	Read/Write	Read/Write	-	Read/Write	Read/Write
EPS	-	-	Read/Write		-	-
EXV	Read/Write	Read/Write	Read/Write	Read/Write	Read/Write	Read/Write
GIF	-	-	-	-	-	-
HEIC	Read	Read	Read	-	-	Read
HEIF	Read	Read	Read	-	-	Read
JP2	Read/Write	Read/Write	Read/Write	-	Read/Write	Read/Write
JPEG	Read/Write	Read/Write	Read/Write	Read/Write	Read/Write	Read/Write
JXL	Read	Read	Read	-	-	Read
MRW	Read	Read	Read	-	-	Read
NEF	Read/Write	Read/Write	Read/Write	-	Read/Write	Read/Write
ORF	Read/Write	Read/Write	Read/Write	-	-	Read/Write
PEF	Read/Write	Read/Write	Read/Write	-	Read/Write	Read/Write
PGF	Read/Write	Read/Write	Read/Write	Read/Write	Read/Write	-
PNG	-	Read/Write	Read/Write	-	Read/Write	Read/Write
PSD	Read/Write	Read/Write	Read/Write	-	-	Read/Write
RAF	Read	Read	Read	-	-	Read
RW2	Read	Read	Read	-	-	Read
SR2	Read	Read	Read	-	-	Read
SRW	Read/Write	Read/Write	Read/Write	-	-	Read/Write
TGA	-	-	-	-	-	-
TIFF	Read/Write	Read/Write	Read/Write	-	Read/Write	Read/Write
WEBP	Read/Write	-	Read/Write	-	Read/Write	Read/Write
XMP	-	-	Read/Write	-	-	-

Support for GIF, TGA and BMP images is minimal: the image format is recognized, a MIME type assigned to it and the height and width of the image are determined.
Reading other TIFF-like RAW image formats, which are not listed in the table, may also work.
Some image formats allow an extra internal type of metadata. Only partial support exists for the RAF format.
Support for BMFF types such as AVIF, CR3, HEIF and HEIC is a build option. To check if this is enabled, use exiv2 --version --verbose --grep bmff and see if enable_bmff=1.
Naked codestream JXL files do not contain Exif, IPTC or XMP metadata.
Support of video files is limited. Currently exiv2 only has some rudimentary support to read metadata from quicktime, matroska and riff based video files (e.g. .MOV/.MP4, .MKV, .AVI, .WAV, .ASF).