PyVideoKit-Libs 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

pyvideokit_libs/convert_to_ffv1.py

@@ -7,7 +7,7 @@ from . import ffmpeg_utils as utils
 
 def convert_to_ffv1(
     input_path: Path,
-    fps: int = 60,
+    fps: int | None = None,
     output: str | None = None,
     on_progress: Callable[[float], None] | None = None,
 ) -> Path:
@@ -20,7 +20,10 @@ def convert_to_ffv1(
         "-i", str(input_path),
         "-map", "0",
         "-c:v", "ffv1",
-        "-r", str(fps),
+    ]
+    if fps is not None:
+        cmd += ["-r", str(fps)]
+    cmd += [
         "-c:a", "pcm_s16le",
         str(output_path),
     ]

pyvideokit_libs/fade_video.py

@@ -11,9 +11,8 @@ def _build_fade_cmd(
     fade_out: float | None,
     total_duration: float,
     output_path: Path,
-    fps: int,
 ) -> list[str]:
-    v_filters = [f"fps={fps}"]
+    v_filters = []
     if fade_in is not None:
         v_filters.append(f"fade=t=in:st=0:d={fade_in:.3f}")
     if fade_out is not None:
@@ -34,7 +33,6 @@ def _build_fade_cmd(
         "-i", str(input_path),
         "-c:v", "ffv1",
         "-pix_fmt", "yuv420p",
-        "-r", str(fps),
         "-vf", ",".join(v_filters),
     ]
     if af_chain:
@@ -49,7 +47,6 @@ def fade_video(
     input_path: Path,
     fade_in: float | None = None,
     fade_out: float | None = None,
-    fps: int = 60,
     output: str | None = None,
     on_progress: Callable[[float], None] | None = None,
 ) -> Path:
