embedded ffmpeg

Author: DimazzzZ

.github/workflows/build.yml

@@ -13,6 +13,10 @@ on:
         default: 'linux,windows,macos'
         type: string
 
+permissions:
+  contents: write
+  packages: read
+
 jobs:
   test:
     name: Run Tests
@@ -26,26 +30,27 @@ jobs:
         with:
           version: 0.15.1
 
-      - name: Install FFmpeg
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y ffmpeg
-
-      - name: Run tests
+      - name: Run unit tests
         run: zig build test
 
-      - name: Build for testing
+      - name: Build for testing (FFmpeg downloaded automatically)
         run: zig build
 
       - name: Run integration tests
+        run: zig build test-integration
+
+      - name: Test CLI functionality
         run: |
+          # Create test-media directory
+          mkdir -p test-media
+          
           # Test video generation
-          ./zig-out/bin/media-gen video --duration 2 --output test_video.mp4
-          test -f test_video.mp4
+          ./zig-out/bin/media-gen video --duration 2 --output test-media/ci_test_video.mp4
+          test -f test-media/ci_test_video.mp4
           
           # Test audio generation
-          ./zig-out/bin/media-gen audio --duration 2 --output test_audio.mp3
-          test -f test_audio.mp3
+          ./zig-out/bin/media-gen audio --duration 2 --output test-media/ci_test_audio.mp3
+          test -f test-media/ci_test_audio.mp3
           
           # Test help command
           ./zig-out/bin/media-gen help
@@ -116,12 +121,41 @@ jobs:
           path: artifacts
 
       - name: Create release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           tag_name: v${{ github.run_number }}
-          name: Release v${{ github.run_number }}
+          name: "Media Generator v${{ github.run_number }} - Embedded FFmpeg Edition"
           draft: false
           prerelease: false
           files: artifacts/**/*
+          body: |
+            ## Media Generator - Embedded FFmpeg Edition
+            
+            **No external dependencies required!** FFmpeg is embedded directly into the executable.
+            
+            ### Downloads
+            - **Linux x86_64**: `media-gen-linux-x86_64`
+            - **Windows x86_64**: `media-gen-windows-x86_64.exe`
+            - **macOS Intel**: `media-gen-macos-x86_64`
+            - **macOS ARM64**: `media-gen-macos-arm64`
+            
+            ### Usage
+            ```bash
+            # Generate video with countdown
+            ./media-gen video --duration 10 --output countdown.mp4
+            
+            # Generate audio test tone
+            ./media-gen audio --frequency 440 --duration 5 --output tone.wav
+            
+            # Show help
+            ./media-gen help
+            ```
+            
+            ### Features
+            - 🎬 Video generation with animated countdown timer
+            - 🎵 Audio generation with configurable sine wave test tones
+            - 🎯 Multiple formats: MP4, AVI, MOV, MKV, MP3, WAV, AAC, FLAC
+            - 📦 Zero dependencies - FFmpeg embedded
+            - 🚀 Cross-platform support
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/manual-build.yml

@@ -77,7 +77,7 @@ jobs:
         with:
           version: 0.15.1
 
-      - name: Build for ${{ matrix.target }}
+      - name: Build for ${{ matrix.target }} (FFmpeg embedded automatically)
         run: zig build -Dtarget=${{ matrix.target }} -Doptimize=${{ github.event.inputs.optimize }}
 
       - name: Copy artifact (Unix)

.github/workflows/test.yml

@@ -49,41 +49,28 @@ jobs:
         with:
           version: 0.15.1
 
-      - name: Install FFmpeg (Ubuntu)
-        if: matrix.os == 'ubuntu-latest'
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y ffmpeg
-
-      - name: Install FFmpeg (macOS)
-        if: matrix.os == 'macos-latest'
-        run: brew install ffmpeg
-
-      - name: Install FFmpeg (Windows)
-        if: matrix.os == 'windows-latest'
-        run: |
-          choco install ffmpeg -y
-          echo "C:\ProgramData\chocolatey\lib\ffmpeg\tools\ffmpeg\bin" >> $GITHUB_PATH
-
-      - name: Build application
+      - name: Build application (FFmpeg downloaded automatically)
         run: zig build
 
       - name: Test video generation
         shell: bash
         run: |
+          # Create test-media directory
+          mkdir -p test-media
+          
           if [[ "${{ matrix.os }}" == "windows-latest" ]]; then
-            ./zig-out/bin/media-gen.exe video --duration 2 --width 640 --height 480 --output test_video.mp4
+            ./zig-out/bin/media-gen.exe video --duration 2 --width 640 --height 480 --output test-media/test_video.mp4
           else
