ffmpeg-tools 0.1.4__tar.gz

ffmpeg_tools-0.1.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sudeep Sudhevan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ffmpeg_tools-0.1.4/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: ffmpeg_tools
+Version: 0.1.4
+Summary: A Python package for high-quality FFmpeg command generation and video utilities.
+Home-page: https://github.com/sudeepsudhevan/FFmpeg_pip
+Author: Sudeep Sudhevan
+Author-email: sudeepsudhevan66@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# FFmpeg Tools
+
+A Python package for simplified FFmpeg command generation, video downloading, and file management.
+
+## Installation
+
+```bash
+pip install ffmpeg-tools
+```
+
+## Usage
+
+### 1. Generating FFmpeg Commands
+
+```python
+from ffmpeg_tools import build_command
+
+# Generate a high-quality compression command
+cmd = build_command("compress_high_quality", input="video.mp4", output="compressed.mp4")
+print(cmd)
+# Output: ['ffmpeg', '-y', '-i', 'video.mp4', ...]
+```
+
+### 2. Downloading Videos
+
+```python
+from pathlib import Path
+from ffmpeg_tools import download_video
+
+# Download a video from YouTube
+download_video(
+    url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
+    output_folder=Path("downloads"),
+    clear_folder=False
+)
+```
+
+### 3. Cleaning Filenames
+
+```python
+from pathlib import Path
+from ffmpeg_tools import clean_filename
+
+file_path = Path("downloads/My Video (2024).mp4")
+new_path = clean_filename(file_path)
+print(new_path)
+# Output: downloads/My_Video_2024.mp4
+```
+
+## License
+
+MIT

ffmpeg_tools-0.1.4/README.md

@@ -0,0 +1,52 @@
+# FFmpeg Tools
+
+A Python package for simplified FFmpeg command generation, video downloading, and file management.
+
+## Installation
+
+```bash
+pip install ffmpeg-tools
+```
+
+## Usage
+
+### 1. Generating FFmpeg Commands
+
+```python
+from ffmpeg_tools import build_command
+
+# Generate a high-quality compression command
+cmd = build_command("compress_high_quality", input="video.mp4", output="compressed.mp4")
+print(cmd)
+# Output: ['ffmpeg', '-y', '-i', 'video.mp4', ...]
+```
+
+### 2. Downloading Videos
+
+```python
+from pathlib import Path
+from ffmpeg_tools import download_video
+
+# Download a video from YouTube
+download_video(
+    url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
+    output_folder=Path("downloads"),
+    clear_folder=False
+)
+```
+
+### 3. Cleaning Filenames
+
+```python
+from pathlib import Path
+from ffmpeg_tools import clean_filename
+
+file_path = Path("downloads/My Video (2024).mp4")
+new_path = clean_filename(file_path)
+print(new_path)
+# Output: downloads/My_Video_2024.mp4
+```
+
+## License
+
+MIT

ffmpeg_tools-0.1.4/ffmpeg_tools/__init__.py

@@ -0,0 +1,12 @@
+"""
+ffmpeg_tools
+~~~~~~~~~~~~
+
+A simple Python package for FFmpeg command generation, video downloading, and file management.
+"""
+
+from .commands import build_command, get_all_commands, run_command
+from .media import clean_filename, has_video_stream, remove_video_files
+from .downloader import download_video
+
+__version__ = "0.1.0"

ffmpeg_tools-0.1.4/ffmpeg_tools/commands.py

