ffmpeg-normalize 1.36.0__py3-none-any.whl → 1.37.0__py3-none-any.whl

ffmpeg_normalize/__init__.py

@@ -1,5 +1,6 @@
 import importlib.metadata
 
+from ._cmd_utils import ffmpeg_env
 from ._errors import FFmpegNormalizeError
 from ._ffmpeg_normalize import FFmpegNormalize
 from ._media_file import MediaFile
@@ -17,5 +18,6 @@ __all__ = [
     "VideoStream",
     "SubtitleStream",
     "MediaStream",
+    "ffmpeg_env",
     "__version__",
 ]

ffmpeg_normalize/__main__.py

@@ -723,6 +723,18 @@ def main() -> None:
     if not input_files:
         error("No input files specified. Use positional arguments or --input-list.")
 
+    # Validate all input files upfront before processing
+    _logger.debug("Validating all input files before processing...")
+    validation_errors = FFmpegNormalize.validate_input_files(input_files)
+    if validation_errors:
+        _logger.error("Validation failed for the following files:")
+        for err in validation_errors:
+            _logger.error(f"  - {err}")
+        error(
+            f"Validation failed for {len(validation_errors)} file(s). "
+            "Please fix the issues above and try again."
+        )
+
     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":

ffmpeg_normalize/_cmd_utils.py

@@ -1,10 +1,12 @@
 from __future__ import annotations
 
+import contextvars
 import logging
 import os
 import re
 import shlex
 import subprocess
+from contextlib import contextmanager
 from shutil import which
 from typing import Any, Iterator
 
@@ -14,6 +16,30 @@ from ._errors import FFmpegNormalizeError
 
 _logger = logging.getLogger(__name__)
 
+_ffmpeg_env_var: contextvars.ContextVar[dict[str, str] | None] = contextvars.ContextVar(
+    "ffmpeg_env", default=None
+)
+
+
+@contextmanager
+def ffmpeg_env(env: dict[str, str] | None) -> Iterator[None]:
+    """
+    Temporarily set the environment for subprocess.Popen.
+
+    Args:
+        env: Environment dict to pass to subprocess.Popen.
+    """
+    token = _ffmpeg_env_var.set(env)
+    try:
+        yield
+    finally:
+        _ffmpeg_env_var.reset(token)
+
+
+def _get_ffmpeg_env() -> dict[str, str] | None:
+    return _ffmpeg_env_var.get()
+
+
 DUR_REGEX = re.compile(
     r"Duration: (?P<hour>\d{2}):(?P<min>\d{2}):(?P<sec>\d{2})\.(?P<ms>\d{2})"
 )
@@ -76,7 +102,9 @@ class CommandRunner:
         # wrapper for 'ffmpeg-progress-yield'
         _logger.debug(f"Running command: {shlex.join(cmd)}")
         with FfmpegProgress(cmd, dry_run=self.dry) as ff:
-            yield from ff.run_command_with_progress()
+            yield from ff.run_command_with_progress(
+                popen_kwargs={"env": _get_ffmpeg_env()}
+            )
 
             self.output = ff.stderr
 
@@ -107,6 +135,7 @@ class CommandRunner:
             stdout=subprocess.PIPE,
             stderr=subprocess.PIPE,
             universal_newlines=False,
+            env=_get_ffmpeg_env(),
         )
 
         stdout_bytes, stderr_bytes = p.communicate()
@@ -190,3 +219,76 @@ def ffmpeg_has_loudnorm() -> bool:
             "Please make sure you are running ffmpeg v4.2 or above."
         )
     return supports_loudnorm
