Documentation improvements
This commit is contained in:
@@ -1,7 +1,31 @@
|
||||
# FFmpegHDRMetadata
|
||||
# FFmpeg HDR Metadata Extractor
|
||||
|
||||
**FFmpegHDRMetadata** is a HDR metadata extractor that uses **ffprobe** in order to retrive HDR metadata from file, and generates ffmpeg parameters based on it.
|
||||
**FFmpeg HDR Metadata Extractor** is a HDR metadata extractor that uses **ffprobe** in order to retrieve HDR metadata from file, and generates ffmpeg parameters based on it.
|
||||
Specifically it generates comman line parameter for tree codecs available in FFmpeg:
|
||||
- x265
|
||||
- libsvtav1
|
||||
- libaom_av1
|
||||
|
||||
# Pre requirements
|
||||
In order to use this python script you need **python** version 3+ and **ffprobe** binary installed somewhere on your system.
|
||||
## Linux
|
||||
In **Linux** **ffprobe** usually came with **ffmpeg** package in your distribution.
|
||||
## Windows
|
||||
In **Windows**, you should search and install **ffmpeg** package by yourself, good starting point is ffmpeg official site: https://ffmpeg.org/download.html
|
||||
|
||||
# Usage
|
||||
```
|
||||
get_hdr_metadata.py [-h] -i INPUT_FILE [-s INPUT_STREAM] [-e FFPROBE_BINARY]
|
||||
|
||||
options:
|
||||
-h, --help show this help message and exit
|
||||
-i INPUT_FILE, --input-file INPUT_FILE
|
||||
video file name from which hdr metadata needs to be extracted.
|
||||
-s INPUT_STREAM, --input-stream INPUT_STREAM
|
||||
video stream number in the input file, default 0.
|
||||
-e FFPROBE_BINARY, --ffprobe-binary FFPROBE_BINARY
|
||||
specify ffprobe binary to use, default - "ffprobe".
|
||||
```
|
||||
|
||||
On Windows you probably need to specify exact ffprobe.exe binary location.
|
||||
For example: `python get_hdr_metadata.py -e "C:\ffmpeg\ffprobe.exe" -i test.mkv`
|
||||
|
||||
+3
-3
@@ -1,6 +1,6 @@
|
||||
#!/usr/bin/python3
|
||||
|
||||
# FFmpegHDRMetadata is an HDR metadata extractor that uses ffprobe output.
|
||||
# FFmpeg HDR Metadata Extractor is an HDR metadata extractor that uses ffprobe output.
|
||||
# Copyright (C) 2024 Kirill Harmatulla Shakirov
|
||||
#
|
||||
# This program is free software: you can redistribute it and/or modify
|
||||
@@ -229,7 +229,7 @@ if __name__ == '__main__':
|
||||
|
||||
# Initialize arguments parser
|
||||
parser = argparse.ArgumentParser(
|
||||
prog="HDR metadata extractor",
|
||||
prog="get_hdr_metadata.py",
|
||||
description="This program parse HDR metadata from ffprobe output and generates ffmpeg parameters based on it.",
|
||||
epilog="Have a nice day!")
|
||||
|
||||
@@ -243,7 +243,7 @@ if __name__ == '__main__':
|
||||
action="store",
|
||||
type=int,
|
||||
default=0,
|
||||
help="video stream number in the input file, default - 0.",
|
||||
help="video stream number in the input file, default 0.",
|
||||
required=False)
|
||||
|
||||
parser.add_argument("-e", "--ffprobe-binary",
|
||||
|
||||
Reference in New Issue
Block a user