-            ./zig-out/bin/media-gen video --duration 2 --width 640 --height 480 --output test_video.mp4
+            ./zig-out/bin/media-gen video --duration 2 --width 640 --height 480 --output test-media/test_video.mp4
           fi
           
           # Check if file exists and has reasonable size
-          if [[ ! -f test_video.mp4 ]]; then
+          if [[ ! -f test-media/test_video.mp4 ]]; then
             echo "Video file was not created"
             exit 1
           fi
           
-          file_size=$(stat -f%z test_video.mp4 2>/dev/null || stat -c%s test_video.mp4)
+          file_size=$(stat -f%z test-media/test_video.mp4 2>/dev/null || stat -c%s test-media/test_video.mp4)
           if [[ $file_size -lt 1000 ]]; then
             echo "Video file is too small: $file_size bytes"
             exit 1
@@ -95,18 +82,18 @@ jobs:
         shell: bash
         run: |
           if [[ "${{ matrix.os }}" == "windows-latest" ]]; then
-            ./zig-out/bin/media-gen.exe audio --duration 2 --sample-rate 44100 --output test_audio.mp3
+            ./zig-out/bin/media-gen.exe audio --duration 2 --sample-rate 44100 --output test-media/test_audio.mp3
           else
-            ./zig-out/bin/media-gen audio --duration 2 --sample-rate 44100 --output test_audio.mp3
+            ./zig-out/bin/media-gen audio --duration 2 --sample-rate 44100 --output test-media/test_audio.mp3
           fi
           
           # Check if file exists and has reasonable size
-          if [[ ! -f test_audio.mp3 ]]; then
+          if [[ ! -f test-media/test_audio.mp3 ]]; then
             echo "Audio file was not created"
             exit 1
           fi
           
-          file_size=$(stat -f%z test_audio.mp3 2>/dev/null || stat -c%s test_audio.mp3)
+          file_size=$(stat -f%z test-media/test_audio.mp3 2>/dev/null || stat -c%s test-media/test_audio.mp3)
           if [[ $file_size -lt 1000 ]]; then
             echo "Audio file is too small: $file_size bytes"
             exit 1
@@ -151,26 +138,22 @@ jobs:
         with:
           version: 0.15.1
 
-      - name: Install FFmpeg
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y ffmpeg
-
-      - name: Build application
+      - name: Build application (embedded FFmpeg)
         run: zig build -Doptimize=ReleaseFast
 
       - name: Performance test - Video generation
         run: |
+          mkdir -p test-media
           echo "Testing video generation performance..."
-          time ./zig-out/bin/media-gen video --duration 10 --output perf_test_video.mp4
+          time ./zig-out/bin/media-gen video --duration 10 --output test-media/perf_test_video.mp4
           
-          file_size=$(stat -c%s perf_test_video.mp4)
+          file_size=$(stat -c%s test-media/perf_test_video.mp4)
           echo "Generated video size: $file_size bytes"
 
       - name: Performance test - Audio generation
         run: |
           echo "Testing audio generation performance..."
-          time ./zig-out/bin/media-gen audio --duration 10 --output perf_test_audio.mp3
+          time ./zig-out/bin/media-gen audio --duration 10 --output test-media/perf_test_audio.mp3
           
-          file_size=$(stat -c%s perf_test_audio.mp3)
+          file_size=$(stat -c%s test-media/perf_test_audio.mp3)
           echo "Generated audio size: $file_size bytes"

.gitignore

@@ -18,20 +18,15 @@ Thumbs.db
 
 # Test artifacts
 test-media
-test_*.mp4
-test_*.mp3
-test_*.avi
-test_*.wav
-test_*.flac
-*_test.*
-ci_test_*
-debug_test.*
-manual_*.*
-perf_test_*
-*.yamllint.yml
 
 # Build artifacts from build-all.sh
 media-gen-*
 
+# FFmpeg binaries (downloaded during build)
+src/vendor/
+
+# Temporary files
+temp/
+
 # Keep important files
 !LICENSE

CHANGELOG.md

@@ -8,19 +8,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] - 2025-10-11
 
 ### Added
+- FFmpeg is embedded directly into the executable
+- No external dependencies required - works out of the box
 - Video generation with animated countdown timer
-- Audio generation with sine wave test tones
+- Audio generation with configurable sine wave test tones
 - Support for multiple video formats: MP4, AVI, MOV, MKV
 - Support for multiple audio formats: MP3, WAV, AAC, FLAC
 - Configurable video parameters: resolution, bitrate, FPS, duration, codec
-- Configurable audio parameters: sample rate, bitrate, duration, codec
+- Configurable audio parameters: sample rate, bitrate, duration, codec, frequency
 - Cross-platform support: Windows, macOS (Intel & ARM), Linux
 - Command-line interface with comprehensive help system
 - Automatic codec selection for different audio formats