+
+
+def validate_input_file(input_file: str) -> tuple[bool, str | None]:
+    """
+    Validate that an input file exists, is readable, and contains audio streams.
+
+    This function performs a lightweight probe of the file using ffmpeg to check
+    if it can be read and contains at least one audio stream.
+
+    Args:
+        input_file: Path to the input file to validate
+
+    Returns:
+        tuple: (is_valid, error_message)
+            - is_valid: True if the file is valid, False otherwise
+            - error_message: None if valid, otherwise a descriptive error message
+    """
+    # Check if file exists
+    if not os.path.exists(input_file):
+        return False, f"File does not exist: {input_file}"
+
+    # Check if it's actually a file (not a directory)
+    if not os.path.isfile(input_file):
+        return False, f"Path is not a file: {input_file}"
+
+    # Check if file is readable
+    if not os.access(input_file, os.R_OK):
+        return False, f"File is not readable (permission denied): {input_file}"
+
+    # Check if file has audio streams using ffmpeg probe
+    ffmpeg_exe = get_ffmpeg_exe()
+    cmd = [
+        ffmpeg_exe,
+        "-i",
+        input_file,
+        "-c",
+        "copy",
+        "-t",
+        "0",
+        "-map",
+        "0",
+        "-f",
+        "null",
+        os.devnull,
+    ]
+
+    try:
+        output = CommandRunner().run_command(cmd).get_output()
+    except RuntimeError as e:
+        error_str = str(e)
+        # Extract a cleaner error message from ffmpeg output
+        if "Invalid data found" in error_str:
+            return False, f"Invalid or corrupted media file: {input_file}"
+        if "No such file or directory" in error_str:
+            return False, f"File not found or cannot be opened: {input_file}"
+        if "Permission denied" in error_str:
+            return False, f"Permission denied when reading file: {input_file}"
+        if "does not contain any stream" in error_str:
+            return False, f"File contains no media streams: {input_file}"
+        # Generic error for other ffmpeg failures
+        return False, f"Cannot read media file: {input_file}"
+
+    # Check for audio streams in the output
+    has_audio = False
+    for line in output.split("\n"):
+        if line.strip().startswith("Stream") and "Audio" in line:
+            has_audio = True
+            break
+
+    if not has_audio:
+        return False, f"File does not contain any audio streams: {input_file}"
+
+    return True, None

ffmpeg_normalize/_ffmpeg_normalize.py

@@ -9,7 +9,7 @@ from typing import TYPE_CHECKING, Literal
 
 from tqdm import tqdm
 
-from ._cmd_utils import ffmpeg_has_loudnorm, get_ffmpeg_exe
+from ._cmd_utils import ffmpeg_has_loudnorm, get_ffmpeg_exe, validate_input_file
 from ._errors import FFmpegNormalizeError
 from ._media_file import MediaFile
 
@@ -317,6 +317,28 @@ class FFmpegNormalize:
         self.media_files.append(MediaFile(self, input_file, output_file))
         self.file_count += 1
 
