PyVideoKit-CLI 0.2.0__py3-none-any.whl

pyvideokit_cli/_helpers.py

@@ -0,0 +1,54 @@
+from collections.abc import Callable, Generator
+from contextlib import contextmanager
+
+import click
+from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
+
+from pyvideokit_libs import FFmpegError, parse_time_to_seconds
+
+
+@contextmanager
+def track_progress(label: str) -> Generator[Callable[[float], None], None, None]:
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[bold]{task.description}"),
+        BarColumn(),
+        TextColumn("{task.percentage:>5.1f}%"),
+        TimeElapsedColumn(),
+        transient=True,
+    ) as progress:
+        task = progress.add_task(label, total=100.0)
+
+        def on_progress(pct: float) -> None:
+            progress.update(task, completed=pct)
+
+        yield on_progress
+
+
+@contextmanager
+def handle_errors() -> Generator[None, None, None]:
+    try:
+        yield
+    except (FileNotFoundError, ValueError, RuntimeError) as e:
+        raise click.ClickException(str(e))
+    except FFmpegError as e:
+        click.echo(f"FFmpeg failed (exit {e.returncode}):", err=True)
+        for line in e.error_lines:
+            click.echo(f"  {line}", err=True)
+        raise click.exceptions.Exit(e.returncode)
+
+
+class TimeParam(click.ParamType):
+    name = "TIME"
+
+    def convert(self, value, param, ctx):
+        try:
+            result = parse_time_to_seconds(str(value))
+        except ValueError as e:
+            self.fail(str(e), param, ctx)
+        if result is None:
+            self.fail("Empty time value", param, ctx)
+        return result
+
+
+TIME = TimeParam()

pyvideokit_cli/_main.py

@@ -0,0 +1,24 @@
+import click
+
+from .apply_vhs_effect import cmd as cmd_apply
+from .concat_videos import cmd as cmd_concat
+from .convert_to_ffv1 import cmd as cmd_convert
+from .extract_audio import cmd as cmd_extract
+from .fade_video import cmd as cmd_fade
+from .prepare_youtube import cmd as cmd_prepare
+from .trim_video import cmd as cmd_trim
+
+
+@click.group()
+@click.version_option("0.1.0")
+def cli():
+    """PyVideoKit CLI — FFmpeg-based video processing tools."""
+
+
+cli.add_command(cmd_apply, "apply-vhs-effect")
+cli.add_command(cmd_concat, "concat-videos")
+cli.add_command(cmd_convert, "convert-to-ffv1")
+cli.add_command(cmd_extract, "extract-audio")
+cli.add_command(cmd_fade, "fade-video")
+cli.add_command(cmd_prepare, "prepare-youtube")
+cli.add_command(cmd_trim, "trim-video")

pyvideokit_cli/apply_vhs_effect.py

@@ -0,0 +1,21 @@
+from pathlib import Path
+
+import click
+
+from pyvideokit_libs import apply_vhs_effect
+
+from ._helpers import handle_errors, track_progress
+
+
+@click.command("apply-vhs-effect")
+@click.argument("input", type=click.Path(exists=True))
+@click.option("-o", "--output", default=None, help="Output file or directory.")
+def cmd(input, output):
+    """Apply VHS visual and audio effect to a video."""
+    with handle_errors():
+        with track_progress("Applying VHS effect") as on_progress:
+            out = apply_vhs_effect(Path(input), output=output, on_progress=on_progress)
+    click.echo(str(out))
+
+
+main = cmd

pyvideokit_cli/concat_videos.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+
+import click
+
+from pyvideokit_libs import join_videos
+
+from ._helpers import handle_errors, track_progress
+
+
+@click.command("concat-videos")
+@click.argument("videos", nargs=-1, type=click.Path(exists=True), required=True)
+@click.option("-o", "--output", default=None, help="Output file or directory.")
+def cmd(videos, output):
+    """Concatenate two or more videos (lossless stream copy)."""
+    if len(videos) < 2:
+        raise click.UsageError("Provide at least two input videos.")
+    with handle_errors():
+        with track_progress("Concatenating") as on_progress:
+            out = join_videos([Path(v) for v in videos], output=output, on_progress=on_progress)
+    click.echo(str(out))
+
+
+main = cmd

pyvideokit_cli/convert_to_ffv1.py

