feat: add --ffprobe-path option

Allow specifying a custom path to the ffprobe executable via CLI
and API for environments where ffprobe is not in the default PATH.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: slhck

README.md

@@ -123,7 +123,7 @@ It will show a progress bar, and once the command is done, show the ffmpeg stder
 Full usage notes:
 
 ```
-usage: ffmpeg-progress-yield [-h] [-d DURATION] [-n] [-p] [-x] [-l LOG_FILE] ...
+usage: ffmpeg-progress-yield [-h] [-d DURATION] [-n] [-p] [-x] [-l LOG_FILE] [--ffprobe-path FFPROBE_PATH] ...
 
 ffmpeg-progress-yield v0.12.0
 
@@ -140,6 +140,8 @@ options:
                         Exclude progress lines from ffmpeg log. (default: False)
   -l, --log-file LOG_FILE
                         Send ffmpeg log output to specified file. (default: None)
+  --ffprobe-path FFPROBE_PATH
+                        Path to ffprobe executable (for duration probing). (default: ffprobe)
 ```
 
 #### Duration override

src/ffmpeg_progress_yield/__main__.py

@@ -37,6 +37,12 @@ def main() -> None:
         type=str,
         help="Send ffmpeg log output to specified file.",
     )
+    parser.add_argument(
+        "--ffprobe-path",
+        type=str,
+        default="ffprobe",
+        help="Path to ffprobe executable (for duration probing)",
+    )
     parser.add_argument(
         "ffmpeg_command",
         type=str,
@@ -49,6 +55,7 @@ def main() -> None:
         args.ffmpeg_command,
         dry_run=args.dry_run,
         exclude_progress=args.exclude_progress,
+        ffprobe_path=args.ffprobe_path,
     ) as ff:
         try:
             # Check if we should disable tqdm for testing, or in other cases

src/ffmpeg_progress_yield/ffmpeg_progress_yield.py

@@ -25,18 +25,25 @@ class FfmpegProgress:
     PROGRESS_REGEX = re.compile(r"[a-z0-9_]+=.+")
 
     def __init__(
-        self, cmd: List[str], dry_run: bool = False, exclude_progress: bool = False
+        self,
+        cmd: List[str],
+        dry_run: bool = False,
+        exclude_progress: bool = False,
+        ffprobe_path: str = "ffprobe",
     ) -> None:
         """Initialize the FfmpegProgress class.
 
         Args:
             cmd (List[str]): A list of command line elements, e.g. ["ffmpeg", "-i", ...]
             dry_run (bool, optional): Only show what would be done. Defaults to False.
+            exclude_progress (bool, optional): Exclude progress lines from output. Defaults to False.
+            ffprobe_path (str, optional): Path to ffprobe executable. Defaults to "ffprobe".
         """
         self.cmd = cmd
         self.stderr: Union[str, None] = None
         self.dry_run = dry_run
         self.exclude_progress = exclude_progress
+        self.ffprobe_path = ffprobe_path
         self.process: Any = None
         self.stderr_callback: Union[Callable[[str], None], None] = None
         self.base_popen_kwargs = {
@@ -54,7 +61,7 @@ def __init__(
         self.current_input_idx: int = 0
         self.total_dur: Union[None, int] = None
         if FfmpegProgress._uses_error_loglevel(self.cmd):
-            self.total_dur = FfmpegProgress._probe_duration(self.cmd)
+            self.total_dur = self._probe_duration(self.cmd)
 
         # Set up cleanup on garbage collection as a fallback
         self._cleanup_ref = weakref.finalize(self, self._cleanup_process, None)
@@ -173,8 +180,7 @@ def _process_output(
 
         return progress
 
-    @staticmethod
-    def _probe_duration(cmd: List[str]) -> Optional[int]:
+    def _probe_duration(self, cmd: List[str]) -> Optional[int]:
         """
         Get the duration via ffprobe from input media file
         in case ffmpeg was run with loglevel=error.
@@ -203,7 +209,7 @@ def _probe_duration(cmd: List[str]) -> Optional[int]:
             try:
                 output = subprocess.check_output(
                     [
-                        "ffprobe",
+                        self.ffprobe_path,
                         "-loglevel",
                         "error",
                         "-hide_banner",