peg-this 3.0.1__py3-none-any.whl → 4.0.0__py3-none-any.whl

peg_this/utils/ffmpeg_utils.py

@@ -0,0 +1,129 @@
+
+import subprocess
+import logging
+import sys
+
+import ffmpeg
+from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, BarColumn, TextColumn
+
+console = Console()
+
+
+def check_ffmpeg_ffprobe():
+    """
+    Checks if ffmpeg and ffprobe executables are available in the system's PATH.
+    ffmpeg-python requires this.
+    """
+    try:
+        # The library does this internally, but we can provide a clearer error message.
+        subprocess.check_call(['ffmpeg', '-version'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        subprocess.check_call(['ffprobe', '-version'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    except FileNotFoundError:
+        console.print("[bold red]Error: ffmpeg and ffprobe not found.[/bold red]")
+        if sys.platform == "win32":
+            console.print("You can install it using Chocolatey: [bold]choco install ffmpeg[/bold]")
+            console.print("Or Scoop: [bold]scoop install ffmpeg[/bold]")
+        elif sys.platform == "darwin":
+            console.print("You can install it using Homebrew: [bold]brew install ffmpeg[/bold]")
+        else:
+            console.print("You can install it using your system's package manager, e.g., [bold]sudo apt update && sudo apt install ffmpeg[/bold] on Debian/Ubuntu.")
+        console.print("Please ensure its location is in your system's PATH.")
+        sys.exit(1)
+
+
+def run_command(stream_spec, description="Processing...", show_progress=False):
+    """
+    Runs an ffmpeg command using ffmpeg-python.
+    - For simple commands, it runs directly.
+    - For commands with a progress bar, it generates the ffmpeg arguments,
+      runs them as a subprocess, and parses stderr to show progress.
+    Returns True on success, False on failure.
+    """
+    console.print(f"[bold cyan]{description}[/bold cyan]")
+    
+    args = stream_spec.get_args()
+    full_command = ['ffmpeg'] + args
+    logging.info(f"Executing command: {' '.join(full_command)}")
+
+    if not show_progress:
+        try:
+            # Use ffmpeg.run() for simple, non-progress tasks. It's cleaner.
+            ffmpeg.run(stream_spec, capture_stdout=True, capture_stderr=True, quiet=True)
+            logging.info("Command successful (no progress bar).")
+            return True
+        except ffmpeg.Error as e:
+            error_message = e.stderr.decode('utf-8')
+            console.print("[bold red]An error occurred:[/bold red]")
+            console.print(error_message)
+            logging.error(f"ffmpeg error:{error_message}")
+            return False
+    else:
+        # For the progress bar, we must run ffmpeg as a subprocess and parse stderr.
+        duration = 0
+        try:
+            input_file_path = None
+            for i, arg in enumerate(full_command):
+                if arg == '-i' and i + 1 < len(full_command):
+                    input_file_path = full_command[i+1]
+                    break
+            
+            if input_file_path:
+                probe_info = ffmpeg.probe(input_file_path)
+                duration = float(probe_info['format']['duration'])
+            else:
+                logging.warning("Could not find input file in command to determine duration for progress bar.")
+
+        except (ffmpeg.Error, KeyError) as e:
+            console.print(f"[bold yellow]Warning: Could not determine video duration for progress bar.[/bold yellow]")
+            logging.warning(f"Could not probe for duration: {e}")
+
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(),
+            TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
+            console=console,
+        ) as progress:
+            task = progress.add_task(description, total=100)
+            
+            process = subprocess.Popen(
+                full_command,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                universal_newlines=True,
+                encoding='utf-8'
+            )
+
+            for line in process.stderr:
+                logging.debug(f"ffmpeg stderr: {line.strip()}")
+                if "time=" in line and duration > 0:
+                    try:
+                        time_str = line.split("time=")[1].split(" ")[0].strip()
+                        h, m, s_parts = time_str.split(':')
+                        s = float(s_parts)
+                        elapsed_time = int(h) * 3600 + int(m) * 60 + s
+                        percent_complete = (elapsed_time / duration) * 100
+                        progress.update(task, completed=min(percent_complete, 100))
+                    except Exception:
+                        pass
+
+            process.wait()
+            progress.update(task, completed=100)
+            
+            if process.returncode != 0:
+                log_file = logging.getLogger().handlers[0].baseFilename
+                console.print(f"[bold red]An error occurred during processing. Check {log_file} for details.[/bold red]")
+                return False
+        
+        logging.info("Command successful (with progress bar).")
+        return True
+
+
+def has_audio_stream(file_path):
+    """Check if the media file has an audio stream."""
+    try:
+        probe = ffmpeg.probe(file_path, select_streams='a')
+        return 'streams' in probe and len(probe['streams']) > 0
+    except ffmpeg.Error:
+        return False

peg_this/utils/ui_utils.py

@@ -0,0 +1,52 @@
+
+import os
+from pathlib import Path
+
+import questionary
+from rich.console import Console
+
+try:
+    import tkinter as tk
+    from tkinter import filedialog
+except ImportError:
+    tk = None
+
+console = Console()
+
+
+def get_media_files():
+    """Scan the current directory for media files."""
+    media_extensions = [
+        # Video
+        ".mkv", ".mp4", ".avi", ".mov", ".webm", ".flv", ".wmv", 
+        # Audio
+        ".mp3", ".flac", ".wav", ".ogg", 
+        # GIF
+        ".gif",
+        # Image
+        ".jpg", ".jpeg", ".png", ".webp", ".bmp", ".tiff"
+    ]
+    files = [f for f in os.listdir('.') if os.path.isfile(f) and Path(f).suffix.lower() in media_extensions]
+    return files
+
+
+def select_media_file():
+    """Display a menu to select a media file, or open a file picker."""
+    media_files = get_media_files()
+    if not media_files:
+        console.print("[bold yellow]No media files found in this directory.[/bold yellow]")
+        if tk and questionary.confirm("Would you like to select a file from another location?").ask():
+            root = tk.Tk()
+            root.withdraw()
+            file_path = filedialog.askopenfilename(
+                title="Select a media file",
+                filetypes=[("Media Files", "*.mkv *.mp4 *.avi *.mov *.webm *.flv *.wmv *.mp3 *.flac *.wav *.ogg *.gif *.jpg *.jpeg *.png *.webp *.bmp *.tiff"), ("All Files", "*.*")]
+            )
+            return file_path if file_path else None
+        return None
+
+    choices = media_files + [questionary.Separator(), "Back"]
+    file = questionary.select("Select a media file to process:", choices=choices, use_indicator=True).ask()
+    
+    # Return the absolute path to prevent "file not found" errors
+    return os.path.abspath(file) if file and file != "Back" else None

peg_this-4.0.0.dist-info/METADATA

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: peg_this
+Version: 4.0.0
+Summary: A powerful and intuitive command-line video editor, built on FFmpeg.
+Author-email: Hariharen S S <thisishariharen@gmail.com>
+Project-URL: Homepage, https://github.com/hariharen9/ffmpeg-this
+Project-URL: Documentation, https://github.com/hariharen9/ffmpeg-this/blob/main/README.md
+Project-URL: Funding, https://www.buymeacoffee.com/hariharen
+Project-URL: Say Thanks!, https://saythanks.io/to/thisishariharen
+Project-URL: Social, https://twitter.com/thisishariharen
+Project-URL: Bug Tracker, https://github.com/hariharen9/ffmpeg-this/issues
+Project-URL: Releases, https://github.com/hariharen9/ffmpeg-this/releases
+Project-URL: Sponsor, https://github.com/sponsors/hariharen9
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Video :: Conversion
+Classifier: Topic :: Multimedia :: Video :: Non-Linear Editor
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ffmpeg-python==0.2.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: Pillow>=9.0.0
+Dynamic: license-file
+
+# 🎬 ffmPEG-this
+
+<p align="center">
+    <a href="https://pypi.org/project/peg-this/">
+        <img src="https://img.shields.io/pypi/v/peg_this?color=blue&label=version" alt="PyPI Version">
+    </a>
+    <a href="https://pypi.org/project/peg-this/">
+        <img src="https://img.shields.io/pypi/pyversions/peg_this.svg" alt="PyPI Python Versions">
+    </a>
+    <a href="https://github.com/hariharen9/ffmpeg-this/blob/main/LICENSE">
+        <img src="https://img.shields.io/github/license/hariharen9/ffmpeg-this" alt="License">
+    </a>
+    <a href="https://pepy.tech/project/peg-this">
+        <img src="https://static.pepy.tech/badge/peg-this" alt="Downloads">
+    </a>
+</p>
+
+> Your Video editor within CLI 🚀
+
+A powerful and user-friendly batch script for converting, manipulating, and inspecting media files using the power of FFmpeg. This script provides a simple command-line menu to perform common audio and video tasks without needing to memorize complex FFmpeg commands.
+
+
+<p align="center">
+    <img src="/assets/peg.gif" width="720">
+</p>
+
+
+## ✨ Features
+
+- **Inspect Media Properties**: View detailed information about video and audio streams, including codecs, resolution, frame rate, bitrates, and more.
+- **Convert & Transcode**: Convert videos and audio to a wide range of popular formats (MP4, MKV, WebM, MP3, FLAC, WAV, GIF) with simple quality presets.
+- **Join Videos (Concatenate)**: Combine two or more videos into a single file. The tool automatically handles differences in resolution and audio sample rates for a seamless join.
+- **Trim (Cut) Videos**: Easily cut a video to a specific start and end time without re-encoding for fast, lossless clips.
+- **Visually Crop Videos**: An interactive tool that shows you a frame of the video, allowing you to click and drag to select the exact area you want to crop.
+- **Extract Audio**: Rip the audio track from any video file into MP3, FLAC, or WAV.
+- **Remove Audio**: Create a silent version of your video by stripping out all audio streams.
+- **Batch Conversion**: Convert all media files in the current directory to a specified format in one go.
+- **CLI Interface**: A user-friendly command-line interface that makes it easy to perform common tasks and navigate the tool's features.
+
+
+## 🚀 Usage
+### Prerequisite: Install FFmpeg
+
+> [NOTE]
+> `peg_this` uses a library called `ffmpeg-python` which acts as a controller for the main FFmpeg program. It does not include FFmpeg itself. Therefore, you must have FFmpeg installed on your system and available in your terminal's PATH.
+
+For **macOS** users, the easiest way to install it is with [Homebrew](https://brew.sh/):
+```bash
+brew install ffmpeg
+```
+
+For **Windows** users, you can use a package manager like [Chocolatey](https://chocolatey.org/) or [Scoop](https://scoop.sh/):
+```bash
+# Using Chocolatey
+choco install ffmpeg
+
+# Using Scoop
+scoop install ffmpeg
+```
+
+For other systems, please see the official download page: **[ffmpeg.org/download.html](https://ffmpeg.org/download.html)**
+
+There are three ways to use `peg_this`:
+
+### 1. Pip Install (Recommended)
+This is the easiest way to get started. This will install the tool and all its dependencies.
+
+```bash
+pip install peg_this
+```
+
+Once installed, you can run the tool from your terminal:
+
+```bash
+peg_this
+```
+
+### 2. Download from Release
+If you prefer not to install the package, you can download a pre-built executable from the [Releases](https://github.com/hariharen9/ffmpeg-this/releases/latest) page.
+
+1.  Download the executable for your operating system (Windows, macOS, or Linux).
+2.  Place it in a directory with your media files.
+3.  Run the executable directly from your terminal.
+
+### 3. Run from Source
+If you want to run the script directly from the source code:
+
+1.  **Clone the repository:**
+    ```bash
+    git clone https://github.com/hariharen9/ffmpeg-this.git
+    cd ffmpeg-this
+    ```
+2.  **Install dependencies:**
+    ```bash
+    pip install -r requirements.txt
+    ```
+3.  **Run the script:**
+    ```bash
+    python -m src.peg_this.peg_this
+    ```
+
+## 📈 Star History
+
+<p align="center">
+  <a href="https://star-history.com/#hariharen9/ffmpeg-this&Date">
+    <img src="https://api.star-history.com/svg?repos=hariharen9/ffmpeg-this&type=Date" alt="Star History Chart">
+  </a>
+</p>
+
+## ✨ Sponsor
+
+<p align="center">
+    <a href="https://github.com/sponsors/hariharen9">
+        <img src="https://img.shields.io/github/sponsors/hariharen9?style=for-the-badge&logo=github&color=white" alt="GitHub Sponsors">
+    </a>
+    <a href="https://www.buymeacoffee.com/hariharen">
+        <img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me a Coffee">
+    </a>
+</p>
+
+## 👥 Contributors
+
+<a href="https://github.com/hariharen9/ffmpeg-this/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=hariharen9/ffmpeg-this" />
+</a>
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see the [Contributing Guidelines](CONTRIBUTING.md) for more information.
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+<p align="center">
+    <h2>Made with ❤️ by <a href="https://hariharen.site">Hariharen</a></h2>
+</p>

peg_this-4.0.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+peg_this/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+peg_this/peg_this.py,sha256=0KaDkZ2r2gNUkXaYZOCNG8ps9zD41tYVxKfM5_YewkE,5093
+peg_this/features/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+peg_this/features/audio.py,sha256=O0_lRjzolualxWVXiSiEke5vOpPGwkz0FbMQy5brO58,1533
+peg_this/features/batch.py,sha256=72yXjNfvg-SCxjtaacFzFudmZ8Yd7_rLpvJzbwB8UdA,5178
+peg_this/features/convert.py,sha256=fHlEx8iHEWBrwRfUH6w5ucXLhya7puiUO_DiE2w4kzE,8601
+peg_this/features/crop.py,sha256=haDbDjSKbtNzC7UM5rr4ZizERmMrs4LAkmreNoirasM,7030
+peg_this/features/inspect.py,sha256=xtlmedpsMYQ-vLsnDNzUF59TiZDFLGMyL_wtd8PgiHg,2535
+peg_this/features/join.py,sha256=w_HUsuBv0g9nlOjVvdkeT9dDwxOEvdyvsYCwNocwl98,3414
+peg_this/features/trim.py,sha256=2ZWSNpl4DzSCPt6q7FZloQc-Rga5cX8IW69MfzAZysE,863
+peg_this/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+peg_this/utils/ffmpeg_utils.py,sha256=rmkfOXMNAKqRo3Dkv0aUnUSLxsTdjxDeKMdw3VSCtOU,5409
+peg_this/utils/ui_utils.py,sha256=aIGmRuZEHnp9rAo-WlsfxAESrSTD0bXQMGXqWtnw9TI,1776
+peg_this-4.0.0.dist-info/licenses/LICENSE,sha256=WL1MklYSco7KZvDjbf191tIKOxWQdekqda7dDJc6Wn8,1067
+peg_this-4.0.0.dist-info/METADATA,sha256=bSk0w-PMQhxDJdWCGfKY7oQj3VmFYSb0PaWchrWLg2A,6513
+peg_this-4.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+peg_this-4.0.0.dist-info/entry_points.txt,sha256=9GVTFuE1w_wgY-Tz3--wI5j52BAKrt4atphVD8ioHhQ,52
+peg_this-4.0.0.dist-info/top_level.txt,sha256=kSS5jZg3KN2kJqYZwMvQnI4gvlFxsUNzIm3QJsbKFdc,9
+peg_this-4.0.0.dist-info/RECORD,,

peg_this-3.0.1.dist-info/METADATA

@@ -1,87 +0,0 @@
-Metadata-Version: 2.4
-Name: peg_this
-Version: 3.0.1
-Summary: A powerful, intuitive command-line video editor suite, built on FFmpeg.
-Author-email: Hariharen S S <thisishariharen@gmail.com>
-Project-URL: Homepage, https://github.com/hariharen9/ffmpeg-this
-Project-URL: Bug Tracker, https://github.com/hariharen9/ffmpeg-this/issues
-Project-URL: Releases, https://github.com/hariharen9/ffmpeg-this/releases
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Multimedia :: Video :: Conversion
-Classifier: Topic :: Multimedia :: Video :: Non-Linear Editor
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: ffmpeg-python==0.2.0
-Requires-Dist: questionary>=2.0.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: Pillow>=9.0.0
-Dynamic: license-file
-
-# 🎬 ffmPEG-this
-
-> Your Video editor within CLI 🚀
-
-A powerful and user-friendly batch script for converting, manipulating, and inspecting media files using the power of FFmpeg. This script provides a simple command-line menu to perform common audio and video tasks without needing to memorize complex FFmpeg commands.
-
-## ✨ Features
-
-- **Inspect Media Properties**: View detailed information about video and audio streams, including codecs, resolution, frame rate, bitrates, and more.
-- **Convert & Transcode**: Convert videos and audio to a wide range of popular formats (MP4, MKV, WebM, MP3, FLAC, WAV, GIF) with simple quality presets.
-- **Join Videos (Concatenate)**: Combine two or more videos into a single file. The tool automatically handles differences in resolution and audio sample rates for a seamless join.
-- **Trim (Cut) Videos**: Easily cut a video to a specific start and end time without re-encoding for fast, lossless clips.
-- **Visually Crop Videos**: An interactive tool that shows you a frame of the video, allowing you to click and drag to select the exact area you want to crop.
-- **Extract Audio**: Rip the audio track from any video file into MP3, FLAC, or WAV.
-- **Remove Audio**: Create a silent version of your video by stripping out all audio streams.
-- **Batch Conversion**: Convert all media files in the current directory to a specified format in one go.
-
-
-## 🚀 Usage
-
-There are three ways to use `peg_this`:
-
-### 1. Pip Install (Recommended)
-
-This is the easiest way to get started. This will install the tool and all its dependencies, including `ffmpeg`.
-
-```bash
-pip install peg_this
-```
-
-Once installed, you can run the tool from your terminal:
-
-```bash
-peg_this
-```
-
-### 2. Download from Release
-
-If you don't want to install the package, you can download a pre-built executable from the [Releases](https://github.com/hariharen9/ffmpeg-this/releases/latest) page.
-
-1.  Download the executable for your operating system (Windows, macOS, or Linux).
-2.  Place the downloaded file in a directory with your media files.
-3.  Run the executable directly from your terminal or command prompt.
-
-### 3. Run from Source
-
-If you want to run the script directly from the source code:
-
-1.  **Clone the repository:**
-    ```bash
-    git clone https://github.com/hariharen9/ffmpeg-this.git
-    cd ffmpeg-this
-    ```
-2.  **Install dependencies:**
-    ```bash
-    pip install -r requirements.txt
-    ```
-3.  **Run the script:**
-    ```bash
-    python src/peg_this/peg_this.py
-    ```
-
-## 📄 License
-
-This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

peg_this-3.0.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-peg_this/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-peg_this/peg_this.py,sha256=khAYs2cz5zzxrq2onEt7YNcHjS9xcNJv_dvpXQD-RVg,30150
-peg_this-3.0.1.dist-info/licenses/LICENSE,sha256=WL1MklYSco7KZvDjbf191tIKOxWQdekqda7dDJc6Wn8,1067
-peg_this-3.0.1.dist-info/METADATA,sha256=HhoqodFFu5cKBkuezJ7gDAEPlXwkOn_Z-TbC8L7oyZc,3527
-peg_this-3.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-peg_this-3.0.1.dist-info/entry_points.txt,sha256=9GVTFuE1w_wgY-Tz3--wI5j52BAKrt4atphVD8ioHhQ,52
-peg_this-3.0.1.dist-info/top_level.txt,sha256=kSS5jZg3KN2kJqYZwMvQnI4gvlFxsUNzIm3QJsbKFdc,9
-peg_this-3.0.1.dist-info/RECORD,,