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

pyvideokit_gui/convert_panel.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from PySide6.QtWidgets import QLabel, QSpinBox, QVBoxLayout
+from PySide6.QtWidgets import QCheckBox, QHBoxLayout, QLabel, QSpinBox, QVBoxLayout
 
 from pyvideokit_gui._base_panel import BasePanel
 from pyvideokit_libs import convert_to_ffv1
@@ -10,11 +10,17 @@ class ConvertPanel(BasePanel):
     def _build_ui(self, layout: QVBoxLayout):
         self._input = self._input_row(layout, "Input file")
 
-        layout.addWidget(QLabel("FPS"))
+        fps_row = QHBoxLayout()
+        self._fps_override = QCheckBox("Override FPS")
         self._fps = QSpinBox()
         self._fps.setRange(1, 240)
         self._fps.setValue(60)
-        layout.addWidget(self._fps)
+        self._fps.setEnabled(False)
+        self._fps_override.toggled.connect(self._fps.setEnabled)
+        fps_row.addWidget(self._fps_override)
+        fps_row.addWidget(self._fps)
+        fps_row.addStretch()
+        layout.addLayout(fps_row)
 
         self._output = self._output_row(layout, "Output MKV (optional)")
 
@@ -24,4 +30,5 @@ class ConvertPanel(BasePanel):
             self._status.setText("❌  Select an input file.")
             return
         output = self._output.text().strip() or None
-        self._start_worker(convert_to_ffv1, Path(path), fps=self._fps.value(), output=output)
+        fps = self._fps.value() if self._fps_override.isChecked() else None
+        self._start_worker(convert_to_ffv1, Path(path), fps=fps, output=output)

pyvideokit_gui/fade_panel.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from PySide6.QtWidgets import QDoubleSpinBox, QHBoxLayout, QLabel, QSpinBox, QVBoxLayout
+from PySide6.QtWidgets import QDoubleSpinBox, QHBoxLayout, QLabel, QVBoxLayout
 
 from pyvideokit_gui._base_panel import BasePanel
 from pyvideokit_libs import fade_video
@@ -30,12 +30,6 @@ class FadePanel(BasePanel):
         row.addLayout(fo_col)
         layout.addLayout(row)
 
-        layout.addWidget(QLabel("FPS"))
-        self._fps = QSpinBox()
-        self._fps.setRange(1, 240)
-        self._fps.setValue(60)
-        layout.addWidget(self._fps)
-
         self._output = self._output_row(layout, "Output (optional)")
 
     def _run(self):
@@ -54,6 +48,5 @@ class FadePanel(BasePanel):
             Path(path),
             fade_in=fi,
             fade_out=fo,
-            fps=self._fps.value(),
             output=output,
         )

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyVideoKit-GUI
-Version: 0.2.0
+Version: 0.3.0
 Summary: GUI for PyVideoKit — FFmpeg-based video processing
 Author-email: Evilchuck666 <carlos.martinez.medina1992@gmail.com>
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -687,3 +687,140 @@ License-File: LICENSE
 Requires-Dist: PySide6>=6.0
 Requires-Dist: PyVideoKit-Libs
 Dynamic: license-file