@@ -0,0 +1,314 @@
+"""
+ffmpeg_tools.commands
+~~~~~~~~~~~~~~~~~~~~~
+
+High-quality FFmpeg command templates and building utilities.
+"""
+
+import json
+import logging
+import os
+from copy import deepcopy
+
+# Setup logger
+logger = logging.getLogger(__name__)
+
+# Hardcoded Baseline Commands
+FFMPEG_COMMANDS = {
+    # =========================
+    # 🎯 BASELINE (GPU ACCELERATED)
+    # =========================
+    "base_gpu_quality": {
+        "command": [
+            "ffmpeg", "-y",
+            "-hwaccel", "cuda",
+            "-i", "{input}",
+            "-c:v", "h264_nvenc",
+            "-preset", "p6",
+            "-rc", "vbr",
+            "-cq", "19",
+            "-pix_fmt", "yuv420p",
+            "-c:a", "aac", "-b:a", "192k",
+            "{output}"
+        ],
+        "description": "GPU accelerated H.264 encoding (High Quality)"
+    },
+
+    "trim_gpu_reencode": {
+        "command": [
+            "ffmpeg", "-y",
+            "-hwaccel", "cuda",
+            "-ss", "{start}", "-to", "{end}",
+            "-i", "{input}",
+            "-c:v", "h264_nvenc",
+            "-preset", "p4",
+            "-cq", "19",
+            "-c:a", "aac",
+            "{output}"
+        ],
+        "description": "Fast GPU-based frame-accurate trimming"
+    },
+
+    "compress_gpu_h265": {
+        "command": [
+            "ffmpeg", "-y",
+            "-hwaccel", "cuda",
+            "-i", "{input}",
+            "-c:v", "hevc_nvenc",
+            "-preset", "p6",
+            "-rc", "vbr",
+            "-cq", "24",
+            "-c:a", "aac",
+            "{output}"
+        ],
+        "description": "Ultra-fast H.265 compression via GPU"
+    },
+
+    "resize_gpu": {
+        "command": [
+            "ffmpeg", "-y",
+            "-hwaccel", "cuda",
+            "-hwaccel_output_format", "cuda",
+            "-i", "{input}",
+            "-vf", "scale_cuda={width}:{height}",
+            "-c:v", "h264_nvenc",
+            "-preset", "p4",
+            "-c:a", "aac",
+            "{output}"
+        ],
+        "description": "Resize video entirely on GPU (no CPU bottleneck)"
+    },
+
+    # =========================
+    # 🎯 BASELINE (CPU BEST QUALITY)
+    # =========================
+    "base_best_quality": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-map", "0:v:0",
+            "-map", "0:a:0?",
+            "-c:v", "libx264",
+            "-preset", "slow",
+            "-crf", "18",
+            "-pix_fmt", "yuv420p",
+            "-profile:v", "high",
+            "-level", "4.1",
+            "-c:a", "aac",
+            "-b:a", "192k",
+            "-movflags", "+faststart",
+            "{output}"
+        ],
+        "description": "Visually lossless video + high quality AAC audio"
+    },
+
+    "trim_reencode": {
+        "command": [
+            "ffmpeg", "-y",
+            "-ss", "{start}",
+            "-to", "{end}",
+            "-i", "{input}",
+            "-c:v", "libx264",
+            "-preset", "slow",
+            "-crf", "18",
+            "-c:a", "aac",
+            "-b:a", "192k",
+            "-movflags", "+faststart",
+            "{output}"
+        ],
+        "description": "Frame-accurate trimming with re-encoding"
+    },
+
+    "trim_copy": {
+        "command": [
+            "ffmpeg", "-y",
+            "-ss", "{start}",
+            "-to", "{end}",
+            "-i", "{input}",
+            "-c", "copy",
+            "{output}"
+        ],
+        "description": "Fast trim without quality loss (keyframe based)"
+    },
+
+    "split_segments": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-map", "0",
+            "-c", "copy",
+            "-f", "segment",
+            "-segment_time", "{duration}",
+            "-reset_timestamps", "1",
+            "{output_pattern}"
+        ],
+        "description": "Split video into equal-length segments"
+    },
+
+    "compress_high_quality": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-c:v", "libx264",
+            "-preset", "slow",
+            "-crf", "23",
+            "-c:a", "aac",
+            "-b:a", "160k",
+            "-movflags", "+faststart",
+            "{output}"
+        ],
+        "description": "Balanced compression (YouTube-grade quality)"
+    },
+
+    "compress_ultra": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-c:v", "libx265",
+            "-preset", "slow",
+            "-crf", "28",
+            "-c:a", "aac",
+            "-b:a", "128k",
+            "{output}"
+        ],
+        "description": "Maximum compression using H.265"
+    },
+
+    "extract_audio_wav": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-vn",
+            "-c:a", "pcm_s16le",
+            "{output}"
+        ],
+        "description": "Extract lossless WAV audio"
+    },
+
+    "extract_audio_aac": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-vn",
+            "-c:a", "aac",
+            "-b:a", "192k",
+            "{output}"
+        ],
+        "description": "Extract high-quality AAC audio"
+    },
+
+    "extract_video_only": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-an",
+            "-c:v", "libx264",
+            "-preset", "slow",
+            "-crf", "18",
+            "{output}"
+        ],
+        "description": "Extract video stream only"
+    },
+
+    "resize_video": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-vf", "scale={width}:{height}:flags=lanczos",
+            "-c:v", "libx264",
+            "-preset", "slow",
+            "-crf", "18",
+            "-c:a", "aac",
+            "-b:a", "192k",
+            "{output}"
+        ],
+        "description": "Resize video using high-quality Lanczos scaling"
+    },
+
+    "remux_copy": {
+        "command": [
+            "ffmpeg", "-y",
+            "-i", "{input}",
+            "-c", "copy",
+            "{output}"
+        ],
+        "description": "Change container format without re-encoding"
+    }
+}
+
+
+def get_all_commands(db_path: str = None) -> dict:
+    """
+    Returns the complete dictionary of available FFmpeg commands.
+    Merges hardcoded commands with an optional external JSON file.
+    """
+    all_cmds = deepcopy(FFMPEG_COMMANDS)
+    
+    if db_path and os.path.exists(db_path):
+        try:
+            with open(db_path, "r", encoding="utf-8") as f:
+                external_cmds = json.load(f)
+                all_cmds.update(external_cmds)
+        except (json.JSONDecodeError, IOError) as e:
+            logger.warning(f"Failed to load external commands from {db_path}: {e}")
+            
+    return all_cmds
+
+
+def build_command(profile: str, db_path: str = None, **kwargs) -> list[str]:
+    """
+    Builds the FFmpeg command list for a given profile.
+    
+    Args:
+        profile (str): The key/name of the command profile.
+        db_path (str, optional): Path to external JSON command DB.
+        **kwargs: Arguments to format the command template (e.g., input, output, start, end).
+        
+    Returns:
+        list[str]: The formatted command list ready for subprocess.
+        
+    Raises:
+        KeyError: If profile is not found or required arguments are missing.
+    """
+    commands = get_all_commands(db_path)
+    
+    if profile not in commands:
+        raise KeyError(f"Profile '{profile}' not found.")
+
+    template = commands[profile]["command"]
+    
+    try:
+        # Format each argument in the command list
+        return [arg.format(**kwargs) for arg in template]
+    except KeyError as e:
+        missing_key = e.args[0]
+        raise KeyError(f"Missing required parameter '{missing_key}' for profile '{profile}'.")
+
+
+def run_command(command: list[str], dry_run: bool = False) -> bool:
+    """
+    Executes the given FFmpeg command list using subprocess.
+    
+    Args:
+        command (list[str]): The command list (e.g., from build_command).
+        dry_run (bool): If True, prints the command without executing.
+        
+    Returns:
+        bool: True if successful, False otherwise.
+    """
+    if dry_run:
+        print(f"Dry run: {' '.join(command)}")
+        return True
+
+    try:
+        import subprocess
+        logger.info(f"Running command: {' '.join(command)}")
+        subprocess.run(command, check=True)
+        return True
+    except subprocess.CalledProcessError as e:
+        logger.error(f"FFmpeg execution failed: {e}")
+        return False
+    except FileNotFoundError:
+        logger.error("FFmpeg not found. Please ensure ffmpeg is in your system PATH.")
+        return False
+