@@ -66,6 +63,6 @@ def fade_video(
     output_path = utils.resolve_output_path(
         utils.make_output_path(input_path, suffix="_fade"), output
     )
-    cmd = _build_fade_cmd(input_path, fade_in, fade_out, total_duration, output_path, fps)
+    cmd = _build_fade_cmd(input_path, fade_in, fade_out, total_duration, output_path)
     utils.run_ffmpeg_with_progress(cmd, duration=total_duration, on_progress=on_progress)
     return output_path

{pyvideokit_libs-0.2.0.dist-info → pyvideokit_libs-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyVideoKit-Libs
-Version: 0.2.0
+Version: 0.3.0
 Summary: Python library for FFmpeg-based video processing
 Author-email: Evilchuck666 <carlos.martinez.medina1992@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -686,7 +686,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-# 🎥 PyVideoKit-Libs
+# 🎬 PyVideoKit-Libs
 
 ![Python](https://img.shields.io/badge/python-%3E%3D3.10-blue)
 ![License](https://img.shields.io/badge/license-GPLv3-green)
@@ -698,10 +698,10 @@ Python library for FFmpeg-based video and audio processing. Provides the core fu
 ## ✨ Features
 
 - 📼 **VHS effect** — retro visual noise, color bleed, and audio degradation
-- ✂️ **Trim** — cut a segment by start/end time with stream copy
+- ✂️ **Trim** — cut a segment by start/end time with stream copy (no re-encoding)
 - 🔗 **Concatenate** — join multiple videos with stream compatibility validation
 - 🎬 **Fade** — fade-in and/or fade-out on an FFV1 master
-- 🔊 **Extract audio** — dump the audio track to uncompressed WAV
+- 🔊 **Extract audio** — dump the audio track to uncompressed WAV (PCM 16-bit)
 - 🎞️ **Convert to FFV1** — create a lossless MKV master for editing
 - 📺 **Prepare for YouTube** — encode to ProRes 422 HQ MOV, upscaled to 4K
 
@@ -719,10 +719,72 @@ No Python package dependencies — the library delegates all heavy lifting to ex
 
 ## 🔧 Installation
 
+### 🏗️ Arch Linux (AUR)
+
+```bash
+yay -S python-pyvideokit-libs
+```
+
+FFmpeg, FFprobe, and SoX are installed automatically as pacman dependencies.
+
+### 🐍 Other systems (pip)
+
+```bash
+pip install PyVideoKit-Libs
+```
+
+Make sure **FFmpeg**, **FFprobe**, and **SoX** are available in your `PATH`.
+
+---
+
+## 🖥️ Desktop Integration
+
+If you also have [PyVideoKit-GUI](https://pypi.org/project/PyVideoKit-GUI/) installed, you can add it to your application launcher. Arch Linux users get this automatically via the AUR package. For all other systems:
+
+**1. Save the icon:**
+
+```bash
+mkdir -p ~/.local/share/icons/hicolor/scalable/apps
+cat > ~/.local/share/icons/hicolor/scalable/apps/pvk-gui.svg << 'EOF'
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48">
+  <rect x="4" y="14" width="40" height="30" rx="3" fill="#2d3561"/>
+  <rect x="10" y="19" width="28" height="20" rx="2" fill="#1a2038"/>
+  <polygon points="18,21 18,37 33,29" fill="#ff6b6b"/>
+  <rect x="4" y="6" width="40" height="8" rx="2" fill="#ff6b6b"/>
+  <rect x="11" y="6" width="6" height="8" fill="#ffffff"/>
+  <rect x="23" y="6" width="6" height="8" fill="#ffffff"/>
+  <rect x="35" y="6" width="5" height="8" fill="#ffffff"/>
+</svg>
+EOF
+```
+
+**2. Create the `.desktop` entry:**
+
+```bash
+mkdir -p ~/.local/share/applications
+cat > ~/.local/share/applications/pvk-gui.desktop << 'EOF'
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=PyVideoKit
+GenericName=Video Processing Tool
+Comment=FFmpeg-based video processing GUI
+Exec=pvk-gui
+Icon=pvk-gui
+Categories=AudioVideo;Video;AudioVideoEditing;
+Terminal=false
+Keywords=video;ffmpeg;trim;fade;vhs;youtube;convert;
+EOF
+```
+
+**3. Refresh the icon cache** *(may be required on some desktop environments)*:
+
 ```bash
-pip install .
+gtk-update-icon-cache ~/.local/share/icons/hicolor/
 ```
 
+PyVideoKit will now appear in your application launcher.
+
 ---
 
 ## 🚀 Quick Start
@@ -782,7 +844,7 @@ out = join_videos([Path("clip1.mkv"), Path("clip2.mkv"), Path("clip3.mkv")])
 
 ---
 
-#### `fade_video(input_path, fade_in=None, fade_out=None, fps=60, output=None, on_progress=None) -> Path`
+#### `fade_video(input_path, fade_in=None, fade_out=None, output=None, on_progress=None) -> Path`
 
 Add fade-in and/or fade-out to an FFV1 video. Output is re-encoded as FFV1 with PCM audio.
 
@@ -802,12 +864,13 @@ out = extract_audio(Path("video.mkv"))
 
 ---
 
-#### `convert_to_ffv1(input_path, fps=60, output=None, on_progress=None) -> Path`
+#### `convert_to_ffv1(input_path, fps=None, output=None, on_progress=None) -> Path`
 
-Convert any video to a lossless FFV1/MKV master. Use this as the first step before applying effects.
+Convert any video to a lossless FFV1/MKV master. Use this as the first step before applying effects. `fps` defaults to `None` (preserve source frame rate); pass an integer to force a specific rate.
 
 ```python
-master = convert_to_ffv1(Path("recording.mp4"), fps=60)
+master = convert_to_ffv1(Path("recording.mp4"))        # preserve source fps
+master = convert_to_ffv1(Path("recording.mp4"), fps=60) # force 60 fps
 ```
 
 ---

{pyvideokit_libs-0.2.0.dist-info → pyvideokit_libs-0.3.0.dist-info}/RECORD

@@ -1,14 +1,14 @@
 pyvideokit_libs/__init__.py,sha256=HCb41JcZdwarzPmzzf0cmWHvlMElgaa2uxofJLzHdZM,1341
 pyvideokit_libs/apply_vhs_effect.py,sha256=qX8RXHO58B4LR8_GPtARyz7H_0h9k8sq1ba-bvvSmTA,4619
 pyvideokit_libs/concat_videos.py,sha256=_po7RW84vlisEvbv03YekXi29JdLCy_HIpAbSEqvLGU,2369
-pyvideokit_libs/convert_to_ffv1.py,sha256=hL5ZPRtK-ukE1LcJqKfIC1n6-2Uh-67WK7emU8lZaGw,782
+pyvideokit_libs/convert_to_ffv1.py,sha256=VWmWajo6_ofLDo5VLpTvQWbe48TFNA6zen9XtYfIvP0,842
 pyvideokit_libs/extract_audio.py,sha256=FoySaZnKKn80S4vwhKYyaEDIfjQSt_dhzc7YPqFuKUA,691
-pyvideokit_libs/fade_video.py,sha256=k5VkwtEHThFxEGEhusGhVk3UBLX8Wcd_XrhEgH0fbm8,2309
+pyvideokit_libs/fade_video.py,sha256=3tuUeTepo-K9j2xkb77KCVaCvGFzZ2fMNpcn0LYSHY0,2235
 pyvideokit_libs/ffmpeg_utils.py,sha256=8zzKyhml1zJRO5sNguMhKW1yGS3cTV5l_M85aTK-fOI,7798
 pyvideokit_libs/prepare_youtube.py,sha256=4tK2rob_W9Na1Y5lgD3AUgruNgFMq534KD3pdgIHJsY,1044
 pyvideokit_libs/trim_video.py,sha256=Oqb76JvJTPos_fsEYG44TiNYjyxmj-x5m_ebTyOR-os,1204
-pyvideokit_libs-0.2.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-pyvideokit_libs-0.2.0.dist-info/METADATA,sha256=4rJCnF6ncZnSv9Goq8g6goVq_uNF_5v7vpEKO8cyKzc,46553
-pyvideokit_libs-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-pyvideokit_libs-0.2.0.dist-info/top_level.txt,sha256=c7_48-dt9O7bTckB11y9fIfv0kE3oO9txvU6az99YjU,16
-pyvideokit_libs-0.2.0.dist-info/RECORD,,
+pyvideokit_libs-0.3.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+pyvideokit_libs-0.3.0.dist-info/METADATA,sha256=A1EyRqLzPqFY3u8KfvykFGvEIMdqxN3q-fyZoYSvsJk,48590
+pyvideokit_libs-0.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pyvideokit_libs-0.3.0.dist-info/top_level.txt,sha256=c7_48-dt9O7bTckB11y9fIfv0kE3oO9txvU6az99YjU,16
+pyvideokit_libs-0.3.0.dist-info/RECORD,,