ffmpeg_core 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afead7a6fce7f95748207153b521b35a223f2efd7add35664e12ba3e27f86b23
-  data.tar.gz: 3052072fb4a3541518cc5d12bf333b58b77a77f2b3b4deec44d51b89ddbac678
+  metadata.gz: bb9323f5aae7b7f162d4b43f219f14506af5fa012e033451a2021e92bec14128
+  data.tar.gz: 7164b154e6b542e2179f430418cd3b42fb68cc48a5dff62a679b13eb135b3de7
 SHA512:
-  metadata.gz: d725d25a1d211186ede000ac81d58f20c57fc8f46ba5a3897b006a8e92e128b37f5f9cfb9295633bfe0a7dd878a0f99793329c388c1c2a920bc585256b4740db
-  data.tar.gz: 5e683ec8fb39dc1e669abaeaa8e3f7254de8f92ef4593ed6869ba7a5a4c02dab2d6ee8005243dbf31e24be27b11a689c89de736c0eca69e93be38b7d9e5fc531
+  metadata.gz: f97a26864b497d77ae8b862daa0b45154f038cbc94dfbf56703a4879ccbac680b294acdacf35d20538fb736d046dbd85c55514bc6d7e7a8c0d6c41030878f40d
+  data.tar.gz: 5235e82f757aa787cb76dbed3af50a5bd4eff074c9476918f90d9d8c8187f658979a6ca0b773d762569f631394326c27c45d45d265f1a0e13f9eb2890a1bba26

data/CHANGELOG.md

@@ -5,6 +5,44 @@ 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).
 
+## [0.5.0] - 2026-04-13
+
+### Added
+
+- **Probe — extended metadata:**
+  - `subtitle_streams` — array of subtitle streams
+  - `chapters` — file chapters (requires ffprobe `-show_chapters`)
+  - `format_name` — container format name (mp4, mkv, avi…)
+  - `tags` — file-level tags (title, artist, etc.)
+  - `audio_sample_rate` — sample rate of the first audio stream
+  - `audio_channels` — channel count
+  - `audio_channel_layout` — channel layout string (stereo, 5.1…)
+  - `pixel_format` — video pixel format (yuv420p, etc.)
+  - `has_video?` / `has_audio?` — stream presence predicates
+  - `exif` — EXIF tags merged from format and video stream tags (FFmpeg 8.1)
+- **Movie — new operations:**
+  - `cut(output, start_time:, duration:)` / `cut(output, start_time:, end_time:)` — lossless trim via `-c copy`
+  - `extract_audio(output, codec:)` — extract audio track to file
+  - `screenshots(output_dir, count:)` — extract multiple screenshots at equal intervals
+- **Hardware acceleration — AV1 and D3D12 support (FFmpeg 8.0/8.1):**
+  - AV1 via `:nvenc` (`av1_nvenc`), `:vaapi` (`av1_vaapi`), `:vulkan` (`av1_vulkan`)
+  - D3D12 via `:d3d12` (`h264_d3d12va`) for Windows
+
+### Changed
+
+- `Probe#probe!` now passes `-show_chapters` to ffprobe
+
+## [0.4.1] - 2026-04-09
+
+### Fixed
+
+- Binary detection on Windows: `where` fallback now correctly resolves ffmpeg/ffprobe when not on PATH
+
+### Changed
+
+- Simplified binary detection: removed redundant Ruby PATH scan, extracted lookup steps into focused private methods
+- Expanded `Configuration` spec: ENV override, `BinaryNotFoundError`, known-path fallback, `reset_configuration!`
+
 ## [0.4.0] - 2026-01-26
 
 ### Added