ffmpeg_tools-0.1.4/ffmpeg_tools/downloader.py

@@ -0,0 +1,48 @@
+"""
+ffmpeg_tools.downloader
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Wrapper for downloading videos using yt-dlp.
+"""
+
+import subprocess
+import logging
+from pathlib import Path
+from .media import remove_video_files
+
+# Setup logger
+logger = logging.getLogger(__name__)
+
+
+def download_video(url: str, output_folder: Path, clear_folder: bool = False) -> None:
+    """
+    Downloads a YouTube video to the specified folder using yt-dlp.
+    
+    Args:
+        url (str): The YouTube URL.
+        output_folder (Path): Destination directory.
+        clear_folder (bool): If True, deletes existing video files in the folder before download.
+    """
+    output_folder.mkdir(parents=True, exist_ok=True)
+
+    if clear_folder:
+        removed_count = remove_video_files(output_folder)
+        logger.info(f"Cleared {removed_count} video files from {output_folder}")
+
+    # Template: Folder/Title.ext
+    output_template = str(output_folder / "%(title)s.%(ext)s")
+
+    command = [
+        "yt-dlp",
+        "-f", "bestvideo+bestaudio/best",
+        "-o", output_template,
+        url,
+    ]
+
+    logger.info(f"Starting download: {url}")
+    try:
+        subprocess.run(command, check=True)
+        logger.info("Download completed successfully.")
+    except subprocess.CalledProcessError as e:
+        logger.error(f"Download failed: {e}")
+        raise

ffmpeg_tools-0.1.4/ffmpeg_tools/media.py