@@ -0,0 +1,22 @@
+from pathlib import Path
+
+import click
+
+from pyvideokit_libs import convert_to_ffv1
+
+from ._helpers import handle_errors, track_progress
+
+
+@click.command("convert-to-ffv1")
+@click.argument("input", type=click.Path(exists=True))
+@click.option("--fps", default=60, show_default=True, help="Output frame rate.")
+@click.option("-o", "--output", default=None, help="Output file or directory.")
+def cmd(input, fps, output):
+    """Convert video to lossless FFV1/MKV format."""
+    with handle_errors():
+        with track_progress("Converting to FFV1") as on_progress:
+            out = convert_to_ffv1(Path(input), fps=fps, output=output, on_progress=on_progress)
+    click.echo(str(out))
+
+
+main = cmd

pyvideokit_cli/extract_audio.py

@@ -0,0 +1,21 @@
+from pathlib import Path
+
+import click
+
+from pyvideokit_libs import extract_audio
+
+from ._helpers import handle_errors, track_progress
+
+
+@click.command("extract-audio")
+@click.argument("input", type=click.Path(exists=True))
+@click.option("-o", "--output", default=None, help="Output file or directory.")
+def cmd(input, output):
+    """Extract audio track to WAV (pcm_s16le)."""
+    with handle_errors():
+        with track_progress("Extracting audio") as on_progress:
+            out = extract_audio(Path(input), output=output, on_progress=on_progress)
+    click.echo(str(out))
+
+
+main = cmd

pyvideokit_cli/fade_video.py

@@ -0,0 +1,35 @@
+from pathlib import Path
+
+import click
+
+from pyvideokit_libs import fade_video
+
+from ._helpers import handle_errors, track_progress
+
+
+@click.command("fade-video")
+@click.argument("input", type=click.Path(exists=True))
+@click.option("--fade", default=None, type=float, help="Fade-in and fade-out duration in seconds (shorthand).")
+@click.option("--fade-in", "fade_in", default=None, type=float, help="Fade-in duration in seconds.")
+@click.option("--fade-out", "fade_out", default=None, type=float, help="Fade-out duration in seconds.")
+@click.option("--fps", default=60, show_default=True, help="Output frame rate.")
+@click.option("-o", "--output", default=None, help="Output file or directory.")
+def cmd(input, fade, fade_in, fade_out, fps, output):
+    """Add fade-in and/or fade-out to an FFV1 video."""
+    if fade is not None:
+        fade_in = fade_in if fade_in is not None else fade
+        fade_out = fade_out if fade_out is not None else fade
+    with handle_errors():
+        with track_progress("Applying fade") as on_progress:
+            out = fade_video(
+                Path(input),
+                fade_in=fade_in,
+                fade_out=fade_out,
+                fps=fps,
+                output=output,
+                on_progress=on_progress,
+            )
+    click.echo(str(out))
+
+
+main = cmd

pyvideokit_cli/prepare_youtube.py

@@ -0,0 +1,21 @@
+from pathlib import Path
+
+import click
+
+from pyvideokit_libs import prepare_youtube
+
+from ._helpers import handle_errors, track_progress
+
+
+@click.command("prepare-youtube")
+@click.argument("input", type=click.Path(exists=True))
+@click.option("-o", "--output", default=None, help="Output file or directory.")
+def cmd(input, output):
+    """Encode FFV1 master to ProRes 422 HQ MOV for YouTube upload."""
+    with handle_errors():
+        with track_progress("Encoding for YouTube") as on_progress:
+            out = prepare_youtube(Path(input), output=output, on_progress=on_progress)
+    click.echo(str(out))
+
+
+main = cmd

pyvideokit_cli/trim_video.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+
+import click
+
+from pyvideokit_libs import trim_video
+
+from ._helpers import TIME, handle_errors, track_progress
+
+
+@click.command("trim-video")
+@click.argument("input", type=click.Path(exists=True))
+@click.option("--start", required=True, type=TIME, help="Start time (seconds or HH:MM:SS).")
+@click.option("--end", required=True, type=TIME, help="End time (seconds or HH:MM:SS).")
+@click.option("-o", "--output", default=None, help="Output file or directory.")
+def cmd(input, start, end, output):
+    """Cut a segment from a video (stream copy, no re-encoding)."""
+    with handle_errors():
+        with track_progress("Trimming") as on_progress:
+            out = trim_video(Path(input), start=start, end=end, output=output, on_progress=on_progress)
+    click.echo(str(out))
+
+
+main = cmd