core-flux 0.2__tar.gz

core_flux-0.2/.gitignore

@@ -0,0 +1,9 @@
+# Python build artifacts
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+
+# Local media tests
+*.mp4

core_flux-0.2/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: core-flux
+Version: 0.2
+Summary: A blazing fast video editing library wrapping FFmpeg native filters.
+Author: Faaris
+Description-Content-Type: text/markdown
+Classifier: Programming Language :: Python :: 3
+Requires-Dist: ffmpeg-python>=0.2.0
+
+# FastVideo 🚀
+
+A high-performance video editing library built on top of native FFmpeg filters.
+
+---
+
+## Installation
+
+```bash
+pip install core-flux
+```
+
+## Quick Start
+
+```python
+from fastvideo import FastVideo
+
+video = FastVideo("input.mp4")
+
+# Trim, resize, punch up colors, and fade out
+(
+    video
+    .trim(start_time=2, end_time=7)
+    .resize(1280, 720)
+    .adjust_colors(contrast=1.3, saturation=1.4)
+    .fade_out(start_fade=4.0, duration=1.0)
+    .render("output.mp4")
+)
+```
+
+## Features
+
+- **Trimming** — cut clips to exact start and end times
+- **Resizing** — scale video to any resolution
+- **Color grading** — tweak contrast and saturation with simple parameters
+- **Fade effects** — add smooth fade-outs with configurable timing
+- **Chainable API** — compose operations fluently in a single expression
+- **FFmpeg-native** — all processing runs through battle-tested FFmpeg filters for maximum performance
+
+## API Reference
+
+### `FastVideo(path)`
+
+Load a video file for editing.
+
+```python
+video = FastVideo("input.mp4")
+```
+
+### `.trim(start_time, end_time)`
+
+Cut the video between two timestamps (in seconds).
+
+```python
+video.trim(start_time=2, end_time=7)
+```
+
+### `.resize(width, height)`
+
+Scale the video to the given dimensions in pixels.
+
+```python
+video.resize(1280, 720)
+```
+
+### `.adjust_colors(contrast, saturation)`
+
+Adjust contrast and saturation. Values above `1.0` increase the effect; below `1.0` decrease it.
+
+```python
+video.adjust_colors(contrast=1.3, saturation=1.4)
+```
+
+### `.fade_out(start_fade, duration)`
+
+Add a fade-to-black effect starting at `start_fade` seconds, lasting `duration` seconds.
+
+```python
+video.fade_out(start_fade=4.0, duration=1.0)
+```
+
+### `.render(output_path)`
+
+Write the processed video to disk.
+
+```python
+video.render("output.mp4")
+```
+
+## Requirements
+
+- Python 3.8+
+- FFmpeg installed and available on your `PATH`
+
+## License
+
+MIT

core_flux-0.2/README.md

@@ -0,0 +1,97 @@
+# FastVideo 🚀
+
+A high-performance video editing library built on top of native FFmpeg filters.
+
+---
+
+## Installation
+
+```bash
+pip install core-flux
+```
+
+## Quick Start
+
+```python
+from fastvideo import FastVideo
+
+video = FastVideo("input.mp4")
+
+# Trim, resize, punch up colors, and fade out
+(
+    video
+    .trim(start_time=2, end_time=7)
+    .resize(1280, 720)
+    .adjust_colors(contrast=1.3, saturation=1.4)
+    .fade_out(start_fade=4.0, duration=1.0)
+    .render("output.mp4")
+)
+```
+
+## Features
+
+- **Trimming** — cut clips to exact start and end times
+- **Resizing** — scale video to any resolution
+- **Color grading** — tweak contrast and saturation with simple parameters
+- **Fade effects** — add smooth fade-outs with configurable timing
+- **Chainable API** — compose operations fluently in a single expression
+- **FFmpeg-native** — all processing runs through battle-tested FFmpeg filters for maximum performance
+
+## API Reference
+
+### `FastVideo(path)`
+
+Load a video file for editing.
+
+```python
+video = FastVideo("input.mp4")
+```
+
+### `.trim(start_time, end_time)`
+
+Cut the video between two timestamps (in seconds).
+
+```python
+video.trim(start_time=2, end_time=7)
+```
+
+### `.resize(width, height)`
+
+Scale the video to the given dimensions in pixels.
+
+```python
+video.resize(1280, 720)
+```
+
+### `.adjust_colors(contrast, saturation)`
+
+Adjust contrast and saturation. Values above `1.0` increase the effect; below `1.0` decrease it.
+
+```python
+video.adjust_colors(contrast=1.3, saturation=1.4)
+```
+
+### `.fade_out(start_fade, duration)`
+
+Add a fade-to-black effect starting at `start_fade` seconds, lasting `duration` seconds.
+
+```python
+video.fade_out(start_fade=4.0, duration=1.0)
+```
+
+### `.render(output_path)`
+
+Write the processed video to disk.
+
+```python
+video.render("output.mp4")
+```
+
+## Requirements
+
+- Python 3.8+
+- FFmpeg installed and available on your `PATH`
+
+## License
+
+MIT