@@ -0,0 +1,95 @@
+"""
+ffmpeg_tools.media
+~~~~~~~~~~~~~~~~~~
+
+Utilities for file handling, cleaning, and validation of media files.
+"""
+
+import re
+import mimetypes
+import logging
+import subprocess
+from pathlib import Path
+from typing import Optional, List
+
+# Setup logger
+logger = logging.getLogger(__name__)
+
+
+def has_video_stream(file_path: Path) -> bool:
+    """
+    Checks if a file contains a video stream using ffprobe.
+    """
+    if not file_path.exists():
+        return False
+
+    cmd = [
+        "ffprobe",
+        "-v", "error",
+        "-select_streams", "v:0",
+        "-show_entries", "stream=codec_type",
+        "-of", "csv=p=0",
+        str(file_path)
+    ]
+    
+    try:
+        result = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+        return result.returncode == 0 and result.stdout.strip() == "video"
+    except Exception as e:
+        logger.error(f"Error checking video stream for '{file_path}': {e}")
+        return False
+
+
+def clean_filename(file_path: Path) -> Path:
+    """
+    Renames a file to be 'clean' (no spaces, special chars).
+    Returns the new Path object.
+    
+    Example: "My Video (2024).mp4" -> "My_Video_2024.mp4"
+    """
+    if not file_path.exists():
+        raise FileNotFoundError(f"File not found: {file_path}")
+
+    original_stem = file_path.stem
+    # Remove wrappers like [] () and replace spaces with underscores
+    clean_stem = re.sub(r"[_\[\]\(\)]", "", original_stem).replace(" ", "_")
+    
+    # Ensure it's not empty, fallback to 'video' if everything was stripped
+    if not clean_stem:
+        clean_stem = "video"
+        
+    new_name = f"{clean_stem}{file_path.suffix}"
+    new_path = file_path.parent / new_name
+    
+    if new_path != file_path:
+        try:
+            file_path.rename(new_path)
+            logger.info(f"Renamed '{file_path.name}' -> '{new_name}'")
+        except OSError as e:
+            logger.error(f"Failed to rename '{file_path}': {e}")
+            raise
+            
+    return new_path
+
+
+def remove_video_files(folder: Path) -> int:
+    """
+    Removes all video files from the specified folder.
+    Returns the count of removed files.
+    """
+    if not folder.exists():
+        return 0
+        
+    count = 0
+    for file in folder.iterdir():
+        if file.is_file():
+            mime, _ = mimetypes.guess_type(file)
+            # Basic mime check, can be expanded or use has_video_stream for strictness
+            if mime and mime.startswith("video"):
+                try:
+                    file.unlink()
+                    count += 1
+                    logger.debug(f"Deleted: {file.name}")
+                except OSError as e:
+                    logger.error(f"Failed to delete '{file}': {e}")
+    return count

ffmpeg_tools-0.1.4/ffmpeg_tools.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: ffmpeg_tools
+Version: 0.1.4
+Summary: A Python package for high-quality FFmpeg command generation and video utilities.
+Home-page: https://github.com/sudeepsudhevan/FFmpeg_pip
+Author: Sudeep Sudhevan
+Author-email: sudeepsudhevan66@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# FFmpeg Tools
+
+A Python package for simplified FFmpeg command generation, video downloading, and file management.
+
+## Installation
+
+```bash
+pip install ffmpeg-tools
+```
+
+## Usage
+
+### 1. Generating FFmpeg Commands
+
+```python
+from ffmpeg_tools import build_command
+
+# Generate a high-quality compression command
+cmd = build_command("compress_high_quality", input="video.mp4", output="compressed.mp4")
+print(cmd)
+# Output: ['ffmpeg', '-y', '-i', 'video.mp4', ...]
+```
+
+### 2. Downloading Videos
+
+```python
+from pathlib import Path
+from ffmpeg_tools import download_video
+
+# Download a video from YouTube
+download_video(
+    url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
+    output_folder=Path("downloads"),
+    clear_folder=False
+)
+```
+
+### 3. Cleaning Filenames
+
+```python
+from pathlib import Path
+from ffmpeg_tools import clean_filename
+
+file_path = Path("downloads/My Video (2024).mp4")
+new_path = clean_filename(file_path)
+print(new_path)
+# Output: downloads/My_Video_2024.mp4
+```
+
+## License
+
+MIT

ffmpeg_tools-0.1.4/ffmpeg_tools.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+setup.py
+ffmpeg_tools/__init__.py
+ffmpeg_tools/commands.py
+ffmpeg_tools/downloader.py
+ffmpeg_tools/media.py
+ffmpeg_tools.egg-info/PKG-INFO
+ffmpeg_tools.egg-info/SOURCES.txt
+ffmpeg_tools.egg-info/dependency_links.txt
+ffmpeg_tools.egg-info/requires.txt
+ffmpeg_tools.egg-info/top_level.txt

ffmpeg_tools-0.1.4/ffmpeg_tools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ffmpeg_tools-0.1.4/ffmpeg_tools.egg-info/requires.txt

@@ -0,0 +1 @@
+yt-dlp

ffmpeg_tools-0.1.4/ffmpeg_tools.egg-info/top_level.txt

@@ -0,0 +1 @@
+ffmpeg_tools

ffmpeg_tools-0.1.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ffmpeg_tools-0.1.4/setup.py

@@ -0,0 +1,22 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="ffmpeg_tools",
+    version="0.1.4",
+    description="A Python package for high-quality FFmpeg command generation and video utilities.",
+    long_description=open("README.md", "r", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="Sudeep Sudhevan",
+    author_email="sudeepsudhevan66@gmail.com",
+    url="https://github.com/sudeepsudhevan/FFmpeg_pip",
+    packages=find_packages(),
+    install_requires=[
+        "yt-dlp",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.7',
+)