ffmpeg-normalize 1.36.0__tar.gz → 1.36.1__tar.gz

{ffmpeg_normalize-1.36.0 → ffmpeg_normalize-1.36.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffmpeg-normalize
-Version: 1.36.0
+Version: 1.36.1
 Summary: Normalize audio via ffmpeg
 Keywords: ffmpeg,normalize,audio
 Author: Werner Robitza
@@ -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!

{ffmpeg_normalize-1.36.0 → ffmpeg_normalize-1.36.1}/README.md

@@ -22,7 +22,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
 
@@ -67,12 +74,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!

{ffmpeg_normalize-1.36.0 → ffmpeg_normalize-1.36.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "ffmpeg-normalize"
-version = "1.36.0"
+version = "1.36.1"
 description = "Normalize audio via ffmpeg"
 readme = "README.md"
 license = "MIT"

{ffmpeg_normalize-1.36.0 → ffmpeg_normalize-1.36.1}/src/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-1.36.0 → ffmpeg_normalize-1.36.1}/src/ffmpeg_normalize/_cmd_utils.py

@@ -190,3 +190,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-1.36.0 → ffmpeg_normalize-1.36.1}/src/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.