Documentation improvements

This commit is contained in:
Nyanraltotlapun
2024-02-07 15:40:54 +01:00
parent 7344161e26
commit 20427fe3d4
2 changed files with 29 additions and 5 deletions
+26 -2
View File
@@ -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
View File
@@ -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",