PyPI - peg-this - Versions diffs - 3.0.6__tar.gz → 4.0.0__tar.gz - Mend

peg-this 3.0.6tar.gz → 4.0.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

{peg_this-3.0.6/src/peg_this.egg-info → peg_this-4.0.0}/PKG-INFO RENAMED Viewed

@@ -1,11 +1,16 @@
 Metadata-Version: 2.4
 Name: peg_this
-Version: 3.0.6
-Summary: A powerful, intuitive command-line video editor suite, built on FFmpeg.
+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
@@ -22,12 +27,29 @@ 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.
-<img src="/assets/peg.gif" width="720">
+<p align="center">
+    <img src="/assets/peg.gif" width="720">
+</p>
 ## ✨ Features
@@ -40,11 +62,13 @@ A powerful and user-friendly batch script for converting, manipulating, and insp
 - **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/):
@@ -63,11 +87,10 @@ 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`:
+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`.
+This is the easiest way to get started. This will install the tool and all its dependencies.
 ```bash
 pip install peg_this
@@ -80,15 +103,13 @@ 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.
+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 the downloaded file in a directory with your media files.
-3.  Run the executable directly from your terminal or command prompt.
+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:**
@@ -102,9 +123,42 @@ If you want to run the script directly from the source code:
     ```
 3.  **Run the script:**
     ```bash
-    python src/peg_this/peg_this.py
+    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-3.0.6 → peg_this-4.0.0}/README.md RENAMED Viewed

@@ -1,11 +1,28 @@
 # 🎬 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.
-<img src="/assets/peg.gif" width="720">
+<p align="center">
+    <img src="/assets/peg.gif" width="720">
+</p>
 ## ✨ Features
@@ -18,11 +35,13 @@ A powerful and user-friendly batch script for converting, manipulating, and insp
 - **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/):
@@ -41,11 +60,10 @@ 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`:
+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`.
+This is the easiest way to get started. This will install the tool and all its dependencies.
 ```bash
 pip install peg_this
@@ -58,15 +76,13 @@ 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.
+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 the downloaded file in a directory with your media files.
-3.  Run the executable directly from your terminal or command prompt.
+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:**
@@ -80,9 +96,42 @@ If you want to run the script directly from the source code:
     ```
 3.  **Run the script:**
     ```bash
-    python src/peg_this/peg_this.py
+    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.
+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-3.0.6 → peg_this-4.0.0}/pyproject.toml RENAMED Viewed

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "peg_this"
-version = "3.0.6"
+version = "4.0.0"
 authors = [
   { name="Hariharen S S", email="thisishariharen@gmail.com" },
 ]
