better-ffmpeg-progress 2.1.6__tar.gz → 2.1.8__tar.gz

{better_ffmpeg_progress-2.1.6 → better_ffmpeg_progress-2.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: better-ffmpeg-progress
-Version: 2.1.6
+Version: 2.1.8
 Summary: Run FFmpeg & see percentage progress + ETA.
 Home-page: https://github.com/CrypticSignal/better-ffmpeg-progress
 Author: GitHub.com/CrypticSignal
@@ -9,42 +9,41 @@ Keywords: ffmpeg,progress
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
+Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: ffmpeg-python
-Requires-Dist: tqdm
+Requires-Dist: rich
 
 <div align="center">
 
-[![PyPI downloads](https://img.shields.io/pypi/dm/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/pypistats)
-[![PyPI downloads](https://img.shields.io/pypi/dw/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/pypistats)
+[![PyPI downloads](https://img.shields.io/pypi/dm/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/better-ffmpeg-progress)
+[![PyPI downloads](https://img.shields.io/pypi/dw/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/better-ffmpeg-progress)
 [![GitHub](https://img.shields.io/github/license/crypticsignal/better-ffmpeg-progress?label=License&color=blue)](LICENSE.txt)
 
 # Better FFmpeg Progress
 
-Runs an FFmpeg command and uses [tqdm](https://github.com/tqdm/tqdm) to show a progress bar.
+Runs an FFmpeg command and uses [Rich](https://github.com/Textualize/rich) to show a progress bar.
 
 </div>
 
 ## Example:
 
 ```
-39%|███████████████████████████████████████████ | 23.6/60.2 [00:19<00:34, 1.07s/s]
+⠏ Processing... ━━━━━━━━━╺━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  23% 0:00:04 00:15
 ```
 
 Where:
 
-- `39%` is the percentage progress.
-- `23.6` seconds of the input file have been processed.
-- `60.2` is the duration of the input file in seconds.
-- `00:19` is the time elapsed since the FFmpeg process started.
-- `00:34` is the estimated time required for the FFmpeg process to complete.
-- `1.07` shows how many seconds of the input file are processed per second.
+- `23%` is the percentage progress.
+- `0:00:04` is the time (H:MM:SS) elapsed.
+- `00:15` is the estimated time until the FFmpeg process completes.
 
 ## Installation:
 
-`pip3 install better-ffmpeg-progress --upgrade`
+```
+pip install better-ffmpeg-progress --upgrade
+```
 
 ## Usage:
 
@@ -141,3 +140,11 @@ The `run` method takes the following **optional** arguments:
 [02/05/2024]
 
 - [v2.1.5] Fix issue [#23](https://github.com/CrypticSignal/better-ffmpeg-progress/issues/23) and make an error message more specific. [Here](https://github.com/CrypticSignal/better-ffmpeg-progress/commit/a6ef7f26d080b684144021301f3b2aa5e0834dae) is the relevant commit.
+
+[18/10/2024]
+
+- [v2.1.6] Notify the user if the input filepath or filename is incorrect.
+- [v2.1.7] Refactor to use threads and queues.
+
+[19/10/2024]
+- [v2.1.8] Use [Rich](https://github.com/Textualize/rich) instead of [tqdm](https://github.com/tqdm/tqdm) and format code with [Ruff](https://github.com/astral-sh/ruff).

{better_ffmpeg_progress-2.1.6 → better_ffmpeg_progress-2.1.8}/README.md

@@ -1,33 +1,32 @@
 <div align="center">
 
-[![PyPI downloads](https://img.shields.io/pypi/dm/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/pypistats)
-[![PyPI downloads](https://img.shields.io/pypi/dw/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/pypistats)
+[![PyPI downloads](https://img.shields.io/pypi/dm/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/better-ffmpeg-progress)
+[![PyPI downloads](https://img.shields.io/pypi/dw/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/better-ffmpeg-progress)
 [![GitHub](https://img.shields.io/github/license/crypticsignal/better-ffmpeg-progress?label=License&color=blue)](LICENSE.txt)
 
 # Better FFmpeg Progress
 
-Runs an FFmpeg command and uses [tqdm](https://github.com/tqdm/tqdm) to show a progress bar.
+Runs an FFmpeg command and uses [Rich](https://github.com/Textualize/rich) to show a progress bar.
 
 </div>
 
 ## Example:
 
 ```
-39%|███████████████████████████████████████████ | 23.6/60.2 [00:19<00:34, 1.07s/s]
+⠏ Processing... ━━━━━━━━━╺━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  23% 0:00:04 00:15
 ```
 
 Where:
 
-- `39%` is the percentage progress.
-- `23.6` seconds of the input file have been processed.
-- `60.2` is the duration of the input file in seconds.
-- `00:19` is the time elapsed since the FFmpeg process started.
-- `00:34` is the estimated time required for the FFmpeg process to complete.
-- `1.07` shows how many seconds of the input file are processed per second.
+- `23%` is the percentage progress.
+- `0:00:04` is the time (H:MM:SS) elapsed.
+- `00:15` is the estimated time until the FFmpeg process completes.
 
 ## Installation:
 
-`pip3 install better-ffmpeg-progress --upgrade`
+```
+pip install better-ffmpeg-progress --upgrade
+```
 
 ## Usage:
 
@@ -124,3 +123,11 @@ The `run` method takes the following **optional** arguments:
 [02/05/2024]
 
 - [v2.1.5] Fix issue [#23](https://github.com/CrypticSignal/better-ffmpeg-progress/issues/23) and make an error message more specific. [Here](https://github.com/CrypticSignal/better-ffmpeg-progress/commit/a6ef7f26d080b684144021301f3b2aa5e0834dae) is the relevant commit.
+
+[18/10/2024]
+
+- [v2.1.6] Notify the user if the input filepath or filename is incorrect.
+- [v2.1.7] Refactor to use threads and queues.
+
+[19/10/2024]
+- [v2.1.8] Use [Rich](https://github.com/Textualize/rich) instead of [tqdm](https://github.com/tqdm/tqdm) and format code with [Ruff](https://github.com/astral-sh/ruff).

better_ffmpeg_progress-2.1.8/better_ffmpeg_progress/better_ffmpeg_progress.py

@@ -0,0 +1,277 @@
+from dataclasses import dataclass
+from pathlib import Path
+from queue import Empty, Queue
+import subprocess
+import sys
+from threading import Thread
+from typing import Callable, List, Optional, Union
+
+from ffmpeg import probe
+from rich.progress import (
+    Progress,
+    TextColumn,
+    BarColumn,
+    TaskProgressColumn,
+    TimeRemainingColumn,
+    TimeElapsedColumn,
+    SpinnerColumn,
+)
+
+
+@dataclass
+class Metrics:
+    """Data class to store FFmpeg progress information."""
+
+    percentage: float = 0.0
+    seconds_processed: float = 0
+    speed: float = None
+    eta: Optional[float] = None
+    estimated_size: Optional[int] = None
+
+
+class FfmpegProcess:
+    """
+    Args:
+        command: A list of arguments to pass to FFmpeg.
+        ffmpeg_loglevel: Desired FFmpeg log level. Default is "verbose".
+
+    Raises:
+        FileNotFoundError: If FFmpeg cannot find the input filepath or filename.
+        ValueError: If the list of arguments does not include "-i"
+    """
+
+    WANTED_METRICS = frozenset({"out_time_ms", "total_size", "speed"})
+
+    def __init__(self, command: List[str], ffmpeg_loglevel: str = "verbose"):
+        if "-i" not in command:
+            raise ValueError("FFmpeg command must include '-i'")
+
+        self._ffmpeg_args = command + ["-hide_banner", "-loglevel", ffmpeg_loglevel]
+        self._ffmpeg_stderr: List[str] = []
+        self._output_filepath = Path(command[-1])
+        self._metrics = Metrics()
+        self._duration_secs: Optional[float] = None
+        self._current_size: int = 0
+
+        self._get_input_file_duration()
+
+    def _get_input_file_duration(self) -> None:
+        """Use ffprobe to get the duration of the input file"""
+        index_of_filepath = self._ffmpeg_args.index("-i") + 1
+        self._input_filepath = Path(self._ffmpeg_args[index_of_filepath])
+
+        try:
+            self._duration_secs = float(
+                probe(self._input_filepath)["format"]["duration"]
+            )
+            print(
+                f"The duration of {self._input_filepath.name} has been detected as {self._duration_secs} seconds"
+            )
+            # -progress pipe:1 sends progress metrics to stdout AND -stats_period sets the period at which encoding progress/statistics are updated
+            # -nostats disables encoding progress/statistics in stderr
+            self._ffmpeg_args.extend(
+                ["-progress", "pipe:1", "-stats_period", "0.1", "-nostats"]
+            )
+        except Exception:
+            print(
+                f"Could not detect the duration of {self._input_filepath.name}. Percentage progress, ETA and estimated filesize will be unavailable."
+            )
+            self._duration_secs = None
+
+    def _check_output_exists(self) -> bool:
+        """Check if output file exists and handle overwrite prompt."""
+        if self._output_filepath.exists() and "-y" not in self._ffmpeg_args:
+            choice = input(
+                f"{self._output_filepath} already exists. Overwrite? [Y/N]: "
+            ).lower()
+            if choice != "y":
+                print(
+                    "FFmpeg process cancelled. Output file exists and overwrite declined."
+                )
+                return False
+            self._ffmpeg_args.insert(1, "-y")
+        return True
+
+    def _update_metrics(
+        self, line: str, metric: str, value: str, progress_handler: Optional[Callable]
+    ) -> None:
+        """Update progress information based on FFmpeg output."""
+        if metric == "total_size":
+            self._current_size = int(value)
+
+        elif metric == "out_time_ms":
+            self._metrics.seconds_processed = int(value) / 1_000_000
+
+            if self._duration_secs:
+                self._metrics.percentage = (
+                    self._metrics.seconds_processed / self._duration_secs
+                ) * 100
+                if self._current_size and self._metrics.percentage > 0:
+                    self._metrics.estimated_size = int(
+                        self._current_size * (100 / self._metrics.percentage)
+                    )
+
+        elif metric == "speed":
+            speed_float = float(value.rstrip("x"))
+            if speed_float > 0:
+                self._metrics.speed = float(speed_float)
+                if self._duration_secs:
+                    seconds_remaining = (
+                        self._duration_secs - self._metrics.seconds_processed
+                    )
+                    self._metrics.eta = seconds_remaining / self._metrics.speed
+
+        if line == "progress=end":
+            self._metrics.percentage = 100
+            self._metrics.eta = 0
+
+        if progress_handler:
+            progress_handler(
+                self._metrics.percentage,
+                self._metrics.speed,
+                self._metrics.eta,
+                self._metrics.estimated_size,
+            )
+
+    @staticmethod
+    def _handle_pipe(pipe, queue: Queue) -> None:
+        """Read from the pipe and put the lines into the queue."""
+        try:
+            for line in pipe:
+                queue.put(line.strip())
+        finally:
+            pipe.close()
+
+    def _write_ffmpeg_output(
+        self, stderr_output: str, output_file: Optional[Union[str, Path]]
+    ) -> None:
+        """Write FFmpeg stderr to a txt file."""
+        output_dir = Path("ffmpeg_output")
+        output_dir.mkdir(exist_ok=True)
+
+        log_file = output_file or output_dir / f"[{self._input_filepath.name}].txt"
+        log_file = Path(log_file)
+
+        log_file.write_text(stderr_output)
+        print(f"Done! FFmpeg log file: {log_file}")
+
+    def _start_process(
+        self,
+        progress_bar: Optional[Progress],
+        task_id: Optional[int],
+        success_handler: Optional[Callable],
+        error_handler: Optional[Callable],
+        progress_handler: Optional[Callable],
+    ) -> None:
+        process = subprocess.Popen(
+            self._ffmpeg_args,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True,
+        )
+
+        stdout_queue, stderr_queue = Queue(), Queue()
+        Thread(
+            target=self._handle_pipe, args=(process.stdout, stdout_queue), daemon=True
+        ).start()
+        Thread(
+            target=self._handle_pipe, args=(process.stderr, stderr_queue), daemon=True
+        ).start()
+
+        while process.poll() is None:
+            try:
+                stdout = stdout_queue.get_nowait()
+
+                if stdout:
+                    metric, value = stdout.split("=")
+
+                    if metric in self.WANTED_METRICS and value and "N/A" not in value:
+                        self._update_metrics(stdout, metric, value, progress_handler)
+
+                        if (
+                            metric == "out_time_ms"
+                            and progress_bar
+                            and task_id is not None
+                        ):
+                            progress_bar.update(
+                                task_id,
+                                completed=self._metrics.seconds_processed,
+                                speed=self._metrics.speed,
+                            )
+            except Empty:
+                pass
+
+            try:
+                stderr = stderr_queue.get_nowait()
+
+                if "No such file" in stderr:
+                    raise FileNotFoundError(
+                        f"Input file not found: {self._input_filepath}"
+                    )
+
+                self._ffmpeg_stderr.append(stderr)
+            except Empty:
+                pass
+
+        if process.returncode != 0:
+            if error_handler:
+                error_handler()
+            else:
+                sys.exit("\nFFmpeg process failed")
+
+        if success_handler:
+            success_handler()
+
+    def run(
+        self,
+        output_file: Optional[Union[str, Path]] = None,
+        progress_handler: Optional[Callable] = None,
+        success_handler: Optional[Callable] = None,
+        error_handler: Optional[Callable] = None,
+    ) -> None:
+        """
+        Args:
+            output_file: Optional filepath to write FFmpeg output to
+            progress_handler: Optional function which receives progress metrics
+            success_handler: Optional function to handle successful completion of the FFmpeg process
+            error_handler: Optional function for FFmpeg process error handling
+        """
+        if not self._check_output_exists():
+            return
+
+        # Clear the terminal
+        print("\033[2J\033[H", end="")
+
+        print(f"Executing: {' '.join(self._ffmpeg_args)}")
+
+        if self._duration_secs and not progress_handler:
+            with Progress(
+                SpinnerColumn(),
+                TextColumn("[progress.description]{task.description}"),
+                BarColumn(),
+                TaskProgressColumn(),
+                TimeElapsedColumn(),
+                TimeRemainingColumn(compact=True),
+                refresh_per_second=10,
+            ) as progress_bar:
+                task_id = progress_bar.add_task(
+                    f"Processing {self._input_filepath.name}", total=self._duration_secs
+                )
+
+                self._start_process(
+                    progress_bar,
+                    task_id,
+                    success_handler,
+                    error_handler,
+                    progress_handler,
+                )
+        else:
+            self._start_process(
+                None,
+                None,
+                success_handler,
+                error_handler,
+                progress_handler,
+            )
+
+        self._write_ffmpeg_output("\n".join(self._ffmpeg_stderr), output_file)

{better_ffmpeg_progress-2.1.6 → better_ffmpeg_progress-2.1.8}/better_ffmpeg_progress.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: better-ffmpeg-progress
-Version: 2.1.6
+Version: 2.1.8
 Summary: Run FFmpeg & see percentage progress + ETA.
 Home-page: https://github.com/CrypticSignal/better-ffmpeg-progress
 Author: GitHub.com/CrypticSignal
@@ -9,42 +9,41 @@ Keywords: ffmpeg,progress
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
+Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: ffmpeg-python
-Requires-Dist: tqdm
+Requires-Dist: rich
 
 <div align="center">
 
-[![PyPI downloads](https://img.shields.io/pypi/dm/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/pypistats)
-[![PyPI downloads](https://img.shields.io/pypi/dw/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/pypistats)
+[![PyPI downloads](https://img.shields.io/pypi/dm/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/better-ffmpeg-progress)
+[![PyPI downloads](https://img.shields.io/pypi/dw/better-ffmpeg-progress?label=PyPI&color=blue)](https://pypistats.org/packages/better-ffmpeg-progress)
 [![GitHub](https://img.shields.io/github/license/crypticsignal/better-ffmpeg-progress?label=License&color=blue)](LICENSE.txt)
 
 # Better FFmpeg Progress
 
-Runs an FFmpeg command and uses [tqdm](https://github.com/tqdm/tqdm) to show a progress bar.
+Runs an FFmpeg command and uses [Rich](https://github.com/Textualize/rich) to show a progress bar.
 
 </div>
 
 ## Example:
 
 ```
-39%|███████████████████████████████████████████ | 23.6/60.2 [00:19<00:34, 1.07s/s]
+⠏ Processing... ━━━━━━━━━╺━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  23% 0:00:04 00:15
 ```
 
 Where:
 
-- `39%` is the percentage progress.
-- `23.6` seconds of the input file have been processed.
-- `60.2` is the duration of the input file in seconds.
-- `00:19` is the time elapsed since the FFmpeg process started.
-- `00:34` is the estimated time required for the FFmpeg process to complete.
-- `1.07` shows how many seconds of the input file are processed per second.
+- `23%` is the percentage progress.
+- `0:00:04` is the time (H:MM:SS) elapsed.
+- `00:15` is the estimated time until the FFmpeg process completes.
 
 ## Installation:
 
-`pip3 install better-ffmpeg-progress --upgrade`
+```
+pip install better-ffmpeg-progress --upgrade
+```
 
 ## Usage:
 
@@ -141,3 +140,11 @@ The `run` method takes the following **optional** arguments:
 [02/05/2024]
 
 - [v2.1.5] Fix issue [#23](https://github.com/CrypticSignal/better-ffmpeg-progress/issues/23) and make an error message more specific. [Here](https://github.com/CrypticSignal/better-ffmpeg-progress/commit/a6ef7f26d080b684144021301f3b2aa5e0834dae) is the relevant commit.
+
+[18/10/2024]
+
+- [v2.1.6] Notify the user if the input filepath or filename is incorrect.
+- [v2.1.7] Refactor to use threads and queues.
+
+[19/10/2024]
+- [v2.1.8] Use [Rich](https://github.com/Textualize/rich) instead of [tqdm](https://github.com/tqdm/tqdm) and format code with [Ruff](https://github.com/astral-sh/ruff).

{better_ffmpeg_progress-2.1.6 → better_ffmpeg_progress-2.1.8}/better_ffmpeg_progress.egg-info/requires.txt

@@ -1,2 +1,2 @@
 ffmpeg-python
-tqdm
+rich

{better_ffmpeg_progress-2.1.6 → better_ffmpeg_progress-2.1.8}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setuptools.setup(
     name="better-ffmpeg-progress",
-    version="2.1.6",
+    version="2.1.8",
     author="GitHub.com/CrypticSignal",
     author_email="theaudiophile@outlook.com",
     description="Run FFmpeg & see percentage progress + ETA.",
@@ -13,8 +13,8 @@ setuptools.setup(
     long_description_content_type="text/markdown",
     url="https://github.com/CrypticSignal/better-ffmpeg-progress",
     packages=["better_ffmpeg_progress"],
-    install_requires=["ffmpeg-python", "tqdm"],
-    python_requires=">=3.6",
+    install_requires=["ffmpeg-python", "rich"],
+    python_requires=">=3.7",
     keywords=["ffmpeg", "progress"],
     classifiers=[
         "Programming Language :: Python :: 3",

better_ffmpeg_progress-2.1.6/better_ffmpeg_progress/better_ffmpeg_progress.py

@@ -1,183 +0,0 @@
-import os
-from pathlib import Path
-import subprocess
-import sys
-
-from ffmpeg import probe
-from tqdm import tqdm
-
-
-class FfmpegProcess:
-    """
-    Args:
-        command (list): A list of arguments to pass to FFmpeg.
-
-        ffmpeg_loglevel (str, optional): Desired FFmpeg log level. Default is "verbose".
-
-    Raises:
-        ValueError: If the list of arguments does not include "-i".
-    """
-
-    def __init__(self, command, ffmpeg_loglevel="verbose"):
-        if "-i" not in command:
-            raise ValueError("FFmpeg command must include '-i'")
-
-        self._ffmpeg_args = command + ["-hide_banner", "-loglevel", ffmpeg_loglevel]
-        self._output_filepath = command[-1]
-
-        self._set_file_info()
-
-        self._estimated_size = None
-        self._eta = None
-        self._percentage_progress = 0
-        self._previous_seconds_processed = 0
-        self._progress_bar = None
-        self._seconds_processed = 0
-        self._speed = 0
-        self._current_size = 0
-
-    def _set_file_info(self):
-        index_of_filepath = self._ffmpeg_args.index("-i") + 1
-        self._filepath = self._ffmpeg_args[index_of_filepath]
-        self._can_get_duration = True
-
-        try:
-            self._duration_secs = float(probe(self._filepath)["format"]["duration"])
-            print(
-                f"The duration of {self._filepath} has been detected as {self._duration_secs} seconds."
-            )
-        except Exception:
-            self._can_get_duration = False
-
-        if self._can_get_duration:
-            self._ffmpeg_args += ["-progress", "pipe:1", "-nostats"]
-
-    def _should_run_ffmpeg(self):
-        dirname = os.path.dirname(self._output_filepath)
-        self._dir_files = (
-            [file for file in os.listdir(dirname)] if dirname else [file for file in os.listdir()]
-        )
-
-        if "-y" not in self._ffmpeg_args and self._output_filepath in self._dir_files:
-            choice = input(f"{self._output_filepath} already exists. Overwrite? [Y/N]: ").lower()
-
-            if choice != "y":
-                print(
-                    "FFmpeg will not run as the output filename already exists, and you do not want it to be overwritten."
-                )
-                return False
-
-            self._ffmpeg_args.insert(1, "-y")
-            return True
-
-        return True
-
-    def _update_progress(self, ffmpeg_output, metric_name, value, progress_handler):
-        if progress_handler is None:
-            if metric_name == "out_time_ms":
-                seconds_processed = round(int(value) / 1_000_000, 1)
-                seconds_increase = seconds_processed - self._previous_seconds_processed
-                self._progress_bar.update(seconds_increase)
-                self._previous_seconds_processed = seconds_processed
-
-        else:
-            if metric_name == "total_size":
-                self._current_size = int(value)
-
-            elif metric_name == "out_time_ms":
-                self._seconds_processed = int(value) / 1_000_000
-
-                if self._can_get_duration:
-                    self._percentage_progress = (
-                        self._seconds_processed / self._duration_secs
-                    ) * 100
-
-                    if self._current_size is not None and self._percentage_progress != 0.0:
-                        self._estimated_size = self._current_size * (
-                            100 / self._percentage_progress
-                        )
-
-            elif metric_name == "speed":
-                speed_str = value[:-1]
-
-                if speed_str != "0":
-                    self._speed = float(speed_str)
-
-                    if self._can_get_duration:
-                        self._eta = (self._duration_secs - self._seconds_processed) / self._speed
-
-            if ffmpeg_output == "progress=end":
-                self._percentage_progress = 100
-                self._eta = 0
-
-            progress_handler(
-                self._percentage_progress, self._speed, self._eta, self._estimated_size
-            )
-
-    def run(
-        self,
-        progress_handler=None,
-        ffmpeg_output_file=None,
-        success_handler=None,
-        error_handler=None,
-    ):
-        if not self._should_run_ffmpeg():
-            return
-
-        print(f"Attempting to run: {' '.join(self._ffmpeg_args)}\n")
-        process = subprocess.Popen(self._ffmpeg_args, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
-
-        stdout = process.stdout.readline().decode()
-        stderr = process.stderr.readline().decode()
-
-        if "No such file" in stderr:
-            print(f"{stderr}It seems like the input filepath or filename is incorrect.")
-            return
-
-        if ffmpeg_output_file is None:
-            os.makedirs("ffmpeg_output", exist_ok=True)
-            ffmpeg_output_file = os.path.join("ffmpeg_output", f"[{Path(self._filepath).name}].txt")
-
-        with open(ffmpeg_output_file, "a") as f:
-            f.write(stdout)
-
-        if progress_handler is None and self._can_get_duration:
-            self._progress_bar = tqdm(
-                total=round(self._duration_secs, 1),
-                unit="s",
-                dynamic_ncols=True,
-                leave=False,
-            )
-
-        while process.poll() is None:
-            stdout = process.stdout.readline().decode().strip()
-
-            if not stdout:
-                continue
-
-            metric_name = stdout.split("=")[0]
-            wanted_metrics = ["out_time_ms", "total_size", "speed"]
-
-            if metric_name not in wanted_metrics:
-                continue
-
-            value = stdout.split("=")[1].strip()
-
-            if not value or "N/A" in value:
-                continue
-
-            self._update_progress(stdout, metric_name, value, progress_handler)
-            
-        if process.returncode != 0:
-            if error_handler:
-                error_handler()
-                return
-
-            print(
-                f"The FFmpeg process encountered an error. The output of FFmpeg can be found in {ffmpeg_output_file}"
-            )
-
-        if success_handler:
-            success_handler()
-
-        print(f"\n\nDone! To see FFmpeg's output, check out {ffmpeg_output_file}")