data/lib/ffmpeg_core/audio_extractor.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module FFmpegCore
+  # Extract audio track from video files
+  class AudioExtractor
+    attr_reader :input_path, :output_path, :options
+
+    def initialize(input_path, output_path, options = {})
+      @input_path = input_path.to_s
+      @output_path = output_path.to_s
+      @options = options
+    end
+
+    def run
+      validate_input!
+      ensure_output_directory!
+
+      command = build_command
+      execute_command(command)
+    end
+
+    private
+
+    def validate_input!
+      return if %r{^(https?|rtmp|rtsp)://}.match?(input_path)
+
+      raise InvalidInputError, "Input file does not exist: #{input_path}" unless File.exist?(input_path)
+    end
+
+    def ensure_output_directory!
+      output_dir = File.dirname(output_path)
+      FileUtils.mkdir_p(output_dir) unless Dir.exist?(output_dir)
+    end
+
+    def build_command
+      cmd = [FFmpegCore.configuration.ffmpeg_binary, "-i", input_path]
+      cmd += ["-vn"]
+      cmd += ["-c:a", options[:codec]] if options[:codec]
+      cmd += ["-y", output_path]
+      cmd
+    end
+
+    def execute_command(command)
+      _stdout, stderr, status = Open3.capture3(*command)
+
+      unless status.success?
+        raise TranscodingError.new(
+          "FFmpeg audio extraction failed",
+          command: command.join(" "),
+          exit_status: status.exitstatus,
+          stdout: "",
+          stderr: stderr
+        )
+      end
+
+      output_path
+    end
+  end
+end

data/lib/ffmpeg_core/clipper.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module FFmpegCore
+  # Cut/trim video segments
+  class Clipper
+    attr_reader :input_path, :output_path, :options
+
+    def initialize(input_path, output_path, options = {})
+      @input_path = input_path.to_s
+      @output_path = output_path.to_s
+      @options = options
+    end
+
+    def run
+      validate_input!
+      ensure_output_directory!
+
+      command = build_command
+      execute_command(command)
+    end
+
+    private
+
+    def validate_input!
+      return if %r{^(https?|rtmp|rtsp)://}.match?(input_path)
+
+      raise InvalidInputError, "Input file does not exist: #{input_path}" unless File.exist?(input_path)
+    end
+
+    def ensure_output_directory!
+      output_dir = File.dirname(output_path)
+      FileUtils.mkdir_p(output_dir) unless Dir.exist?(output_dir)
+    end
+
+    def build_command
+      cmd = [FFmpegCore.configuration.ffmpeg_binary]
+
+      cmd += ["-ss", options[:start_time].to_s] if options[:start_time]
+      cmd += ["-i", input_path]
+
+      if options[:duration]
+        cmd += ["-t", options[:duration].to_s]
+      elsif options[:end_time]
+        cmd += ["-to", options[:end_time].to_s]
+      end
+
+      cmd += ["-c", "copy", "-y", output_path]
+      cmd
+    end
+
+    def execute_command(command)
+      _stdout, stderr, status = Open3.capture3(*command)
+
+      unless status.success?
+        raise TranscodingError.new(
+          "FFmpeg cut failed",
+          command: command.join(" "),
+          exit_status: status.exitstatus,
+          stdout: "",
+          stderr: stderr
+        )
+      end
+
+      output_path
+    end
+  end
+end

data/lib/ffmpeg_core/configuration.rb

@@ -40,23 +40,54 @@ module FFmpegCore
     end
 
     def detect_binary(name)
-      # Check common locations
-      paths = ENV["PATH"].split(File::PATH_SEPARATOR)
-      paths.each do |path|
-        binary = File.join(path, name)
-        return binary if File.executable?(binary)
-      end
+      binary_from_env(name) ||
+        binary_from_system_lookup(name) ||
+        binary_from_known_paths(name) ||
+        raise(BinaryNotFoundError, <<~MSG)
+          #{name} not found.
+          Install FFmpeg and ensure it's in PATH.
+          macOS: brew install ffmpeg
+          Linux: apt install ffmpeg / yum install ffmpeg
+          Windows: choco install ffmpeg or scoop install ffmpeg
+        MSG
+    end
 
-      # Homebrew locations (macOS)
-      homebrew_paths = [
-        "/opt/homebrew/bin/#{name}", # Apple Silicon
-        "/usr/local/bin/#{name}" # Intel
-      ]
-      homebrew_paths.each do |path|
-        return path if File.executable?(path)
-      end
+    # Checks FFMPEGCORE_<NAME> env variable for an explicit binary override.
+    def binary_from_env(name)
+      path = ENV["FFMPEGCORE_#{name.upcase}"]
+      path if path && File.executable?(path)
+    end
+
+    # Uses the OS-native `which` (Unix) or `where` (Windows) command.
+    def binary_from_system_lookup(name)
+      cmd = Gem.win_platform? ? "where #{name}" : "which #{name}"
+      stdout, status = Open3.capture2(cmd)
+      return unless status.success?
 
-      raise BinaryNotFoundError, "#{name} binary not found. Please install FFmpeg: brew install ffmpeg"
+      path = stdout.lines.first&.strip
+      path if path && File.executable?(path)
+    end
+
+    # Falls back to a list of well-known installation paths.
+    def binary_from_known_paths(name)
+      known_paths(name).find { |p| File.executable?(p) }
+    end
+
+    def known_paths(name)
+      if Gem.win_platform?
+        [
+          "C:/ffmpeg/bin/#{name}.exe",
+          "C:/ProgramData/chocolatey/bin/#{name}.exe",
+          "#{ENV["USERPROFILE"]}/scoop/apps/ffmpeg/current/bin/#{name}.exe"
+        ]
+      else
+        [
+          "/opt/homebrew/bin/#{name}",  # macOS ARM
+          "/usr/local/bin/#{name}",     # macOS Intel / Linux
+          "/usr/bin/#{name}",
+          "/snap/bin/#{name}"
+        ]
+      end
     end
   end
 

data/lib/ffmpeg_core/movie.rb

@@ -52,5 +52,47 @@ module FFmpegCore
       screenshotter = Screenshot.new(path, output_path, options)
       screenshotter.extract
     end
+
+    # Cut/trim a segment from video
+    #
+    # @param output_path [String] Path to output file
+    # @param options [Hash] Cut options
+    # @option options [Integer, Float] :start_time Start time in seconds
+    # @option options [Integer, Float] :duration Duration in seconds
+    # @option options [Integer, Float] :end_time End time in seconds (alternative to :duration)
+    # @return [String] Path to output file
+    def cut(output_path, options = {})
+      clipper = Clipper.new(path, output_path, options)
+      clipper.run
+    end
+
+    # Extract audio track from video
+    #
+    # @param output_path [String] Path to output audio file
+    # @param options [Hash] Extraction options
+    # @option options [String] :codec Audio codec (e.g., "libmp3lame", "aac")
+    # @return [String] Path to output file
+    def extract_audio(output_path, options = {})
+      extractor = AudioExtractor.new(path, output_path, options)
+      extractor.run
+    end
+
+    # Extract multiple screenshots at equal intervals
+    #
+    # @param output_dir [String] Directory to save screenshots
+    # @param count [Integer] Number of screenshots to extract (default: 5)
+    # @return [Array<String>] Paths to screenshot files
+    def screenshots(output_dir, count: 5)
+      FileUtils.mkdir_p(output_dir)
+      total = duration || 0
+      interval = total / (count + 1).to_f
+
+      (1..count).map do |i|
+        seek = (interval * i).round(2)
+        output_path = File.join(output_dir, format("screenshot_%03d.jpg", i))
+        Screenshot.new(path, output_path, seek_time: seek).extract
+        output_path
+      end
+    end
   end
 end

data/lib/ffmpeg_core/probe.rb

@@ -111,6 +111,53 @@ module FFmpegCore
       streams.select { |s| s["codec_type"] == "audio" }
     end
 
+    def subtitle_streams
+      streams.select { |s| s["codec_type"] == "subtitle" }
+    end
+
+    def chapters
+      @metadata.fetch("chapters", [])
+    end
+
+    def format_name
+      @metadata.dig("format", "format_name")
+    end
+
+    def tags
+      @metadata.dig("format", "tags") || {}
+    end
+
+    def audio_sample_rate
+      audio_stream&.dig("sample_rate")&.to_i
+    end
+
+    def audio_channels
+      audio_stream&.dig("channels")
+    end
+
+    def audio_channel_layout
+      audio_stream&.dig("channel_layout")
+    end
+
+    def pixel_format
+      video_stream&.dig("pix_fmt")
+    end
+
+    def has_video?
+      !video_stream.nil?
+    end
+
+    def has_audio?
+      !audio_stream.nil?
+    end
+
+    # EXIF metadata: merges format-level and video stream tags (FFmpeg 8.1+)
+    def exif
+      format_tags = @metadata.dig("format", "tags") || {}
+      stream_tags = video_stream&.dig("tags") || {}
+      format_tags.merge(stream_tags)
+    end
+
     def valid?
       !video_stream.nil?
     end
@@ -135,6 +182,7 @@ module FFmpegCore
         "-print_format", "json",
         "-show_format",
         "-show_streams",
+        "-show_chapters",
         path
       ]
 

data/lib/ffmpeg_core/transcoder.rb

@@ -189,25 +189,35 @@ module FFmpegCore
         :h264
       when /x265|hevc/i
         :hevc
+      when /av1|libaom/i
+        :av1
       end
     end
 
     HW_FLAGS = {
       vaapi: ["-hwaccel", "vaapi", "-hwaccel_output_format", "vaapi"],
       qsv: ["-hwaccel", "qsv"],
-      nvenc: ["-hwaccel", "cuda", "-hwaccel_output_format", "cuda"]
+      nvenc: ["-hwaccel", "cuda", "-hwaccel_output_format", "cuda"],
+      vulkan: ["-hwaccel", "vulkan"],
+      d3d12: ["-hwaccel", "d3d12va"]
     }.freeze
 
     HW_ENCODERS = {
       h264: {
         nvenc: "h264_nvenc",
         vaapi: "h264_vaapi",
-        qsv: "h264_qsv"
+        qsv: "h264_qsv",
+        d3d12: "h264_d3d12va"
       },
       hevc: {
         nvenc: "hevc_nvenc",
         vaapi: "hevc_vaapi",
         qsv: "hevc_qsv"
+      },
+      av1: {
+        nvenc: "av1_nvenc",
+        vaapi: "av1_vaapi",
+        vulkan: "av1_vulkan"
       }
     }.freeze
   end

data/lib/ffmpeg_core/version.rb

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

data/lib/ffmpeg_core.rb

@@ -24,4 +24,6 @@ require_relative "ffmpeg_core/configuration"
 require_relative "ffmpeg_core/probe"
 require_relative "ffmpeg_core/transcoder"
 require_relative "ffmpeg_core/screenshot"
+require_relative "ffmpeg_core/clipper"
+require_relative "ffmpeg_core/audio_extractor"
 require_relative "ffmpeg_core/movie"

metadata

@@ -1,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: ffmpeg_core
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Alexey Poimtsev
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A clean, well-tested FFmpeg wrapper with modern Ruby conventions, proper
   error handling, and zero dependencies.
 email:
@@ -23,6 +37,8 @@ files:
 - Rakefile
 - lefthook.yml
 - lib/ffmpeg_core.rb
+- lib/ffmpeg_core/audio_extractor.rb
+- lib/ffmpeg_core/clipper.rb
 - lib/ffmpeg_core/configuration.rb
 - lib/ffmpeg_core/errors.rb
 - lib/ffmpeg_core/movie.rb
@@ -53,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.4
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Modern Ruby wrapper for FFmpeg
 test_files: []