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:
|
Specifically it generates comman line parameter for tree codecs available in FFmpeg:
|
||||||
- x265
|
- x265
|
||||||
- libsvtav1
|
- libsvtav1
|
||||||
- libaom_av1
|
- 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
|
#!/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
|
# Copyright (C) 2024 Kirill Harmatulla Shakirov
|
||||||
#
|
#
|
||||||
# This program is free software: you can redistribute it and/or modify
|
# This program is free software: you can redistribute it and/or modify
|
||||||
@@ -229,7 +229,7 @@ if __name__ == '__main__':
|
|||||||
|
|
||||||
# Initialize arguments parser
|
# Initialize arguments parser
|
||||||
parser = argparse.ArgumentParser(
|
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.",
|
description="This program parse HDR metadata from ffprobe output and generates ffmpeg parameters based on it.",
|
||||||
epilog="Have a nice day!")
|
epilog="Have a nice day!")
|
||||||
|
|
||||||
@@ -243,7 +243,7 @@ if __name__ == '__main__':
|
|||||||
action="store",
|
action="store",
|
||||||
type=int,
|
type=int,
|
||||||
default=0,
|
default=0,
|
||||||
help="video stream number in the input file, default - 0.",
|
help="video stream number in the input file, default 0.",
|
||||||
required=False)
|
required=False)
|
||||||
|
|
||||||
parser.add_argument("-e", "--ffprobe-binary",
|
parser.add_argument("-e", "--ffprobe-binary",
|
||||||
|
|||||||
Reference in New Issue
Block a user