ffmpeg_core 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8605d887cd2bf7b03dc1cc1dc06f004b797a694467f5376c361e432fdc648e50
-  data.tar.gz: 6d3308730d6ca3eceb6de5aa90053c39bcbcb0438a0faf4bc4a2a5b035ba7c66
+  metadata.gz: 4efe5152c9dd01b8ebb2d34c9f6d6877371d017845242297f57f65044c968648
+  data.tar.gz: a1b09735ebc0acc9c21b252e3fa32b4168e0c5694eab8d72fa299e7c8c88dc9f
 SHA512:
-  metadata.gz: 4bd3cc9dcdbae4104798cc0c6bd5ceef7f151f8a07aad0c33c6793f5c37928762f0c81baf0ce9ff943a4af17594ae4c9675db92e695ca73fd23ae0f2d93cfc43
-  data.tar.gz: 60e15449132609d881dfe136d7fe7d8e6777089a396578d79cbd0034bcd142e032c94a818ffc78d819fb724c49b7870451cabe2644e0d573e820afaf9d8815ad
+  metadata.gz: f3c4ace64795f63226082eb3eeb6e395c0f35976b86de25a3a8ed7c46973ce7d2b234de2485a6e3cd083060653da3f2d6a8f8c3a254260a15d5e472462097a21
+  data.tar.gz: 7b390fe28da3e17efe7a4523001aa41a0aa70685fc8e5d5951faf55e5d2feabe96e3aa5e48f94c0f3a0c70016a23b49c7b063739ae953bde41bba92b524e36b7

data/CHANGELOG.md

@@ -5,7 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.2.0] - 2026-01-15
+
+### Added
+
+- Real-time progress reporting in `Movie#transcode` via block yielding (0.0 to 1.0)
+- Support for video and audio filters (`video_filter`, `audio_filter`)
+- Support for quality settings (`preset`, `crf`)
+- Enhanced metadata in `Probe`: added `rotation`, `aspect_ratio`, and `audio_streams`
+- Comprehensive modular test suite for `Transcoder` and `Screenshot`
+
+### Changed
+
+- `Transcoder` now uses `Open3.popen3` for non-blocking execution and progress parsing
+- Improved RSpec testing style (using `have_received` spies)
+
+## [0.1.1] - 2026-01-14
+
+### Fixed
+
+- `ProbeError` now inherits from `ExecutionError` to properly accept keyword arguments (Ruby 4.0 compatibility)
 
 ## [0.1.0] - 2026-01-14
 

data/README.md

@@ -2,10 +2,15 @@
 
 Modern Ruby wrapper for FFmpeg with clean API and proper error handling.
 
