ffmpeg-normalize 1.32.1__tar.gz → 1.33.1__tar.gz

ffmpeg_normalize-1.33.1/LICENSE.md

@@ -0,0 +1,9 @@
+# License
+
+ffmpeg-normalize, Copyright (c) Werner Robitza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

ffmpeg_normalize-1.33.1/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: ffmpeg-normalize
+Version: 1.33.1
+Summary: Normalize audio via ffmpeg
+Keywords: ffmpeg,normalize,audio
+Author: Werner Robitza
+Author-email: Werner Robitza <werner.robitza@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.md
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: tqdm>=4.64.1
+Requires-Dist: colorama>=0.4.6 ; sys_platform == 'win32'
+Requires-Dist: ffmpeg-progress-yield>=1.0.1
+Requires-Dist: colorlog==6.7.0
+Requires-Dist: mutagen>=1.47.0
+Requires-Python: >=3.9
+Project-URL: Homepage, https://github.com/slhck/ffmpeg-normalize
+Project-URL: Repository, https://github.com/slhck/ffmpeg-normalize
+Description-Content-Type: text/markdown
+
+# ffmpeg-normalize
+
+[![PyPI version](https://img.shields.io/pypi/v/ffmpeg-normalize.svg)](https://pypi.org/project/ffmpeg-normalize)
+![Docker Image Version](https://img.shields.io/docker/v/slhck/ffmpeg-normalize?sort=semver&label=Docker%20image)
+![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/slhck/ffmpeg-normalize/python-package.yml)
+
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-22-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+
+A utility for batch-normalizing audio using ffmpeg.
+
+This program normalizes media files to a certain loudness level using the EBU R128 loudness normalization procedure. It can also perform RMS-based normalization (where the mean is lifted or attenuated), or peak normalization to a certain target level.
+
+## ✨ Features
+
+- EBU R128 loudness normalization (two-pass by default, with an option for one-pass dynamic normalization)
+- RMS-based normalization
+- Peak normalization
+- Video file support
+- Docker support
+- Python API
+
+## 🚀 Quick Start
+
+1. Install a recent version of [ffmpeg](https://ffmpeg.org/download.html)
+2. Run `pip3 install ffmpeg-normalize` and `ffmpeg-normalize /path/to/your/file.mp4`, alternatively install [`uv`](https://docs.astral.sh/uv/getting-started/installation/) and run `uvx ffmpeg-normalize /path/to/your/file.mp4`
+3. Done! 🎧 (the normalized file will be called `normalized/file.mkv`)
+
+## 📓 Documentation
+
+Check out our [documentation](https://slhck.info/ffmpeg-normalize/) for more info!
+
+## 🤝 Contributors
+
+The only reason this project exists in its current form is because [@benjaoming](https://github.com/slhck/ffmpeg-normalize/issues?q=is%3Apr+author%3Abenjaoming)'s initial PRs. Thanks for everyone's support!
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://overtag.dk/"><img src="https://avatars.githubusercontent.com/u/374612?v=4?s=100" width="100px;" alt="Benjamin Balder Bach"/><br /><sub><b>Benjamin Balder Bach</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=benjaoming" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://chaos.social/@eleni"><img src="https://avatars.githubusercontent.com/u/511547?v=4?s=100" width="100px;" alt="Eleni Lixourioti"/><br /><sub><b>Eleni Lixourioti</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=Geekfish" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/thenewguy"><img src="https://avatars.githubusercontent.com/u/77731?v=4?s=100" width="100px;" alt="thenewguy"/><br /><sub><b>thenewguy</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=thenewguy" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/aviolo"><img src="https://avatars.githubusercontent.com/u/560229?v=4?s=100" width="100px;" alt="Anthony Violo"/><br /><sub><b>Anthony Violo</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=aviolo" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://jacobs.af/"><img src="https://avatars.githubusercontent.com/u/952830?v=4?s=100" width="100px;" alt="Eric Jacobs"/><br /><sub><b>Eric Jacobs</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=jetpks" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/kostalski"><img src="https://avatars.githubusercontent.com/u/34033008?v=4?s=100" width="100px;" alt="kostalski"/><br /><sub><b>kostalski</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=kostalski" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://justinppearson.com/"><img src="https://avatars.githubusercontent.com/u/8844823?v=4?s=100" width="100px;" alt="Justin Pearson"/><br /><sub><b>Justin Pearson</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=justinpearson" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Nottt"><img src="https://avatars.githubusercontent.com/u/13532436?v=4?s=100" width="100px;" alt="ad90xa0-aa"/><br /><sub><b>ad90xa0-aa</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=Nottt" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Mathijsz"><img src="https://avatars.githubusercontent.com/u/1891187?v=4?s=100" width="100px;" alt="Mathijs"/><br /><sub><b>Mathijs</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=Mathijsz" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/mpuels"><img src="https://avatars.githubusercontent.com/u/2924816?v=4?s=100" width="100px;" alt="Marc Püls"/><br /><sub><b>Marc Püls</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=mpuels" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://www.mvbattista.com/"><img src="https://avatars.githubusercontent.com/u/158287?v=4?s=100" width="100px;" alt="Michael V. Battista"/><br /><sub><b>Michael V. Battista</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=mvbattista" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://auto-editor.com"><img src="https://avatars.githubusercontent.com/u/57511737?v=4?s=100" width="100px;" alt="WyattBlue"/><br /><sub><b>WyattBlue</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=WyattBlue" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/g3n35i5"><img src="https://avatars.githubusercontent.com/u/17593457?v=4?s=100" width="100px;" alt="Jan-Frederik Schmidt"/><br /><sub><b>Jan-Frederik Schmidt</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=g3n35i5" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/mjhalwa"><img src="https://avatars.githubusercontent.com/u/8994014?v=4?s=100" width="100px;" alt="mjhalwa"/><br /><sub><b>mjhalwa</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=mjhalwa" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/07416"><img src="https://avatars.githubusercontent.com/u/14923168?v=4?s=100" width="100px;" alt="07416"/><br /><sub><b>07416</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=07416" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/sian1468"><img src="https://avatars.githubusercontent.com/u/58017832?v=4?s=100" width="100px;" alt="sian1468"/><br /><sub><b>sian1468</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=sian1468" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/psavva"><img src="https://avatars.githubusercontent.com/u/1454758?v=4?s=100" width="100px;" alt="Panayiotis Savva"/><br /><sub><b>Panayiotis Savva</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=psavva" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/HighMans"><img src="https://avatars.githubusercontent.com/u/42877729?v=4?s=100" width="100px;" alt="HighMans"/><br /><sub><b>HighMans</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=HighMans" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/kanjieater"><img src="https://avatars.githubusercontent.com/u/32607317?v=4?s=100" width="100px;" alt="kanjieater"/><br /><sub><b>kanjieater</b></sub></a><br /><a href="#ideas-kanjieater" title="Ideas, Planning, & Feedback">🤔</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://ahmetsait.com/"><img src="https://avatars.githubusercontent.com/u/8372246?v=4?s=100" width="100px;" alt="Ahmet Sait"/><br /><sub><b>Ahmet Sait</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=ahmetsait" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/georgev93"><img src="https://avatars.githubusercontent.com/u/39860568?v=4?s=100" width="100px;" alt="georgev93"/><br /><sub><b>georgev93</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=georgev93" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://davidbern.com/"><img src="https://avatars.githubusercontent.com/u/371066?v=4?s=100" width="100px;" alt="David Bern"/><br /><sub><b>David Bern</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=odie5533" title="Code">💻</a></td>
+    </tr>
+  </tbody>
+  <tfoot>
+    <tr>
+      <td align="center" size="13px" colspan="7">
+        <img src="https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg">
+          <a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
+        </img>
+      </td>
+    </tr>
+  </tfoot>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->

{ffmpeg_normalize-1.32.1 → ffmpeg_normalize-1.33.1}/README.md

@@ -5,7 +5,7 @@
 ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/slhck/ffmpeg-normalize/python-package.yml)
 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-20-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-22-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 A utility for batch-normalizing audio using ffmpeg.
@@ -14,7 +14,7 @@ This program normalizes media files to a certain loudness level using the EBU R1
 
 ## ✨ Features
 
-- EBU R128 loudness normalization
+- EBU R128 loudness normalization (two-pass by default, with an option for one-pass dynamic normalization)
 - RMS-based normalization
 - Peak normalization
 - Video file support
@@ -24,9 +24,8 @@ This program normalizes media files to a certain loudness level using the EBU R1
 ## 🚀 Quick Start
 
 1. Install a recent version of [ffmpeg](https://ffmpeg.org/download.html)
-2. Run `pip3 install ffmpeg-normalize`
-3. Run `ffmpeg-normalize /path/to/your/file.mp4`
-4. Done! 🎧 (the normalized file will be called `normalized/file.mkv`)
+2. Run `pip3 install ffmpeg-normalize` and `ffmpeg-normalize /path/to/your/file.mp4`, alternatively install [`uv`](https://docs.astral.sh/uv/getting-started/installation/) and run `uvx ffmpeg-normalize /path/to/your/file.mp4`
+3. Done! 🎧 (the normalized file will be called `normalized/file.mkv`)
 
 ## 📓 Documentation
 
@@ -66,6 +65,10 @@ The only reason this project exists in its current form is because [@benjaoming]
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/HighMans"><img src="https://avatars.githubusercontent.com/u/42877729?v=4?s=100" width="100px;" alt="HighMans"/><br /><sub><b>HighMans</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=HighMans" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/kanjieater"><img src="https://avatars.githubusercontent.com/u/32607317?v=4?s=100" width="100px;" alt="kanjieater"/><br /><sub><b>kanjieater</b></sub></a><br /><a href="#ideas-kanjieater" title="Ideas, Planning, & Feedback">🤔</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://ahmetsait.com/"><img src="https://avatars.githubusercontent.com/u/8372246?v=4?s=100" width="100px;" alt="Ahmet Sait"/><br /><sub><b>Ahmet Sait</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=ahmetsait" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/georgev93"><img src="https://avatars.githubusercontent.com/u/39860568?v=4?s=100" width="100px;" alt="georgev93"/><br /><sub><b>georgev93</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=georgev93" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://davidbern.com/"><img src="https://avatars.githubusercontent.com/u/371066?v=4?s=100" width="100px;" alt="David Bern"/><br /><sub><b>David Bern</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=odie5533" title="Code">💻</a></td>
     </tr>
   </tbody>
   <tfoot>

ffmpeg_normalize-1.33.1/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["uv_build>=0.8.14,<0.9.0"]
+build-backend = "uv_build"
+
+[project]
+name = "ffmpeg-normalize"
+version = "1.33.1"
+description = "Normalize audio via ffmpeg"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE.md"]
+authors = [
+    {name = "Werner Robitza", email = "werner.robitza@gmail.com"}
+]
+keywords = ["ffmpeg", "normalize", "audio"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Multimedia :: Sound/Audio",
+    "Topic :: Multimedia :: Sound/Audio :: Analysis",
+    "Topic :: Multimedia :: Sound/Audio :: Conversion",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "tqdm>=4.64.1",
+    "colorama>=0.4.6; platform_system=='Windows'",
+    "ffmpeg-progress-yield>=1.0.1",
+    "colorlog==6.7.0",
+    "mutagen>=1.47.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/slhck/ffmpeg-normalize"
+Repository = "https://github.com/slhck/ffmpeg-normalize"
+
+[project.scripts]
+ffmpeg-normalize = "ffmpeg_normalize.__main__:main"
+
+[tool.uv_build]
+src-layout = true
+
+[dependency-groups]
+dev = [
+    "pytest>=8.1.1,<9",
+    "ruff>=0.12.11",
+    "mypy>=1.0.0",
+    "types-tqdm",
+]
+
+[tool.mypy]
+python_version = "3.13"
+ignore_missing_imports = true
+exclude = ["build"]
+namespace_packages = false
+no_implicit_optional = true
+check_untyped_defs = true
+warn_return_any = true
+warn_unused_ignores = true
+show_error_codes = true

{ffmpeg_normalize-1.32.1 → ffmpeg_normalize-1.33.1/src}/ffmpeg_normalize/__init__.py

@@ -1,8 +1,11 @@
+import importlib.metadata
+
 from ._errors import FFmpegNormalizeError
 from ._ffmpeg_normalize import FFmpegNormalize
 from ._media_file import MediaFile
 from ._streams import AudioStream, MediaStream, SubtitleStream, VideoStream
-from ._version import __version__
+
+__version__ = importlib.metadata.version("ffmpeg-normalize")
 
 __module_name__ = "ffmpeg_normalize"
 

{ffmpeg_normalize-1.32.1 → ffmpeg_normalize-1.33.1/src}/ffmpeg_normalize/__main__.py

@@ -13,7 +13,11 @@ from typing import NoReturn
 from ._errors import FFmpegNormalizeError
 from ._ffmpeg_normalize import NORMALIZATION_TYPES, FFmpegNormalize
 from ._logger import setup_cli_logger
-from ._version import __version__
+
+# Import version from package
+import importlib.metadata
+
+__version__ = importlib.metadata.version("ffmpeg-normalize")
 
 _logger = logging.getLogger(__name__)
 
@@ -52,7 +56,12 @@ def create_parser() -> argparse.ArgumentParser:
     )
 
     group_io = parser.add_argument_group("File Input/output")
-    group_io.add_argument("input", nargs="+", help="Input media file(s)")
+    group_io.add_argument("input", nargs="*", help="Input media file(s)")
+    group_io.add_argument(
+        "--input-list",
+        type=str,
+        help="Path to a text file containing a line-separated list of input files",
+    )
     group_io.add_argument(
         "-o",
         "--output",
@@ -583,7 +592,18 @@ def main() -> None:
             "Will apply default file naming for the remaining ones."
         )
 
-    for index, input_file in enumerate(cli_args.input):
+    # Collect input files from positional args and --input-list
+    input_files = list(cli_args.input) if cli_args.input else []
+    if cli_args.input_list:
+        if not os.path.exists(cli_args.input_list):
+            error(f"Input list file '{cli_args.input_list}' does not exist")
+        with open(cli_args.input_list, "r") as f:
+            input_files.extend([line.strip() for line in f if line.strip()])
+
+    if not input_files:
+        error("No input files specified. Use positional arguments or --input-list.")
+
+    for index, input_file in enumerate(input_files):
         if cli_args.output is not None and index < len(cli_args.output):
             if cli_args.output_folder and cli_args.output_folder != "normalized":
                 _logger.warning(

{ffmpeg_normalize-1.32.1 → ffmpeg_normalize-1.33.1/src}/ffmpeg_normalize/_cmd_utils.py

@@ -75,10 +75,10 @@ class CommandRunner:
         """
         # wrapper for 'ffmpeg-progress-yield'
         _logger.debug(f"Running command: {shlex.join(cmd)}")
-        ff = FfmpegProgress(cmd, dry_run=self.dry)
-        yield from ff.run_command_with_progress()
+        with FfmpegProgress(cmd, dry_run=self.dry) as ff:
+            yield from ff.run_command_with_progress()
 
-        self.output = ff.stderr
+            self.output = ff.stderr
 
         if _logger.getEffectiveLevel() == logging.DEBUG and self.output is not None:
             _logger.debug(

{ffmpeg_normalize-1.32.1 → ffmpeg_normalize-1.33.1/src}/ffmpeg_normalize/_ffmpeg_normalize.py

@@ -63,7 +63,7 @@ class FFmpegNormalize:
         lower_only (bool, optional): Whether the audio should not increase in loudness. Defaults to False.
         auto_lower_loudness_target (bool, optional): Automatically lower EBU Integrated Loudness Target.
         dual_mono (bool, optional): Dual mono. Defaults to False.
-        dynamic (bool, optional): Dynamic. Defaults to False.
+        dynamic (bool, optional): Use dynamic EBU R128 normalization. This is a one-pass algorithm and skips the initial media scan. Defaults to False.
         audio_codec (str, optional): Audio codec. Defaults to "pcm_s16le".
         audio_bitrate (float, optional): Audio bitrate. Defaults to None.
         sample_rate (int, optional): Sample rate. Defaults to None.

{ffmpeg_normalize-1.32.1 → ffmpeg_normalize-1.33.1/src}/ffmpeg_normalize/_media_file.py

@@ -6,7 +6,7 @@ import re
 import shlex
 from shutil import move, rmtree
 from tempfile import mkdtemp
-from typing import TYPE_CHECKING, Iterable, Iterator, Literal, TypedDict
+from typing import TYPE_CHECKING, Iterable, Iterator, Literal, TypedDict, Union
 
 from mutagen.id3 import ID3, TXXX
 from mutagen.mp3 import MP3
@@ -75,10 +75,17 @@ class MediaFile:
         current_ext = os.path.splitext(output_file)[1][1:]
         # we need to check if it's empty, e.g. /dev/null or NUL
         if current_ext == "" or self.output_file == os.devnull:
+            _logger.debug(
+                f"Current extension is unset, or output file is a null device, using extension: {self.ffmpeg_normalize.extension}"
+            )
             self.output_ext = self.ffmpeg_normalize.extension
         else:
+            _logger.debug(
+                f"Current extension is set from output file, using extension: {current_ext}"
+            )
             self.output_ext = current_ext
         self.streams: StreamDict = {"audio": {}, "video": {}, "subtitle": {}}
+        self.temp_file: Union[str, None] = None
 
         self.parse_streams()
 
@@ -200,15 +207,28 @@ class MediaFile:
         """
         _logger.debug(f"Running normalization for {self.input_file}")
 
-        # run the first pass to get loudness stats
-        self._first_pass()
+        # run the first pass to get loudness stats, unless in dynamic EBU mode
+        if not (
+            self.ffmpeg_normalize.dynamic
+            and self.ffmpeg_normalize.normalization_type == "ebu"
+        ):
+            self._first_pass()
+        else:
+            _logger.debug(
+                "Dynamic EBU mode: First pass will not run, as it is not needed."
+            )
+
+        # for second pass, create a temp file
+        temp_dir = mkdtemp()
+        self.temp_file = os.path.join(temp_dir, f"out.{self.output_ext}")
 
-        # shortcut to apply replaygain
         if self.ffmpeg_normalize.replaygain:
-            self._run_replaygain()
-            return
+            _logger.debug(
+                "ReplayGain mode: Second pass will run with temporary file to get stats."
+            )
+            self.output_file = self.temp_file
 
-        # run the second pass as a whole
+        # run the second pass as a whole.
         if self.ffmpeg_normalize.progress:
             with tqdm(
                 total=100,
@@ -222,7 +242,20 @@ class MediaFile:
             for _ in self._second_pass():
                 pass
 
-        _logger.info(f"Normalized file written to {self.output_file}")
+        # remove temp dir; this will remove the temp file as well if it has not been renamed (e.g. for replaygain)
+        if os.path.exists(temp_dir):
+            rmtree(temp_dir, ignore_errors=True)
+
+        # This will use stats from ebu_pass2 if available (from the main second pass),
+        # or fall back to ebu_pass1.
+        if self.ffmpeg_normalize.replaygain:
+            _logger.debug(
+                "ReplayGain tagging is enabled. Proceeding with tag calculation/application."
+            )
+            self._run_replaygain()
+
+        if not self.ffmpeg_normalize.replaygain:
+            _logger.info(f"Normalized file written to {self.output_file}")
 
     def _run_replaygain(self) -> None:
         """
@@ -233,13 +266,32 @@ class MediaFile:
         # get the audio streams
         audio_streams = list(self.streams["audio"].values())
 
-        # get the loudnorm stats from the first pass
-        loudnorm_stats = audio_streams[0].loudness_statistics["ebu_pass1"]
+        # Attempt to use EBU pass 2 statistics, which account for pre-filters.
+        # These are populated by the main second pass if it runs (not a dry run)
+        # and normalization_type is 'ebu'.
+        loudness_stats_source = "ebu_pass2"
+        loudnorm_stats = audio_streams[0].loudness_statistics.get("ebu_pass2")
+
+        if loudnorm_stats is None:
+            _logger.warning(
+                "ReplayGain: Second pass EBU statistics (ebu_pass2) not found. "
+                "Falling back to first pass EBU statistics (ebu_pass1). "
+                "This may not account for pre-filters if any are used."
+            )
+            loudness_stats_source = "ebu_pass1"
+            loudnorm_stats = audio_streams[0].loudness_statistics.get("ebu_pass1")
 
         if loudnorm_stats is None:
-            _logger.error("no loudnorm stats available in first pass stats!")
+            _logger.error(
+                f"ReplayGain: No loudness statistics available from {loudness_stats_source} (and fallback) for stream 0. "
+                "Cannot calculate ReplayGain tags."
+            )
             return
 
+        _logger.debug(
+            f"Using statistics from {loudness_stats_source} for ReplayGain calculation."
+        )
+
         # apply the replaygain tag from the first audio stream (to all audio streams)
         if len(audio_streams) > 1:
             _logger.warning(
@@ -249,23 +301,31 @@ class MediaFile:
             )
 
         target_level = self.ffmpeg_normalize.target_level
-        input_i = loudnorm_stats["input_i"]  # Integrated loudness
-        input_tp = loudnorm_stats["input_tp"]  # True peak
+        # Use 'input_i' and 'input_tp' from the chosen stats.
+        # For ebu_pass2, these are measurements *after* pre-filter but *before* loudnorm adjustment.
+        input_i = loudnorm_stats.get("input_i")
+        input_tp = loudnorm_stats.get("input_tp")
 
         if input_i is None or input_tp is None:
-            _logger.error("no input_i or input_tp available in first pass stats!")
+            _logger.error(
+                f"ReplayGain: 'input_i' or 'input_tp' missing from {loudness_stats_source} statistics. "
+                "Cannot calculate ReplayGain tags."
+            )
             return
 
         track_gain = -(input_i - target_level)  # dB
         track_peak = 10 ** (input_tp / 20)  # linear scale
 
-        _logger.debug(f"Track gain: {track_gain} dB")
-        _logger.debug(f"Track peak: {track_peak}")
+        _logger.debug(f"Calculated Track gain: {track_gain:.2f} dB")
+        _logger.debug(f"Calculated Track peak: {track_peak:.2f}")
 
-        if not self.ffmpeg_normalize.dry_run:
+        if not self.ffmpeg_normalize.dry_run:  # This uses the overall dry_run state
             self._write_replaygain_tags(track_gain, track_peak)
         else:
-            _logger.warning("Dry run used, not actually writing replaygain tags")
+            _logger.warning(
+                "Overall dry_run is enabled, not actually writing ReplayGain tags to the file. "
+                "Tag calculation based on available stats was performed."
+            )
 
     def _write_replaygain_tags(self, track_gain: float, track_peak: float) -> None:
         """
@@ -544,6 +604,10 @@ class MediaFile:
             yield 100
             return
 
+        # track temp_dir for cleanup
+        temp_dir = None
+        temp_file = None
+
         # special case: if output is a null device, write directly to it
         if self.output_file == os.devnull:
             cmd.append(self.output_file)
@@ -554,33 +618,35 @@ class MediaFile:
 
         cmd_runner = CommandRunner()
         try:
-            try:
-                yield from cmd_runner.run_ffmpeg_command(cmd)
-            except Exception as e:
-                _logger.error(
-                    f"Error while running command {shlex.join(cmd)}! Error: {e}"
-                )
-                raise e
-            else:
-                if self.output_file != os.devnull:
-                    _logger.debug(
-                        f"Moving temporary file from {temp_file} to {self.output_file}"
-                    )
-                    move(temp_file, self.output_file)
-                    rmtree(temp_dir, ignore_errors=True)
+            yield from cmd_runner.run_ffmpeg_command(cmd)
         except Exception as e:
-            if self.output_file != os.devnull:
-                rmtree(temp_dir, ignore_errors=True)
+            _logger.error(f"Error while running command {shlex.join(cmd)}! Error: {e}")
             raise e
+        else:
+            # only move the temp file if it's not a null device and ReplayGain is not enabled!
+            if (
+                self.output_file != os.devnull
+                and temp_file
+                and not self.ffmpeg_normalize.replaygain
+            ):
+                _logger.debug(
+                    f"Moving temporary file from {temp_file} to {self.output_file}"
+                )
+                move(temp_file, self.output_file)
+        finally:
+            # clean up temp directory if it was created
+            if temp_dir and os.path.exists(temp_dir):
+                rmtree(temp_dir, ignore_errors=True)
 
         output = cmd_runner.get_output()
         # in the second pass, we do not normalize stream-by-stream, so we set the stats based on the
         # overall output (which includes multiple loudnorm stats)
         if self.ffmpeg_normalize.normalization_type == "ebu":
-            all_stats = AudioStream.prune_and_parse_loudnorm_output(output)
-            for stream_id, audio_stream in self.streams["audio"].items():
-                if stream_id in all_stats:
-                    audio_stream.set_second_pass_stats(all_stats[stream_id])
+            ebu_pass_2_stats = list(
+                AudioStream.prune_and_parse_loudnorm_output(output).values()
+            )
+            for idx, audio_stream in enumerate(self.streams["audio"].values()):
+                audio_stream.set_second_pass_stats(ebu_pass_2_stats[idx])
 
         # warn if self.media_file.ffmpeg_normalize.dynamic == False and any of the second pass stats contain "normalization_type" == "dynamic"
         if self.ffmpeg_normalize.dynamic is False:

{ffmpeg_normalize-1.32.1 → ffmpeg_normalize-1.33.1/src}/ffmpeg_normalize/_streams.py

@@ -65,6 +65,9 @@ class MediaStream:
         self.media_file = media_file
         self.stream_type = stream_type
         self.stream_id = stream_id
+        _logger.debug(
+            f"Created MediaStream for {self.media_file.input_file}, {self.stream_type} stream {self.stream_id}"
+        )
 
     def __repr__(self) -> str:
         return (
@@ -175,6 +178,9 @@ class AudioStream(MediaStream):
         Args:
             stats (dict): The EBU loudness statistics.
         """
+        _logger.debug(
+            f"Setting second pass stats for stream {self.stream_id} from {stats}"
+        )
         self.loudness_statistics["ebu_pass2"] = stats
 
     def get_pcm_codec(self) -> str:
@@ -339,8 +345,9 @@ class AudioStream(MediaStream):
             output (str): The output from ffmpeg.
 
         Returns:
-            list: The EBU loudness statistics.
+            dict[int, EbuLoudnessStatistics]: The EBU loudness statistics.
         """
+        _logger.debug("Parsing loudnorm stats from output")
         pruned_output = CommandRunner.prune_ffmpeg_progress_from_output(output)
         output_lines = [line.strip() for line in pruned_output.split("\n")]
         return AudioStream._parse_loudnorm_output(output_lines)
@@ -359,7 +366,7 @@ class AudioStream(MediaStream):
             FFmpegNormalizeError: When the output could not be parsed.
 
         Returns:
-            EbuLoudnessStatistics: The EBU loudness statistics, if found.
+            dict[int, EbuLoudnessStatistics]: stream index and the EBU loudness statistics, if found.
         """
         result = dict[int, EbuLoudnessStatistics]()
         stream_index = -1
@@ -421,6 +428,28 @@ class AudioStream(MediaStream):
         Return second pass loudnorm filter options string for ffmpeg
         """
 
+        # In dynamic mode, we can do everything in one pass, and we do not have first pass stats
+        if self.media_file.ffmpeg_normalize.dynamic:
+            if not self.ffmpeg_normalize.sample_rate:
+                _logger.warning(
+                    "In dynamic mode, the sample rate will automatically be set to 192 kHz by the loudnorm filter. "
+                    "Specify -ar/--sample-rate to override it."
+                )
+
+            opts = {
+                "i": self.media_file.ffmpeg_normalize.target_level,
+                "lra": self.media_file.ffmpeg_normalize.loudness_range_target,
+                "tp": self.media_file.ffmpeg_normalize.true_peak,
+                "offset": self.media_file.ffmpeg_normalize.offset,
+                "linear": "false",
+                "print_format": "json",
+            }
+
+            if self.media_file.ffmpeg_normalize.dual_mono:
+                opts["dual_mono"] = "true"
+
+            return "loudnorm=" + dict_to_filter_opts(opts)
+
         if not self.loudness_statistics["ebu_pass1"]:
             raise FFmpegNormalizeError(
                 "First pass not run, you must call parse_loudnorm_stats first"
@@ -433,7 +462,7 @@ class AudioStream(MediaStream):
             )
             self.loudness_statistics["ebu_pass1"]["input_i"] = 0
 
-        will_use_dynamic_mode = self.media_file.ffmpeg_normalize.dynamic
+        will_use_dynamic_mode: bool = self.media_file.ffmpeg_normalize.dynamic
 
         if self.media_file.ffmpeg_normalize.keep_loudness_range_target:
             _logger.debug(