-- Cross-platform build scripts and CI/CD pipeline
+- Comprehensive test suite with unit and integration tests
 
 ### Technical
 - Built with Zig 0.15+ for optimal performance
-- Uses FFmpeg for media processing
-- Comprehensive test suite with unit and integration tests
-- GitHub Actions workflows for automated building and testing
+- FFmpeg binaries embedded using `@embedFile()` for zero-dependency deployment
+- Automatic FFmpeg extraction and execution at runtime
+- Fallback to system FFmpeg if available for better performance
+- Cross-platform binary embedding for Linux, Windows, and macOS
+- Comprehensive test coverage including FFmpeg extraction tests

README.md

@@ -2,17 +2,20 @@
 
 A fast, cross-platform command-line utility for generating test media files with customizable parameters. Perfect for testing applications, creating placeholder content, or generating media samples.
 
+**No external dependencies required** - FFmpeg is embedded directly into the executable!
+
 [![Build and Test](https://github.com/DimazzzZ/media-gen/actions/workflows/build.yml/badge.svg)](https://github.com/DimazzzZ/media-gen/actions/workflows/build.yml)
 [![Test Suite](https://github.com/DimazzzZ/media-gen/actions/workflows/test.yml/badge.svg)](https://github.com/DimazzzZ/media-gen/actions/workflows/test.yml)
 
 ## ✨ Features
 
 - 🎬 **Video generation** with animated countdown timer
-- 🎵 **Audio generation** with customizable test tones
+- 🎵 **Audio generation** with customizable sine wave test tones
 - 🎯 **Multiple formats** - MP4, AVI, MOV, MKV, MP3, WAV, AAC, FLAC
-- ⚙️ **Highly configurable** - resolution, bitrate, duration, codecs
+- ⚙️ **Highly configurable** - resolution, bitrate, duration, codecs, frequency
 - 🚀 **Cross-platform** - Windows, macOS, Linux (Intel & ARM)
 - ⚡ **Fast** - Built with Zig for optimal performance
+- 📦 **Zero dependencies** - FFmpeg embedded, no installation required
 
 ## 🚀 Quick Start
 
@@ -26,10 +29,11 @@ Download the latest release for your platform:
 
 ### Requirements
 
-- **FFmpeg** must be installed on your system
-  - **Ubuntu/Debian**: `sudo apt install ffmpeg`
-  - **macOS**: `brew install ffmpeg`
-  - **Windows**: Download from [ffmpeg.org](https://ffmpeg.org/download.html)
+**None!** FFmpeg is embedded directly into the executable.
+
+- No external dependencies to install
+- No system configuration required
+- Works out of the box on all supported platforms
 
 ### Basic Usage
 
@@ -40,6 +44,9 @@ Download the latest release for your platform:
 # Generate a 30-second audio test tone
 ./media-gen audio --duration 30 --output test-tone.mp3
 
+# Generate custom frequency audio
+./media-gen audio --frequency 880 --duration 5 --output tone.wav
+
 # Show help
 ./media-gen help
 ```
@@ -111,6 +118,18 @@ Create test audio files with sine wave tones:
 
 ### Audio Options
 
+| Option | Description | Default | Examples |
+|--------|-------------|---------|----------|
+| `--duration` | Duration in seconds | 30 | 10, 60, 300 |
+| `--sample-rate` | Sample rate in Hz | 44100 | 22050, 48000, 96000 |
+| `--frequency` | Sine wave frequency in Hz | 440 | 220, 880, 1000 |
+| `--bitrate` | Audio bitrate | 128k | 96k, 192k, 320k |
+| `--format` | Output format | mp3 | mp3, wav, aac, flac |
+| `--codec` | Audio codec | libmp3lame | pcm_s16le, aac, flac |
+| `--output` | Output filename | output.mp3 | my-audio.wav |
+
+### Audio Options
+
 | Option | Description | Default | Examples |
 |--------|-------------|---------|----------|
 | `--duration` | Duration in seconds | 30 | 10, 60, 300 |
@@ -159,24 +178,27 @@ Create test audio files with sine wave tones:
 
 ### Prerequisites
 - [Zig 0.15+](https://ziglang.org/download/)
-- FFmpeg installed on your system
+- Internet connection (for automatic FFmpeg download)
 
 ### Build Commands
 ```bash
 # Clone the repository
 git clone https://github.com/DimazzzZ/media-gen.git
 cd media-gen
 
-# Build for your platform
+# Build for your platform (FFmpeg downloaded automatically)
 zig build
 
 # Run tests
 zig build test
+zig build test-integration
 
 # Build for all platforms
 ./build-all.sh
 ```
 
+**Note:** FFmpeg binaries are downloaded automatically during the first build. No manual installation required!
+
 ### Cross-compilation
 ```bash
 # Windows