+[![Gem Version](https://badge.fury.io/rb/ffmpeg_core.svg)](https://badge.fury.io/rb/ffmpeg_core)
+[![Build Status](https://github.com/alec-c4/ffmpeg_core/actions/workflows/main.yml/badge.svg)](https://github.com/alec-c4/ffmpeg_core/actions)
+
 ## Features
 
 - Modern Ruby 3+ conventions
 - Zero runtime dependencies
+- **Real-time progress reporting**
+- **Support for video/audio filters and quality presets**
 - Proper error handling with detailed context
 - Thread-safe configuration
 - Simple, intuitive API
@@ -46,6 +51,8 @@ movie.video_codec   # => "h264"
 movie.audio_codec   # => "aac"
 movie.frame_rate    # => 29.97
 movie.bitrate       # => 5000 (kb/s)
+movie.rotation      # => 90 (degrees)
+movie.aspect_ratio  # => "16:9"
 movie.valid?        # => true
 ```
 
@@ -54,23 +61,20 @@ movie.valid?        # => true
 ```ruby
 movie = FFmpegCore::Movie.new("input.mp4")
 
-# Basic transcoding
-movie.transcode("output.mp4", video_codec: "libx264")
+# Basic transcoding with progress
+movie.transcode("output.mp4", video_codec: "libx264") do |progress|
+  puts "Progress: #{(progress * 100).round(2)}%"
+end
 
-# With options
+# Advanced options (Filters & Quality)
 movie.transcode("output.mp4", {
   video_codec: "libx264",
   audio_codec: "aac",
   video_bitrate: "1000k",
-  audio_bitrate: "128k",
   resolution: "1280x720",
-  frame_rate: 30
-})
-
-# Custom FFmpeg flags
-movie.transcode("output.mp4", {
-  video_codec: "libx264",
-  custom: ["-preset", "fast", "-crf", "23"]
+  video_filter: "scale=1280:-1,transpose=1", # Resize and rotate
+  preset: "slow",      # ffmpeg preset (ultrafast, fast, medium, slow, etc.)
+  crf: 23              # Constant Rate Factor (0-51)
 })
 ```
 
@@ -125,14 +129,14 @@ end
 
 ### Error Classes
 
-| Error | Description |
-|-------|-------------|
-| `FFmpegCore::Error` | Base error class |
-| `FFmpegCore::BinaryNotFoundError` | FFmpeg/FFprobe not found |
-| `FFmpegCore::InvalidInputError` | Input file doesn't exist or unreadable |
-| `FFmpegCore::ProbeError` | Failed to extract metadata |
-| `FFmpegCore::TranscodingError` | FFmpeg transcoding failed |
-| `FFmpegCore::ScreenshotError` | Screenshot extraction failed |
+| Error                             | Description                            |
+| --------------------------------- | -------------------------------------- |
+| `FFmpegCore::Error`               | Base error class                       |
+| `FFmpegCore::BinaryNotFoundError` | FFmpeg/FFprobe not found               |
+| `FFmpegCore::InvalidInputError`   | Input file doesn't exist or unreadable |
+| `FFmpegCore::ProbeError`          | Failed to extract metadata             |
+| `FFmpegCore::TranscodingError`    | FFmpeg transcoding failed              |
+| `FFmpegCore::ScreenshotError`     | Screenshot extraction failed           |
 
 ## Development
 
@@ -149,4 +153,4 @@ bundle exec rubocop
 
 ## License
 
-MIT License. See [LICENSE.txt](LICENSE.txt) for details.
+MIT License. See [LICENSE.txt](LICENSE.txt) for details.

data/lib/ffmpeg_core/errors.rb

@@ -27,7 +27,7 @@ module FFmpegCore
   class OutputError < Error; end
 
   # Raised when probe fails to extract metadata
-  class ProbeError < Error; end
+  class ProbeError < ExecutionError; end
 
   # Raised when transcoding fails
   class TranscodingError < ExecutionError; end

data/lib/ffmpeg_core/movie.rb

@@ -27,10 +27,14 @@ module FFmpegCore
     # @option options [String] :resolution Resolution (e.g., "1280x720")
     # @option options [Integer, Float] :frame_rate Frame rate (e.g., 30)
     # @option options [Array<String>] :custom Custom FFmpeg flags
+    # @yield [Float] Progress ratio (0.0 to 1.0)
     # @return [String] Path to transcoded file
-    def transcode(output_path, options = {})
+    def transcode(output_path, options = {}, &block)
+      # Inject duration for progress calculation if known
+      options[:duration] ||= duration
+
       transcoder = Transcoder.new(path, output_path, options)
-      transcoder.run
+      transcoder.run(&block)
     end
 
     # Extract screenshot from video

data/lib/ffmpeg_core/probe.rb

@@ -68,9 +68,29 @@ module FFmpegCore
 
     def resolution
       return nil unless width && height
+
       "#{width}x#{height}"
     end
 
+    def rotation
+      return nil unless video_stream
+
+      # Try to find rotation in tags (common in MP4/MOV)
+      tags = video_stream.fetch("tags", {})
+      return tags["rotate"].to_i if tags["rotate"]
+
+      # Default to 0 if not found
+      0
+    end
+
+    def aspect_ratio
+      video_stream&.dig("display_aspect_ratio")
+    end
+
+    def audio_streams
+      streams.select { |s| s["codec_type"] == "audio" }
+    end
+
     def valid?
       !video_stream.nil?
     end

data/lib/ffmpeg_core/screenshot.rb

@@ -36,9 +36,7 @@ module FFmpegCore
       cmd = [FFmpegCore.configuration.ffmpeg_binary]
 
       # Seek to timestamp (before input for faster processing)
-      if options[:seek_time]
-        cmd += ["-ss", options[:seek_time].to_s]
-      end
+      cmd += ["-ss", options[:seek_time].to_s] if options[:seek_time]
 
       # Input file
       cmd += ["-i", input_path]
@@ -47,9 +45,7 @@ module FFmpegCore
       cmd += ["-vframes", "1"]
 
       # Resolution
-      if options[:resolution]
-        cmd += ["-s", options[:resolution]]
-      end
+      cmd += ["-s", options[:resolution]] if options[:resolution]
 
       # Quality (2-31, lower is better, default: 2)
       quality = options[:quality] || 2

data/lib/ffmpeg_core/transcoder.rb

@@ -14,12 +14,12 @@ module FFmpegCore
       @options = options
     end
 
-    def run
+    def run(&block)
       validate_input!
       ensure_output_directory!
 
       command = build_command
-      execute_command(command)
+      execute_command(command, &block)
     end
 
     private
@@ -40,39 +40,37 @@ module FFmpegCore
       cmd += ["-i", input_path]
 
       # Video codec
-      if options[:video_codec]
-        cmd += ["-c:v", options[:video_codec]]
-      end
+      cmd += ["-c:v", options[:video_codec]] if options[:video_codec]
 
       # Audio codec
-      if options[:audio_codec]
-        cmd += ["-c:a", options[:audio_codec]]
-      end
+      cmd += ["-c:a", options[:audio_codec]] if options[:audio_codec]
 
       # Video bitrate
-      if options[:video_bitrate]
-        cmd += ["-b:v", normalize_bitrate(options[:video_bitrate])]
-      end
+      cmd += ["-b:v", normalize_bitrate(options[:video_bitrate])] if options[:video_bitrate]
 
       # Audio bitrate
-      if options[:audio_bitrate]
-        cmd += ["-b:a", normalize_bitrate(options[:audio_bitrate])]
-      end
+      cmd += ["-b:a", normalize_bitrate(options[:audio_bitrate])] if options[:audio_bitrate]
 
       # Resolution
-      if options[:resolution]
-        cmd += ["-s", options[:resolution]]
-      end
+      cmd += ["-s", options[:resolution]] if options[:resolution]
 
       # Frame rate
-      if options[:frame_rate]
-        cmd += ["-r", options[:frame_rate].to_s]
-      end
+      cmd += ["-r", options[:frame_rate].to_s] if options[:frame_rate]
+
+      # Video filter
+      cmd += ["-vf", options[:video_filter]] if options[:video_filter]
+
+      # Audio filter
+      cmd += ["-af", options[:audio_filter]] if options[:audio_filter]
+
+      # Quality preset
+      cmd += ["-preset", options[:preset]] if options[:preset]
+
+      # Constant Rate Factor (CRF)
+      cmd += ["-crf", options[:crf].to_s] if options[:crf]
 
       # Custom options (array of strings)
-      if options[:custom]
-        cmd += options[:custom]
-      end
+      cmd += options[:custom] if options[:custom]
 
       # Overwrite output file
       cmd += ["-y"]
@@ -89,23 +87,55 @@ module FFmpegCore
       # 1000 -> "1000k"
       # "1M" -> "1M"
       return bitrate.to_s if bitrate.to_s.match?(/\d+[kKmM]/)
+
       "#{bitrate}k"
     end
 
-    def execute_command(command)
-      stdout, stderr, status = Open3.capture3(*command)
-
-      unless status.success?
-        raise TranscodingError.new(
-          "FFmpeg transcoding failed",
-          command: command.join(" "),
-          exit_status: status.exitstatus,
-          stdout: stdout,
-          stderr: stderr
-        )
+    def execute_command(command, &block)
+      # Keep track of last few lines for error reporting
+      error_log = []
+
+      Open3.popen3(*command) do |_stdin, _stdout, stderr, wait_thr|
+        # FFmpeg uses \r to update progress line, so we split by \r
+        # We also handle \n just in case
+        stderr.each_line("\r") do |line|
+          clean_line = line.strip
+          next if clean_line.empty?
+
+          error_log << clean_line
+          error_log.shift if error_log.size > 20 # Keep last 20 lines
+
+          parse_progress(clean_line, &block) if block_given?
+        end
+
+        status = wait_thr.value
+
+        unless status.success?
+          raise TranscodingError.new(
+            "FFmpeg transcoding failed",
+            command: command.join(" "),
+            exit_status: status.exitstatus,
+            stdout: "",
+            stderr: error_log.join("\n")
+          )
+        end
       end
 
       output_path
     end
+
+    def parse_progress(line)
+      # Match time=HH:MM:SS.ms
+      if line =~ /time=(\d{2}):(\d{2}):(\d{2}\.\d{2})/
+        hours, minutes, seconds = $1.to_i, $2.to_i, $3.to_f
+        current_time = (hours * 3600) + (minutes * 60) + seconds
+
+        duration = options[:duration]
+        if duration && duration.to_f > 0
+          progress = [current_time / duration.to_f, 1.0].min
+          yield(progress)
+        end
+      end
+    end
   end
 end

data/lib/ffmpeg_core/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FFmpegCore
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/sig/ffmpeg_core.rbs

@@ -1,4 +1,4 @@
-module FfmpegCore
+module FFmpegCore
   VERSION: String
   # See the writing guide of rbs: https://github.com/ruby/rbs#guides
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ffmpeg_core
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Alexey Poimtsev