Pvmetatools (Photo Video Metadata Tools) lets you manipulate metadata and filenames of photo and video files.
The simplest way to install it is to use pipx:
pipx install https://github.com/agateau/pvmetatools
FFmpeg binaries (ffmpeg
, ffprobe
) are required to manipulate video files.
Rename photo and video files using the date and time stored in their metadata.
Photos are renamed according to their EXIF information, taking sequence number into account. This relies on the presence of the EXIF.Panasonic.SequenceNumber
tag, so may not work with all cameras.
Photo times are in local time, so the time is use as is.
Video times are usually in UTC timezone. pvmeta-autorename
uses the current timezone to convert the video, unless a different timezone is specified using the --tz
option.
pvmeta-video-metaread <file> [<keyword>]
Print metadata for file
. Print all metadata if keyword
is not set.
pvmeta-video-metawrite <file> <keyword>=<value>
Set metadata for file
. Multiple <keyword>=<value>
arguments are accepted. The original file is renamed to file.orig
.
pvmeta-video-adjusttime <delta> <file1> [<file2>...]
Adjust the creation time of one or more files. delta
is made of a sign, a value and a quantifier. For example "1h", "2m", "2m-30s"
Create a virtualenv:
python -m venv .venv
Activate it:
. ./.venv/bin/activate
Install dependencies:
pip install -e .
pip install -r requirements-dev.txt
Run tests:
pytest