-description = "A powerful, intuitive command-line video editor suite, built on FFmpeg."
+description = "A powerful and intuitive command-line video editor, built on FFmpeg."
 readme = "README.md"
 requires-python = ">=3.8"
 classifiers = [
@@ -27,8 +27,13 @@ dependencies = [
 [project.urls]
 "Homepage" = "https://github.com/hariharen9/ffmpeg-this"
+"Documentation" = "https://github.com/hariharen9/ffmpeg-this/blob/main/README.md"
+"Funding" = "https://www.buymeacoffee.com/hariharen"
+"Say Thanks!" = "https://saythanks.io/to/thisishariharen"
+"Social" = "https://twitter.com/thisishariharen"
 "Bug Tracker" = "https://github.com/hariharen9/ffmpeg-this/issues"
 "Releases" = "https://github.com/hariharen9/ffmpeg-this/releases"
+"Sponsor" = "https://github.com/sponsors/hariharen9"
 [project.scripts]

peg_this-4.0.0/src/peg_this/features/convert.py ADDED Viewed

@@ -0,0 +1,225 @@
+import os
+from pathlib import Path
+import ffmpeg
+import questionary
+from rich.console import Console
+from peg_this.utils.ffmpeg_utils import run_command, has_audio_stream
+console = Console()
+def convert_file(file_path):
+    """Convert the file to a different format."""
+    is_gif = Path(file_path).suffix.lower() == '.gif'
+    has_audio = has_audio_stream(file_path)
+    output_format = questionary.select("Select the output format:", choices=["mp4", "mkv", "mov", "avi", "webm", "mp3", "flac", "wav", "gif"], use_indicator=True).ask()
+    if not output_format: return
+    if (is_gif or not has_audio) and output_format in ["mp3", "flac", "wav"]:
+        console.print("[bold red]Error: Source has no audio to convert.[/bold red]")
+        questionary.press_any_key_to_continue().ask()
+        return
+    output_file = f"{Path(file_path).stem}_converted.{output_format}"
+    input_stream = ffmpeg.input(file_path)
+    output_stream = None
+    kwargs = {'y': None}
+    if output_format in ["mp4", "mkv", "mov", "avi", "webm"]:
+        quality = questionary.select("Select quality preset:", choices=["Same as source", "High (CRF 18)", "Medium (CRF 23)", "Low (CRF 28)"], use_indicator=True).ask()
+        if not quality: return
+        if quality == "Same as source":
+            kwargs['c'] = 'copy'
+        else:
+            crf = quality.split(" ")[-1][1:-1]
+            kwargs['c:v'] = 'libx264'
+            kwargs['crf'] = crf
+            kwargs['pix_fmt'] = 'yuv420p'
+            if has_audio:
+                kwargs['c:a'] = 'aac'
+                kwargs['b:a'] = '192k'
+            else:
+                kwargs['an'] = None
+        output_stream = input_stream.output(output_file, **kwargs)
+    elif output_format in ["mp3", "flac", "wav"]:
+        kwargs['vn'] = None
+        if output_format == 'mp3':
+            bitrate = questionary.select("Select audio bitrate:", choices=["128k", "192k", "256k", "320k"]).ask()
+            if not bitrate: return
+            kwargs['c:a'] = 'libmp3lame'
+            kwargs['b:a'] = bitrate
+        else:
+            kwargs['c:a'] = output_format
+        output_stream = input_stream.output(output_file, **kwargs)
+    elif output_format == "gif":
+        fps = questionary.text("Enter frame rate (e.g., 15):", default="15").ask()
+        if not fps: return
+        scale = questionary.text("Enter width in pixels (e.g., 480):", default="480").ask()
+        if not scale: return
+        palette_file = f"palette_{Path(file_path).stem}.png"
+        # Correctly chain filters for palette generation using explicit w/h arguments
+        palette_gen_stream = input_stream.video.filter('fps', fps=fps).filter('scale', w=scale, h=-1, flags='lanczos').filter('palettegen')
+        run_command(palette_gen_stream.output(palette_file, y=None), "Generating color palette...")
+        if not os.path.exists(palette_file):
+            console.print("[bold red]Failed to generate color palette for GIF.[/bold red]")
+            questionary.press_any_key_to_continue().ask()
+            return
+        palette_input = ffmpeg.input(palette_file)
+        video_stream = input_stream.video.filter('fps', fps=fps).filter('scale', w=scale, h=-1, flags='lanczos')
+        final_stream = ffmpeg.filter([video_stream, palette_input], 'paletteuse')
+        output_stream = final_stream.output(output_file, y=None)
+    if output_stream and run_command(output_stream, f"Converting to {output_format}...", show_progress=True):
+        console.print(f"[bold green]Successfully converted to {output_file}[/bold green]")
+    else:
+        console.print("[bold red]Conversion failed.[/bold red]")
+    if output_format == "gif" and os.path.exists(f"palette_{Path(file_path).stem}.png"):
+        os.remove(f"palette_{Path(file_path).stem}.png")
+    questionary.press_any_key_to_continue().ask()
+def convert_image(file_path):
+    """Convert an image to a different format."""
+    output_format = questionary.select(
+        "Select the output format:",
+        choices=["jpg", "png", "webp", "bmp", "tiff"],
+        use_indicator=True
+    ).ask()
+    if not output_format: return
+    output_file = f"{Path(file_path).stem}_converted.{output_format}"
+    kwargs = {'y': None}
+    # For JPG and WEBP, allow quality selection
+    if output_format in ['jpg', 'webp']:
+        quality_preset = questionary.select(
+            "Select quality preset:",
+            choices=["High (95%)", "Medium (80%)", "Low (60%)"],
+            use_indicator=True
+        ).ask()
+        if not quality_preset: return
+        quality_map = {"High (95%)": "95", "Medium (80%)": "80", "Low (60%)": "60"}
+        quality = quality_map[quality_preset]
+        if output_format == 'jpg':
+            q_scale = int(31 - (int(quality) / 100.0) * 30)
+            kwargs['q:v'] = q_scale
+        elif output_format == 'webp':
+            kwargs['quality'] = quality
+    stream = ffmpeg.input(file_path).output(output_file, **kwargs)
+    if run_command(stream, f"Converting to {output_format.upper()}..."):
+        console.print(f"[bold green]Successfully converted image to {output_file}[/bold green]")
+    else:
+        console.print("[bold red]Image conversion failed.[/bold red]")
+    questionary.press_any_key_to_continue().ask()
+def resize_image(file_path):
+    """Resize an image to new dimensions."""
+    console.print("Enter new dimensions. Use [bold]-1[/bold] for one dimension to preserve aspect ratio.")
+    width = questionary.text("Enter new width (e.g., 1280 or -1):").ask()
+    if not width: return
+    height = questionary.text("Enter new height (e.g., 720 or -1):").ask()
+    if not height: return
+    try:
+        if int(width) == -1 and int(height) == -1:
+            console.print("[bold red]Error: Width and Height cannot both be -1.[/bold red]")
+            questionary.press_any_key_to_continue().ask()
+            return
+    except ValueError:
+        console.print("[bold red]Error: Invalid dimensions. Please enter numbers.[/bold red]")
+        questionary.press_any_key_to_continue().ask()
+        return
+    output_file = f"{Path(file_path).stem}_resized{Path(file_path).suffix}"
+    stream = ffmpeg.input(file_path).filter('scale', w=width, h=height).output(output_file, y=None)
+    if run_command(stream, "Resizing image..."):
+        console.print(f"[bold green]Successfully resized image to {output_file}[/bold green]")
+    else:
+        console.print("[bold red]Image resizing failed.[/bold red]")
+    questionary.press_any_key_to_continue().ask()
+def rotate_image(file_path):
+    """Rotate an image."""
+    rotation = questionary.select(
+        "Select rotation:",
+        choices=[
+            "90 degrees clockwise",
+            "90 degrees counter-clockwise",
+            "180 degrees"
+        ],
+        use_indicator=True
+    ).ask()
+    if not rotation: return
+    output_file = f"{Path(file_path).stem}_rotated{Path(file_path).suffix}"
+    stream = ffmpeg.input(file_path)
+    if rotation == "90 degrees clockwise":
+        stream = stream.filter('transpose', 1)
+    elif rotation == "90 degrees counter-clockwise":
+        stream = stream.filter('transpose', 2)
+    elif rotation == "180 degrees":
+        # Apply 90-degree rotation twice for 180 degrees
+        stream = stream.filter('transpose', 2).filter('transpose', 2)
+    output_stream = stream.output(output_file, y=None)
+    if run_command(output_stream, "Rotating image..."):
+        console.print(f"[bold green]Successfully rotated image and saved to {output_file}[/bold green]")
+    else:
+        console.print("[bold red]Image rotation failed.[/bold red]")
+    questionary.press_any_key_to_continue().ask()
+def flip_image(file_path):
+    """Flip an image horizontally or vertically."""
+    flip_direction = questionary.select(
+        "Select flip direction:",
+        choices=["Horizontal", "Vertical"],
+        use_indicator=True
+    ).ask()
+    if not flip_direction: return
+    output_file = f"{Path(file_path).stem}_flipped{Path(file_path).suffix}"
+    stream = ffmpeg.input(file_path)
+    if flip_direction == "Horizontal":
+        stream = stream.filter('hflip')
+    else:
+        stream = stream.filter('vflip')
+    output_stream = stream.output(output_file, y=None)
+    if run_command(output_stream, "Flipping image..."):
+        console.print(f"[bold green]Successfully flipped image and saved to {output_file}[/bold green]")
+    else:
+        console.print("[bold red]Image flipping failed.[/bold red]")
+    questionary.press_any_key_to_continue().ask()

{peg_this-3.0.6 → peg_this-4.0.0}/src/peg_this/features/crop.py RENAMED Viewed

@@ -104,3 +104,75 @@ def crop_video(file_path):
         if os.path.exists(preview_frame):
             os.remove(preview_frame)
         questionary.press_any_key_to_continue().ask()
+def crop_image(file_path):
+    """Visually crop an image by selecting an area."""
+    if not tk:
+        console.print("[bold red]Cannot perform visual cropping: tkinter & Pillow are not installed.[/bold red]")
+        console.print("Please install them with: [bold]pip install tk Pillow[/bold]")
+        questionary.press_any_key_to_continue().ask()
+        return
+    try:
+        # --- Tkinter GUI for Cropping ---
+        root = tk.Tk()
+        root.title("Crop Image - Drag to select area, close window to confirm")
+        root.attributes("-topmost", True)
+        img = Image.open(file_path)
+        max_width = root.winfo_screenwidth() - 100
+        max_height = root.winfo_screenheight() - 100
+        img.thumbnail((max_width, max_height), Image.Resampling.LANCZOS)
+        img_tk = ImageTk.PhotoImage(img)
+        canvas = tk.Canvas(root, width=img.width, height=img.height, cursor="cross")
+        canvas.pack()
+        canvas.create_image(0, 0, anchor=tk.NW, image=img_tk)
+        rect_coords = {"x1": 0, "y1": 0, "x2": 0, "y2": 0}
+        rect_id = None
+        def on_press(event):
+            nonlocal rect_id
+            rect_coords['x1'], rect_coords['y1'] = event.x, event.y
+            rect_id = canvas.create_rectangle(0, 0, 1, 1, outline='red', width=2)
+        def on_drag(event):
+            rect_coords['x2'], rect_coords['y2'] = event.x, event.y
+            canvas.coords(rect_id, rect_coords['x1'], rect_coords['y1'], rect_coords['x2'], rect_coords['y2'])
+        canvas.bind("<ButtonPress-1>", on_press)
+        canvas.bind("<B1-Motion>", on_drag)
+        messagebox.showinfo("Instructions", "Click and drag to draw a cropping rectangle.\nClose this window when you are done.", parent=root)
+        root.mainloop()
+        # --- Cropping Logic ---
+        crop_w = abs(rect_coords['x2'] - rect_coords['x1'])
+        crop_h = abs(rect_coords['y2'] - rect_coords['y1'])
+        crop_x = min(rect_coords['x1'], rect_coords['x2'])
+        crop_y = min(rect_coords['y1'], rect_coords['y2'])
+        if crop_w < 2 or crop_h < 2:
+            console.print("[bold yellow]Cropping cancelled as no valid area was selected.[/bold yellow]")
+            questionary.press_any_key_to_continue().ask()
+            return
+        console.print(f"Selected crop area: [bold]width={crop_w} height={crop_h} at (x={crop_x}, y={crop_y})[/bold]")
+        output_file = f"{Path(file_path).stem}_cropped{Path(file_path).suffix}"
+        stream = ffmpeg.input(file_path).filter('crop', w=crop_w, h=crop_h, x=crop_x, y=crop_y).output(output_file, y=None)
+        if run_command(stream, "Applying crop to image..."):
+            console.print(f"[bold green]Successfully cropped image and saved to {output_file}[/bold green]")
+        else:
+            console.print("[bold red]Image cropping failed.[/bold red]")
+    except Exception as e:
+        console.print(f"[bold red]An error occurred during cropping: {e}[/bold red]")
+    finally:
+        questionary.press_any_key_to_continue().ask()

{peg_this-3.0.6 → peg_this-4.0.0}/src/peg_this/peg_this.py RENAMED Viewed

@@ -1,6 +1,7 @@
 import os
 import sys
 import logging
+from pathlib import Path
 sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
 import questionary
@@ -8,8 +9,8 @@ from rich.console import Console
 from peg_this.features.audio import extract_audio, remove_audio
 from peg_this.features.batch import batch_convert
-from peg_this.features.convert import convert_file
-from peg_this.features.crop import crop_video
+from peg_this.features.convert import convert_file, convert_image, resize_image, rotate_image, flip_image
+from peg_this.features.crop import crop_video, crop_image
 from peg_this.features.inspect import inspect_file
 from peg_this.features.join import join_videos
 from peg_this.features.trim import trim_video
@@ -29,9 +30,44 @@ logging.basicConfig(
 # Initialize Rich Console
 console = Console()
+IMAGE_EXTENSIONS = [".jpg", ".jpeg", ".png", ".webp", ".bmp", ".tiff"]
 # --- End Global Configuration ---
+def image_action_menu(file_path):
+    """Display the menu of actions for a selected image file."""
+    while True:
+        console.rule(f"[bold]Actions for Image: {os.path.basename(file_path)}[/bold]")
+        action = questionary.select(
+            "Choose an action:",
+            choices=[
+                "Inspect File Details",
+                "Convert Format",
+                "Resize",
+                "Rotate",
+                "Flip",
+                "Crop (Visual)",
+                questionary.Separator(),
+                "Back to File List"
+            ],
+            use_indicator=True
+        ).ask()
+        if action is None or action == "Back to File List":
+            break
+        actions = {
+            "Inspect File Details": inspect_file,
+            "Convert Format": convert_image,
+            "Resize": resize_image,
+            "Rotate": rotate_image,
+            "Flip": flip_image,
+            "Crop (Visual)": crop_image,
+        }
+        if action in actions:
+            actions[action](file_path)
 def action_menu(file_path):
     """Display the menu of actions for a selected file."""
     while True:
@@ -90,7 +126,10 @@ def main_menu():
         elif choice == "Process a Single Media File":
             selected_file = select_media_file()
             if selected_file:
-                action_menu(selected_file)
+                if Path(selected_file).suffix.lower() in IMAGE_EXTENSIONS:
+                    image_action_menu(selected_file)
+                else:
+                    action_menu(selected_file)
         elif choice == "Join Multiple Videos":
             join_videos()
         elif choice == "Batch Convert All Media in Directory":

{peg_this-3.0.6 → peg_this-4.0.0}/src/peg_this/utils/ffmpeg_utils.py RENAMED Viewed

@@ -37,12 +37,11 @@ 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,
-      mimicking the logic from the original script for accuracy.
+      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]")
-    # Get the full command arguments from the ffmpeg-python stream object
     args = stream_spec.get_args()
     full_command = ['ffmpeg'] + args
     logging.info(f"Executing command: {' '.join(full_command)}")
@@ -50,24 +49,22 @@ def run_command(stream_spec, description="Processing...", show_progress=False):
     if not show_progress:
         try:
             # Use ffmpeg.run() for simple, non-progress tasks. It's cleaner.
-            out, err = ffmpeg.run(stream_spec, capture_stdout=True, capture_stderr=True, quiet=True)
+            ffmpeg.run(stream_spec, capture_stdout=True, capture_stderr=True, quiet=True)
             logging.info("Command successful (no progress bar).")
-            return out.decode('utf-8')
+            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 None
+            return False
     else:
         # For the progress bar, we must run ffmpeg as a subprocess and parse stderr.
         duration = 0
         try:
-            # Find the primary input file from the command arguments to probe it.
             input_file_path = None
             for i, arg in enumerate(full_command):
                 if arg == '-i' and i + 1 < len(full_command):
-                    # This is a robust way to find the first input file.
                     input_file_path = full_command[i+1]
                     break
@@ -90,7 +87,6 @@ def run_command(stream_spec, description="Processing...", show_progress=False):
         ) as progress:
             task = progress.add_task(description, total=100)
-            # Run the command as a subprocess to capture stderr in real-time
             process = subprocess.Popen(
                 full_command,
                 stdout=subprocess.PIPE,
@@ -110,19 +106,18 @@ def run_command(stream_spec, description="Processing...", show_progress=False):
                         percent_complete = (elapsed_time / duration) * 100
                         progress.update(task, completed=min(percent_complete, 100))
                     except Exception:
-                        pass # Ignore any parsing errors
+                        pass
             process.wait()
             progress.update(task, completed=100)
             if process.returncode != 0:
-                # The error was already logged line-by-line, but we can add a final message.
                 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 None
+                return False
         logging.info("Command successful (with progress bar).")
-        return "Success"
+        return True
 def has_audio_stream(file_path):

{peg_this-3.0.6 → peg_this-4.0.0}/src/peg_this/utils/ui_utils.py RENAMED Viewed

@@ -16,7 +16,16 @@ console = Console()
 def get_media_files():
     """Scan the current directory for media files."""
-    media_extensions = [".mkv", ".mp4", ".avi", ".mov", ".webm", ".flv", ".wmv", ".mp3", ".flac", ".wav", ".ogg", ".gif"]
+    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
@@ -31,7 +40,7 @@ def select_media_file():
             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"), ("All Files", "*.*")]
+                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

{peg_this-3.0.6 → peg_this-4.0.0/src/peg_this.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,11 +1,16 @@
 Metadata-Version: 2.4
 Name: peg_this
-Version: 3.0.6
-Summary: A powerful, intuitive command-line video editor suite, built on FFmpeg.
+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
@@ -22,12 +27,29 @@ 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.
-<img src="/assets/peg.gif" width="720">
+<p align="center">
+    <img src="/assets/peg.gif" width="720">
+</p>
 ## ✨ Features
@@ -40,11 +62,13 @@ A powerful and user-friendly batch script for converting, manipulating, and insp
 - **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/):
@@ -63,11 +87,10 @@ 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`:
+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`.
+This is the easiest way to get started. This will install the tool and all its dependencies.
 ```bash
 pip install peg_this
@@ -80,15 +103,13 @@ 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.
+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 the downloaded file in a directory with your media files.
-3.  Run the executable directly from your terminal or command prompt.
+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:**
@@ -102,9 +123,42 @@ If you want to run the script directly from the source code:
     ```
 3.  **Run the script:**
     ```bash
-    python src/peg_this/peg_this.py
+    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-3.0.6/src/peg_this/features/convert.py DELETED Viewed

@@ -1,93 +0,0 @@
-import os
-from pathlib import Path
-import ffmpeg
-import questionary
-from rich.console import Console
-from peg_this.utils.ffmpeg_utils import run_command, has_audio_stream
-console = Console()
-def convert_file(file_path):
-    """Convert the file to a different format."""
-    is_gif = Path(file_path).suffix.lower() == '.gif'
-    has_audio = has_audio_stream(file_path)
-    output_format = questionary.select("Select the output format:", choices=["mp4", "mkv", "mov", "avi", "webm", "mp3", "flac", "wav", "gif"], use_indicator=True).ask()
-    if not output_format: return
-    if (is_gif or not has_audio) and output_format in ["mp3", "flac", "wav"]:
-        console.print("[bold red]Error: Source has no audio to convert.[/bold red]")
-        questionary.press_any_key_to_continue().ask()
-        return
-    output_file = f"{Path(file_path).stem}_converted.{output_format}"
-    input_stream = ffmpeg.input(file_path)
-    output_stream = None
-    kwargs = {'y': None}
-    if output_format in ["mp4", "mkv", "mov", "avi", "webm"]:
-        quality = questionary.select("Select quality preset:", choices=["Same as source", "High (CRF 18)", "Medium (CRF 23)", "Low (CRF 28)"], use_indicator=True).ask()
-        if not quality: return
-        if quality == "Same as source":
-            kwargs['c'] = 'copy'
-        else:
-            crf = quality.split(" ")[-1][1:-1]
-            kwargs['c:v'] = 'libx264'
-            kwargs['crf'] = crf
-            kwargs['pix_fmt'] = 'yuv420p'
-            if has_audio:
-                kwargs['c:a'] = 'aac'
-                kwargs['b:a'] = '192k'
-            else:
-                kwargs['an'] = None
-        output_stream = input_stream.output(output_file, **kwargs)
-    elif output_format in ["mp3", "flac", "wav"]:
-        kwargs['vn'] = None
-        if output_format == 'mp3':
-            bitrate = questionary.select("Select audio bitrate:", choices=["128k", "192k", "256k", "320k"]).ask()
-            if not bitrate: return
-            kwargs['c:a'] = 'libmp3lame'
-            kwargs['b:a'] = bitrate
-        else:
-            kwargs['c:a'] = output_format
-        output_stream = input_stream.output(output_file, **kwargs)
-    elif output_format == "gif":
-        fps = questionary.text("Enter frame rate (e.g., 15):", default="15").ask()
-        if not fps: return
-        scale = questionary.text("Enter width in pixels (e.g., 480):", default="480").ask()
-        if not scale: return
-        palette_file = f"palette_{Path(file_path).stem}.png"
-        # Correctly chain filters for palette generation using explicit w/h arguments
-        palette_gen_stream = input_stream.video.filter('fps', fps=fps).filter('scale', w=scale, h=-1, flags='lanczos').filter('palettegen')
-        run_command(palette_gen_stream.output(palette_file, y=None), "Generating color palette...")
-        if not os.path.exists(palette_file):
-            console.print("[bold red]Failed to generate color palette for GIF.[/bold red]")
-            questionary.press_any_key_to_continue().ask()
-            return
-        palette_input = ffmpeg.input(palette_file)
-        video_stream = input_stream.video.filter('fps', fps=fps).filter('scale', w=scale, h=-1, flags='lanczos')
-        final_stream = ffmpeg.filter([video_stream, palette_input], 'paletteuse')
-        output_stream = final_stream.output(output_file, y=None)
-    if output_stream and run_command(output_stream, f"Converting to {output_format}...", show_progress=True):
-        console.print(f"[bold green]Successfully converted to {output_file}[/bold green]")
-    else:
-        console.print("[bold red]Conversion failed.[/bold red]")
-    if output_format == "gif" and os.path.exists(f"palette_{Path(file_path).stem}.png"):
-        os.remove(f"palette_{Path(file_path).stem}.png")
-    questionary.press_any_key_to_continue().ask()