Skip to content

agateau/pvmetatools

Repository files navigation

Pvmetatools

Pvmetatools (Photo Video Metadata Tools) lets you manipulate metadata and filenames of photo and video files.

Installation

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.

Available tools

pvmeta-autorename

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

pvmeta-video-metaread <file> [<keyword>]

Print metadata for file. Print all metadata if keyword is not set.

pvmeta-video-metawrite

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

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"

Working on the project

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

About

Command-line tools to read/write video metadata

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published