core_flux-0.2/fastvideo/__init__.py

@@ -0,0 +1,3 @@
+from .engine import FastVideo
+
+__version__ = "0.1.0"

core_flux-0.2/fastvideo/engine.py

@@ -0,0 +1,62 @@
+import ffmpeg
+import time  # New import to measure speed!
+
+class FastVideo:
+    def __init__(self, input_path):
+        """Initialize the toolkit with an input video path."""
+        self.input_path = input_path
+        self.video_stream = ffmpeg.input(input_path)
+        self.audio_stream = ffmpeg.input(input_path).audio
+
+    def resize(self, width, height):
+        """Resizes the video using FFmpeg's native scale filter."""
+        self.video_stream = self.video_stream.filter('scale', width, height)
+        return self
+
+    def adjust_colors(self, contrast=1.0, brightness=0.0, saturation=1.0):
+        """Adjusts video contrast, brightness, and saturation."""
+        self.video_stream = self.video_stream.filter(
+            'eq', 
+            contrast=contrast, 
+            brightness=brightness, 
+            saturation=saturation
+        )
+        return self
+
+    def trim(self, start_time, end_time):
+        """Cuts the video and audio to only keep the section between start_time and end_time (in seconds)."""
+        # Trim the video pixels
+        self.video_stream = self.video_stream.filter('trim', start=start_time, end=end_time).filter('setpts', 'PTS-STARTPTS')
+        # Trim the audio sync'd up with the video
+        self.audio_stream = self.audio_stream.filter('atrim', start=start_time, end=end_time).filter('asetpts', 'PTS-STARTPTS')
+        return self
+
+    def fade_out(self, start_fade, duration=1.0):
+        """Smoothly fades the video to black. start_fade is when it begins, duration is how long it takes."""
+        self.video_stream = self.video_stream.filter('fade', type='out', start_time=start_fade, duration=duration)
+        return self
+
+    def render(self, output_path):
+        """Fuses video/audio together, runs the engine, and times the execution."""
+        print(f"🚀 Sending commands to FFmpeg... Rendering {output_path}")
+        
+        # Start the stopwatch
+        start_clock = time.time()
+        
+        output = ffmpeg.output(
+            self.video_stream, 
+            self.audio_stream, 
+            output_path,
+            vcodec='libx264',   
+            acodec='aac',       
+            pix_fmt='yuv420p'   
+        )
+        
+        output.overwrite_output().run()
+        
+        # Stop the stopwatch
+        end_clock = time.time()
+        time_taken = end_clock - start_clock
+        
+        print("✅ Render Complete!")
+        print(f"⏱️  Execution Time: {time_taken:.2f} seconds")

core_flux-0.2/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["flit_core >=3.2,<4"]
+build-backend = "flit_core.buildapi"
+
+[project]
+name = "core-flux"
+version = "0.2"
+description = "A blazing fast video editing library wrapping FFmpeg native filters."
+readme = "README.md"
+authors = [{name = "Faaris"}]
+classifiers = ["Programming Language :: Python :: 3"]
+dependencies = [
+    "ffmpeg-python>=0.2.0"
+]
+
+[tool.flit.module]
+name = "fastvideo"