+    @staticmethod
+    def validate_input_files(input_files: list[str]) -> list[str]:
+        """
+        Validate all input files before processing.
+
+        This method checks that each input file exists, is readable, and contains
+        at least one audio stream. All files are validated upfront so that users
+        can fix all issues before rerunning the batch.
+
+        Args:
+            input_files: List of input file paths to validate
+
+        Returns:
+            list: List of error messages for invalid files. Empty if all files are valid.
+        """
+        errors = []
+        for input_file in input_files:
+            is_valid, error_msg = validate_input_file(input_file)
+            if not is_valid and error_msg:
+                errors.append(error_msg)
+        return errors
+
     def _calculate_batch_reference(self) -> float | None:
         """
         Calculate the batch reference loudness by averaging measurements across all files.

{ffmpeg_normalize-1.36.0.dist-info → ffmpeg_normalize-1.37.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffmpeg-normalize
-Version: 1.36.0
+Version: 1.37.0
 Summary: Normalize audio via ffmpeg
 Keywords: ffmpeg,normalize,audio
 Author: Werner Robitza
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
 ![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](https://img.shields.io/badge/all_contributors-23-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 A utility for batch-normalizing audio using ffmpeg.
@@ -54,7 +54,14 @@ This program normalizes media files to a certain loudness level using the EBU R1
 - Docker support — Run via Docker container
 - Python API — Use programmatically in your Python projects
 - Shell completions — Available for bash, zsh, and fish
-- Album Batch normalization – Process files jointy, preserving relative loudness
+- Album Batch normalization – Process files jointly, preserving relative loudness
+
+## 🚀 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`)
+
 
 ## 🆕 What's New
 
@@ -99,12 +106,6 @@ Other recent additions:
 
 See the [full changelog](https://github.com/slhck/ffmpeg-normalize/blob/master/CHANGELOG.md) for all updates.
 
-## 🚀 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!
@@ -147,6 +148,7 @@ The only reason this project exists in its current form is because [@benjaoming]
     </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>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/randompersona1"><img src="https://avatars.githubusercontent.com/u/74961116?v=4?s=100" width="100px;" alt="randompersona1"/><br /><sub><b>randompersona1</b></sub></a><br /><a href="https://github.com/slhck/ffmpeg-normalize/commits?author=randompersona1" title="Code">💻</a></td>
     </tr>
   </tbody>
   <tfoot>

{ffmpeg_normalize-1.36.0.dist-info → ffmpeg_normalize-1.37.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
-ffmpeg_normalize/__init__.py,sha256=l0arjiMMBNbiH3IH67gT6SdZjPGAVLAdorUx38dNtvE,508
-ffmpeg_normalize/__main__.py,sha256=4LgOHFwZS0lVcdYptNX4CCPDtG16yfMgUBjgom74FWg,25830
-ffmpeg_normalize/_cmd_utils.py,sha256=1JspVpguAPsq7DqvyvjUNzHhVv8J3X93xNOMwito_jY,5284
+ffmpeg_normalize/__init__.py,sha256=FXJzAZSSg7CTNyicBcY7cOZVnhBsMET80SLdwvzvsY8,561
+ffmpeg_normalize/__main__.py,sha256=U77hAgn7_w2QErUEocf6tal-7v-lJR7GbUQW8L-FmC0,26357
+ffmpeg_normalize/_cmd_utils.py,sha256=A4cFo7sUccV_2OL2yHjZmocvVOj7nf5fiD_6Yw9gSPk,8450
 ffmpeg_normalize/_errors.py,sha256=brTQ4osJ4fTA8wnyMPVVYfGwJ0wqeShRFydTEwi_VEY,48
-ffmpeg_normalize/_ffmpeg_normalize.py,sha256=jCiYhXeV3u8e7sJKOOnGYN5X7stcLv9eg_h_pR-1olM,21372
+ffmpeg_normalize/_ffmpeg_normalize.py,sha256=tcO_nJvsNiucsCJJcMESYsb8GbThcyhniIl21JmxNn0,22190
 ffmpeg_normalize/_logger.py,sha256=3Ap4Fxg7xGrzz7h4IGuNEf0KKstx0Rq_eLbHPrHzcrI,1841
 ffmpeg_normalize/_media_file.py,sha256=awznS5C8ph6Mjy5dzwT-ubBpB3MXwbO94QFcn7mBejY,32197
 ffmpeg_normalize/_presets.py,sha256=AffqFzAHvy0GxCuJl_qd3xknncPJUQx7OXbSfYAw2xg,8852
@@ -11,8 +11,8 @@ ffmpeg_normalize/data/presets/music.json,sha256=rKtIKAD7jlMvnGRsx6QAyPHvrGu-Ecq4
 ffmpeg_normalize/data/presets/podcast.json,sha256=spMBZ_tbfU81NF6o7ZUMyQmQ7kPz3jJ1GKH-hcRmt4s,132
 ffmpeg_normalize/data/presets/streaming-video.json,sha256=Uy4QR0kSla4vXEqctZj26-8f_eS4SQxQWQ9zI_x5QBw,132
 ffmpeg_normalize/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ffmpeg_normalize-1.36.0.dist-info/licenses/LICENSE.md,sha256=ig-_YggmJGbPQC_gUgBNFa0_XMsuHTpocivFnlOF4tE,1082
-ffmpeg_normalize-1.36.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-ffmpeg_normalize-1.36.0.dist-info/entry_points.txt,sha256=1bdrW7-kJRc8tctjnGcfe_Fwx39z5JOm0yZnJHnmwl8,69
-ffmpeg_normalize-1.36.0.dist-info/METADATA,sha256=hXTuiFMbjXW1T2R9n9PPs8n9lF4i3JQfNbIUhPSbRpE,13933
-ffmpeg_normalize-1.36.0.dist-info/RECORD,,
+ffmpeg_normalize-1.37.0.dist-info/licenses/LICENSE.md,sha256=ig-_YggmJGbPQC_gUgBNFa0_XMsuHTpocivFnlOF4tE,1082
+ffmpeg_normalize-1.37.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+ffmpeg_normalize-1.37.0.dist-info/entry_points.txt,sha256=1bdrW7-kJRc8tctjnGcfe_Fwx39z5JOm0yZnJHnmwl8,69
+ffmpeg_normalize-1.37.0.dist-info/METADATA,sha256=SlCoUapWTSJjvsLBcVgxKagK2nHdqfEtaMjbfo-ZT-o,14296
+ffmpeg_normalize-1.37.0.dist-info/RECORD,,