https://github.com/agateau/pvmetatools
Command-line tools to read/write video metadata
https://github.com/agateau/pvmetatools
Last synced: 3 months ago
JSON representation
Command-line tools to read/write video metadata
- Host: GitHub
- URL: https://github.com/agateau/pvmetatools
- Owner: agateau
- Created: 2012-12-22T16:57:54.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2024-05-05T10:58:14.000Z (over 1 year ago)
- Last Synced: 2025-02-13T19:49:55.611Z (11 months ago)
- Language: Python
- Size: 5.75 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](https://pypa.github.io/pipx/):
```
pipx install https://github.com/agateau/pvmetatools
```
[FFmpeg][] binaries (`ffmpeg`, `ffprobe`) are required to manipulate video files.
[FFmpeg]: https://ffmpeg.org/
## 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 []`
Print metadata for `file`. Print all metadata if `keyword` is not set.
### pvmeta-video-metawrite
`pvmeta-video-metawrite =`
Set metadata for `file`. Multiple `=` arguments are accepted. The original file is renamed to `file.orig`.
### pvmeta-video-adjusttime
`pvmeta-video-adjusttime [...]`
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
```