ffmpeg-tools 0.1.7

A Python package for high-quality FFmpeg command generation and video utilities.

FFmpeg Tools

A Python package for simplified FFmpeg command generation, video downloading, and file management.

Installation

pip install ffmpeg-tools

Usage

1. Generating & Running FFmpeg Commands

from ffmpeg_tools import build_command, run_command

# 1. Build the command
cmd = build_command("compress_high_quality", input="video.mp4", output="compressed.mp4")

# 2. Run the command (returns True if successful)
success = run_command(cmd)

# Optional: Dry run to just print the command
run_command(cmd, dry_run=True)

2. Custom Commands (Dynamic JSON)

You can add your own FFmpeg command templates without modifying the package source.

from ffmpeg_tools.commands import add_command, build_command

# Add a new command template
add_command(
    name="my_custom_encode",
    command=["ffmpeg", "-y", "-i", "{input}", "-c:v", "libx264", "-preset", "fast", "{output}"],
    description="My custom fast encoding profile"
)

# Use the new command
cmd = build_command("my_custom_encode", input="video.mp4", output="video_fast.mp4")

The commands are stored in commands.json in the package directory.

from ffmpeg_tools import list_commands

# Print all available commands
list_commands()

3. Downloading Videos

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
)

4. Cleaning Filenames

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