+
+# 🎬 PyVideoKit-GUI
+
+![Python](https://img.shields.io/badge/python-%3E%3D3.10-blue)
+![License](https://img.shields.io/badge/license-GPLv3-green)
+
+Graphical interface for PyVideoKit — FFmpeg-based video processing. Provides the same operations as [PyVideoKit-CLI](../PyVideoKit-CLI) through a PySide6 desktop application with real-time progress tracking.
+
+---
+
+## ✨ Features
+
+- 📼 **VHS effect** — retro visual noise, color bleed, and audio degradation
+- ✂️ **Trim** — cut a segment by start/end time with stream copy (no re-encoding)
+- 🔗 **Concatenate** — join multiple videos with drag-and-drop reordering
+- 🎬 **Fade** — fade-in and/or fade-out on an FFV1 master
+- 🔊 **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
+
+---
+
+## 📦 Requirements
+
+- **Python** ≥ 3.10
+- **PySide6** ≥ 6.0
+- **FFmpeg** and **FFprobe** available in `PATH`
+- **SoX** available in `PATH` (required by VHS effect)
+- **PyVideoKit-Libs** — installed automatically as a dependency
+
+---
+
+## 🔧 Installation
+
+### 🏗️ Arch Linux (AUR)
+
+```bash
+yay -S python-pyvideokit-gui
+```
+
+FFmpeg, FFprobe, SoX, PySide6, and PyVideoKit-Libs are installed automatically as pacman dependencies.
+
+### 🐍 Other systems (pip)
+
+```bash
+pip install PyVideoKit-GUI
+```
+
+Make sure **FFmpeg**, **FFprobe**, and **SoX** are available in your `PATH`.
+
+---
+
+## 🖥️ Desktop Integration
+
+Arch Linux users get the launcher entry and icon automatically via the AUR package. For all other systems, create them manually:
+
+**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
+gtk-update-icon-cache ~/.local/share/icons/hicolor/
+```
+
+PyVideoKit will now appear in your application launcher.
+
+---
+
+## 🚀 Usage
+
+```bash
+pvk-gui
+```
+
+The application opens a tabbed window. Each tab corresponds to one operation:
+
+| Tab | Operation |
+|---|---|
+| 🎞️ Convert to FFV1 | Convert any video to a lossless FFV1/MKV master |
+| ✂️ Trim | Cut a segment by start/end time (no re-encoding) |
+| 🔗 Concat | Join multiple videos (drag to reorder) |
+| 🎬 Fade | Add fade-in and/or fade-out |
+| 📼 VHS Effect | Apply retro VHS visual and audio effect |
+| 🔊 Extract Audio | Export audio track to WAV |
+| 📺 YouTube | Encode to ProRes 422 HQ MOV for upload |
+
+All operations run in a background thread and display a real-time progress bar.
+
+---
+
+## 🔄 Typical Workflow
+
+```
+🎞️ Convert to FFV1  →  ✂️ Trim / 🎬 Fade / 📼 VHS Effect  →  📺 YouTube
+```
+
+> Operations that re-encode (Fade, VHS Effect, YouTube) expect an FFV1 `.mkv` as input.
+
+---
+
+## ⚖️ License
+
+This project is licensed under the GPLv3 License — see the [LICENSE](LICENSE) file for details.

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

@@ -4,15 +4,15 @@ pyvideokit_gui/_main.py,sha256=-iyypcAoThr7Ysa4rvrJ7hYq-cd8h8RqYxL77_lkDqM,331
 pyvideokit_gui/_main_window.py,sha256=Pls03EJ9CoREhV1eiYavVg9oK0Z8JmXyAUFTGHc0pAU,1032
 pyvideokit_gui/_worker.py,sha256=1f151Q0F2JzpHFxczl4ex0mP6Vf1h-c2ZQuJL5CGv9o,574
 pyvideokit_gui/concat_panel.py,sha256=FSg0-FQpALW4fD9rBIxX89DlkVq56h2VJDJnN3kEg7A,1734
-pyvideokit_gui/convert_panel.py,sha256=BVs1ltCslHkRtb3MxpUlYGkM4fA11odiEp9nP4mq9hI,880
+pyvideokit_gui/convert_panel.py,sha256=7HaDpuhatgOw1TvTvYNXPWcwwNb4QQwWwYXmMzQYYx4,1224
 pyvideokit_gui/extract_audio_panel.py,sha256=NADJT0rkNhO61dKDebYZdQhZUvjmW833OHygCU8746Q,665
-pyvideokit_gui/fade_panel.py,sha256=kpGfikGDY_VPJqPPlYEjPD4dAAkcWhzJIGYEg_I1zfY,1853
+pyvideokit_gui/fade_panel.py,sha256=8h6T4O-56qs8BMA3SH0tOfbL_2ym3LZ95NzLFUi9vrw,1634
 pyvideokit_gui/trim_panel.py,sha256=yjdVhwxmfaSp2aflOywWlmW4WwFgtVKfGzqhUxac0UI,1425
 pyvideokit_gui/vhs_panel.py,sha256=DMCcXIB1_bZD8RvmXujJwb27ODOlF_e8NOL-QEv1wZs,680
 pyvideokit_gui/youtube_panel.py,sha256=4LogFd2Cc4Fj2xRM5RQsYBW4M9aW_pb-BJrGlBM4Hc0,671
-pyvideokit_gui-0.2.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-pyvideokit_gui-0.2.0.dist-info/METADATA,sha256=jPLAHBUTDWR_2kIJ-0DCPeWrnZva37-KjPSCAXJm6Bo,41076
-pyvideokit_gui-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-pyvideokit_gui-0.2.0.dist-info/entry_points.txt,sha256=svm4llnRZU8Y0-2ThznB9avSUowxpuDxZc2rBfedrX0,54
-pyvideokit_gui-0.2.0.dist-info/top_level.txt,sha256=SDnrDTKTriy3iVrM4dlbpb2fDHWjnzLK9bZ05nzRl0U,15
-pyvideokit_gui-0.2.0.dist-info/RECORD,,
+pyvideokit_gui-0.3.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+pyvideokit_gui-0.3.0.dist-info/METADATA,sha256=8rpdzn1ag15rh0UD-nTwycx0qx_K9ovkzqJASe3IZV4,45053
+pyvideokit_gui-0.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pyvideokit_gui-0.3.0.dist-info/entry_points.txt,sha256=svm4llnRZU8Y0-2ThznB9avSUowxpuDxZc2rBfedrX0,54
+pyvideokit_gui-0.3.0.dist-info/top_level.txt,sha256=SDnrDTKTriy3iVrM4dlbpb2fDHWjnzLK9bZ05nzRl0U,15
+pyvideokit_gui-0.3.0.dist-info/RECORD,,