r7streamio_ffmpeg 2.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZjE2MjZlNzE1MTJiMTFmMDhlOGI3NDUwZWY4MjA5NTI2YWM3ZjE4Nw==
+  data.tar.gz: !binary |-
+    Njk0NDQ2YzZjZTFjYjBlOTJkZTU2ODc5MWZiNGRhYTg1ZjM0ZjgwYw==
+SHA512:
+  metadata.gz: !binary |-
+    MzIxNTBhMDA2M2YyZjg5ZmNmZTk4ZWFmYjllNjA1NGIwMjcwYTUzMDdjNDU5
+    YTk0NjAwZDA2MzkxOTM1YjBhNmQ5OGVlYzliOWJjNWQxMDhjZDM4ZjA5MWZm
+    ZTBiZDBlMGEyNDBjMjRmNDIxOTU5MmJmOTYyOTg1NTU4NzJhNDU=
+  data.tar.gz: !binary |-
+    N2Q5NGJjOWQ1MDJjZmI1OTVmZDExMzAwZTU1NmUwYTg4MzY5OTUwNWQ1Zjdl
+    MTkzY2U5ZTZkNmViNzk2OTkyMGVmNDQxM2ZjMDIxOWViNTE0N2JjYmVmZjFm
+    NWNhZjEzMTY2OGQwNTQxZWIwMzFkNGNjZmM0NDM1ZTAxM2IzMGI=

data/CHANGELOG

@@ -0,0 +1,210 @@
+== Master
+
+New:
+* Support watermarking (thanks smoothdvd)
+
+Improvements:
+* Allow parenthesis in colorspace (thanks walterdavis for initial code and rociiu for finding a bug with it)
+
+== 1.0.0 2013-07-08
+
+New:
+* Bumped target ffmpeg version to 1.2.1
+
+Improvements:
+* Simpler implementation for timeouts.
+  Should be far less cpu and memory dependent (don't spawn a thread for every line of output)
+  Timeout spec now passes in Rubinius (using 1.9 mode)
+* Give helpful error message for windows users lacking the win32-process gem (thanks casoetan)
+* Add Movie#container (thanks vitalis)
+* Support vprofile and preset encoding options (thanks vitalis)
+
+Changes:
+* Default timeout lowered to 30 seconds
+
+Bugs:
+* Avoid crash if asking for frame_rate of a video without video stream (thanks squidarth)
+* Fix crash when doing audio transcoding on ffmpeg >= 1.0.1 (thanks vitalis)
+
+Deprecations:
+* Removed support for Ruby 1.8
+* Removed support for ffmpeg 0.7
+
+Refactorings:
+* Quite a few, see commit history for details.
+
+== 0.9.0 2012-07-24
+
+New:
+* Bumped target ffmpeg version to 0.11.1
+* Add hung process detection with configurable timeout (thanks stakach)
+* Raise FFMPEG::Error instead of generic RuntimeError on failed transcodings
+* Movie#screenshot for more intuitive screenshotting (README has details)
+* Movie#creation_time and Movie#rotation attributes when metadata is available (thanks Innonate)
+
+Bugs:
+* Fixed too many open files bug (thanks to akicho8)
+* Fixed missing path escaping (thanks to mikesager)
+* Fixed README typo (thanks to Linutux)
+* Files outputing "could not find codec parameters" are now recognized as invalid
+
+Deprecations:
+* Removed Movie#uncertain_duration?
+* Removed all the deprecated crop options (use :custom => '-vf crop=x:x:x:x' if you need it)
+
+Refactorings:
+* Removed the deprecated duration validation code
+* Polish on the transcoder class
+* Polish on the spec suite
+
+== 0.8.5 2011-03-05
+
+* If a clip has a DAR that doesn't make sense fall back to calculating aspect ratio from dimensions
+* Allow filenames with single quote characters (thanks to youpy)
+
+== 0.8.4 2011-11-30
+
+* Duration now one decimal more accurate (thanks to Russel Brooks)
+* Added encoding option seek_time (thanks to Misty De Meo)
+
+== 0.8.3 2011-09-01
+
+* Parameters now come in the order of codecs, presets, others so that we can override the presets
+* Added encoding option keyframe_interval to set number of frames between i-frames (aka GOP size)
+* Streamio (sponsor of this project) have launched new awesome pricing @ http://streamio.com
+
+== 0.8.2 2011-08-19
+
+* Path to ffmpeg binary can now be specified (thanks jonathandean)
+* If ffmpeg output contains "is not supported" the Movie will be considered invalid
+
+== 0.8.1 2011-07-28
+
+* Fix progress yielding with ffmpeg 0.8
+* Updated specs to pass with ffmpeg 0.8
+
+== 0.8.0 2011-05-26
+
+* Duration is now ALWAYS considered uncertain (we've noticed that ffmpeg is not always correct)
+* This means that the duration check will normally never run (unless you manually hack @uncertain_duration to false)
+* Movie#audio_channels now returns nil if there is no audio stream (instead of crashing)
+* Development: Use Bundler
+* Development: Update RSpec to 2.6
+
+== 0.7.8 2011-04-04
+
+* Fixed number of audio channels on files with 5.1 audio
+
+== 0.7.7 2011-02-01
+
+* Movies with starttime are now considered as having uncertain duration as its behavior is not consistent across formats
+* Upgrade development environment to RSpec 2.4
+
+== 0.7.6 2011-01-14
+
+* Another ruby 1.9 encoding fix
+
+== 0.7.5 2011-01-14
+
+* Fixed some ruby 1.9 issues
+* Added Movie#video_bitrate and Movie#audio_bitrate (thanks to mbj)
+
+== 0.7.4 2010-12-07
+
+* Fixed broken duration on movies with start times over 0 by reducing duration with start-time
+
+== 0.7.3 2010-08-26
+
+* Replaced Jewler with simple dynamic gemspec file
+* Spec files now not in published gem to make it a lot smaller in size
+* Full output from ffmpeg command in error raised during transcoding
+
+== 0.7.2 2010-08-11
+
+* Added encoding option duration
+* Avoid crashing when ffmpeg can't find resolution of a movie
+
+== 0.7.1 2010-07-08
+
+* Make sure preset parameters are always put last to avoid them ending up before any codec assignments
+* Testing against a fresh ffmpeg build (r24069)
+
+== 0.7.0 2010-07-07
+
+* Support for ffpresets through video_preset, audio_preset and file_preset encoding options
+* Added encoding option video_bitrate_tolerance
+
+== 0.6.8.1 2010-07-06
+
+* Bugfix - aspect ratio was not calculated properly on movies with no DAR
+
+== 0.6.8 2010-07-06
+
+* Don't use encoding options with nil values
+* Added encoding options video_max_bitrate, video_min_bitrate and buffer_size for constant bitrate encoding
+
+== 0.6.7 2010-06-10
+
+* Bugfix - aspect ratio preserver could suggest non even resolutions in certain circumstances
+
+== 0.6.6 2010-06-10
+
+* Transcodings to .jpg and .png will now work as they will skip duration validation
+
+== 0.6.5 2010-05-19
+
+* Movie#size method to get file size.
+
+== 0.6.4 2010-05-12
+
+* Ruby 1.9 compatibility fix for EncodingOptions (thanks michalf!)
+
+== 0.6.3 2010-05-05
+
+* Use DAR to calculate aspect ratio if available
+
+== 0.6.2 2010-05-05
+
+* Added Movie#uncertain_duration? which is true if ffmpeg is guessing duration from bitrate
+* Skipping the transcoders duration validation if original file has uncertain duration
+* Made sure aspect ratio preservation always rounds new size to an even number to avoid "not divisible by 2" errors
+* Changed Movie#valid? logic to accept any movie with either a readable audio or video stream
+
+== 0.6.0 2010-05-04
+
+* Cropping options now handled by EncodingOptions (croptop, cropbottom, cropleft and cropright)
+* Aspect ratio parameter calculated and added by default
+* Added transcoder options to preserve original aspect ratio on width or height
+
+== 0.5.0 2010-04-28
+
+* Added logging capabilities
+
+== 0.4.3 2010-04-06
+
+* Correctly identify invalid movies on latest ffmpeg build (r22811)
+
+== 0.4.2 2010-04-06
+
+* Escape the path to handle spaces in filenames and avoid CLI injection attacks (thanks J. Weir!)
+
+== 0.4.1 2010-02-10
+
+* Forgot to change the transcoding shortcut from Movie
+
+== 0.4.0 2010-02-10
+
+* Transcoding API changed to make use of more humanly readable options (see README for examples)
+* Fixed frame rate parsing for integer frame rates
+
+== 0.3.0 2010-02-07
+
+* Simple transcoding
+
+== 0.2.0 2010-02-06
+
+* Some more metadata parsing
+
+== 0.1.0 2010-02-05
+
+* Some basic parsing of metadata added

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Streamio AB
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,206 @@
+Streamio FFMPEG
+===============
+
+Simple yet powerful wrapper around the ffmpeg command for reading metadata and transcoding movies.
+
+All work on this project is sponsored by the online video platform [Streamio](http://streamio.com).
+
+[![Streamio](http://d253c4ja9jigvu.cloudfront.net/assets/small-logo.png)](http://streamio.com)
+
+Installation
+------------
+
+    (sudo) gem install streamio-ffmpeg
+
+Compatibility
+-------------
+
+### Ruby
+
+Only guaranteed to work with MRI Ruby 1.9.3 or later.
+Should work with rubinius head in 1.9 mode.
+Will not work in jruby until they fix: http://goo.gl/Z4UcX (should work in the upcoming 1.7.5)
+
+### ffmpeg
+
+The current gem is tested against ffmpeg 2.2.1. So no guarantees with earlier (or much later) versions. Output and input standards have inconveniently changed rather a lot between versions of ffmpeg. My goal is to keep this library in sync with new versions of ffmpeg as they come along.
+
+Usage
+-----
+
+### Require the gem
+
+``` ruby
+require 'rubygems'
+require 'streamio-ffmpeg'
+```
+
+### Reading Metadata
+
+``` ruby
+movie = FFMPEG::Movie.new("path/to/movie.mov")
+
+movie.duration # 7.5 (duration of the movie in seconds)
+movie.bitrate # 481 (bitrate in kb/s)
+movie.size # 455546 (filesize in bytes)
+
+movie.video_stream # "h264, yuv420p, 640x480 [PAR 1:1 DAR 4:3], 371 kb/s, 16.75 fps, 15 tbr, 600 tbn, 1200 tbc" (raw video stream info)
+movie.video_codec # "h264"
+movie.colorspace # "yuv420p"
+movie.resolution # "640x480"
+movie.width # 640 (width of the movie in pixels)
+movie.height # 480 (height of the movie in pixels)
+movie.frame_rate # 16.72 (frames per second)
+
+movie.audio_stream # "aac, 44100 Hz, stereo, s16, 75 kb/s" (raw audio stream info)
+movie.audio_codec # "aac"
+movie.audio_sample_rate # 44100
+movie.audio_channels # 2
+
+movie.valid? # true (would be false if ffmpeg fails to read the movie)
+```
+
+### Transcoding
+
+First argument is the output file path.
+
+``` ruby
+movie.transcode("tmp/movie.mp4") # Default ffmpeg settings for mp4 format
+```
+
+Keep track of progress with an optional block.
+
+``` ruby
+movie.transcode("movie.mp4") { |progress| puts progress } # 0.2 ... 0.5 ... 1.0
+```
+
+Give custom command line options with a string.
+
+``` ruby
+movie.transcode("movie.mp4", "-ac aac -vc libx264 -ac 2 ...")
+```
+
+Use the EncodingOptions parser for humanly readable transcoding options. Below you'll find most of the supported options. Note that the :custom key will be used as is without modification so use it for any tricky business you might need.
+
+``` ruby
+options = {video_codec: "libx264", frame_rate: 10, resolution: "320x240", video_bitrate: 300, video_bitrate_tolerance: 100,
+           aspect: 1.333333, keyframe_interval: 90,
+           x264_vprofile: "high", x264_preset: "slow",
+           audio_codec: "libfaac", audio_bitrate: 32, audio_sample_rate: 22050, audio_channels: 1,
+           threads: 2,
+           custom: "-vf crop=60:60:10:10"}
+movie.transcode("movie.mp4", options)
+```
+
+The transcode function returns a Movie object for the encoded file.
+
+``` ruby
+transcoded_movie = movie.transcode("tmp/movie.flv")
+
+transcoded_movie.video_codec # "flv"
+transcoded_movie.audio_codec # "mp3"
+```
+
+Aspect ratio is added to encoding options automatically if none is specified.
+
+``` ruby
+options = { resolution: "320x180" } # Will add -aspect 1.77777777777778 to ffmpeg
+```
+
+Preserve aspect ratio on width or height by using the preserve_aspect_ratio transcoder option.
+
+``` ruby
+widescreen_movie = FFMPEG::Movie.new("path/to/widescreen_movie.mov")
+
+options = { resolution: "320x240" }
+
+transcoder_options = { preserve_aspect_ratio: :width }
+widescreen_movie.transcode("movie.mp4", options, transcoder_options) # Output resolution will be 320x180
+
+transcoder_options = { preserve_aspect_ratio: :height }
+widescreen_movie.transcode("movie.mp4", options, transcoder_options) # Output resolution will be 426x240
+```
+
+For constant bitrate encoding use video_min_bitrate and video_max_bitrate with buffer_size.
+
+``` ruby
+options = {video_min_bitrate: 600, video_max_bitrate: 600, buffer_size: 2000}
+movie.transcode("movie.flv", options)
+```
+
+Add watermark image on the video.
+
+For example, you want to add a watermark on the video at right top corner with 10px padding.
+
+``` ruby
+options = { watermark: "full_path_of_watermark.png", resolution: "640x360", watermark_filter: { position: "RT", padding_x: 10, padding_y: 10 } }
+```
+
+Position can be "LT" (Left Top Corner), "RT" (Right Top Corner), "LB" (Left Bottom Corner), "RB" (Right Bottom Corner).
+
+### Taking Screenshots
+
+You can use the screenshot method to make taking screenshots a bit simpler.
+
+``` ruby
+movie.screenshot("screenshot.jpg")
+```
+
+The screenshot method has the very same API as transcode so the same options will work.
+
+``` ruby
+movie.screenshot("screenshot.bmp", seek_time: 5, resolution: '320x240')
+```
+
+You can preserve aspect ratio the same way as when using transcode.
+
+``` ruby
+movie.screenshot("screenshot.png", { seek_time: 2, resolution: '200x120' }, preserve_aspect_ratio: :width)
+```
+
+Specify the path to ffmpeg
+--------------------------
+
+By default, streamio assumes that the ffmpeg binary is available in the execution path and named ffmpeg and so will run commands that look something like "ffmpeg -i /path/to/input.file ...". Use the FFMPEG.ffmpeg_binary setter to specify the full path to the binary if necessary:
+
+``` ruby
+FFMPEG.ffmpeg_binary = '/usr/local/bin/ffmpeg'
+```
+
+This will cause the same command to run as "/usr/local/bin/ffmpeg -i /path/to/input.file ..." instead.
+
+
+Automatically kill hung processes
+---------------------------------
+
+By default, streamio will wait for 30 seconds between IO feedback from the FFMPEG process. After which an error is logged and the process killed.
+It is possible to modify this behaviour by setting a new default:
+
+``` ruby
+# Change the timeout
+Transcoder.timeout = 10
+
+# Disable the timeout altogether
+Transcoder.timeout = false
+```
+
+Disabling output file validation
+------------------------------
+
+By default Transcoder validates the output file, in case you use FFMPEG for HLS
+format that creates multiple outputs you can disable the validation by passing
+`validate: false` to transcoder_options.
+
+Note that transcode will not return the encoded movie object in this case since
+attempting to open a (possibly) invalid output file might result in an error being raised.
+
+```ruby
+transcoder_options = { validate: false }
+movie.transcode("movie.mp4", options, transcoder_options) # returns nil
+```
+
+
+Copyright
+---------
+
+Copyright (c) Streamio AB. See LICENSE for details.

data/lib/ffmpeg/encoding_options.rb

@@ -0,0 +1,164 @@
+module FFMPEG
+  class EncodingOptions < Hash
+    def initialize(options = {})
+      merge!(options)
+    end
+
+    def to_s
+      params = collect do |key, value|
+        send("convert_#{key}", value) if value && supports_option?(key)
+      end
+
+      # codecs should go before the presets so that the files will be matched successfully
+      # all other parameters go after so that we can override whatever is in the preset
+      codecs = params.select { |p| p =~ /codec/ }
+      presets = params.select { |p| p =~ /\-.pre/ }
+      other = params - codecs - presets
+      params = codecs + presets + other
+
+      params_string = params.join(" ")
+      params_string << " #{convert_aspect(calculate_aspect)}" if calculate_aspect?
+      params_string
+    end
+
+    def width
+      self[:resolution].split("x").first.to_i rescue nil
+    end
+
+    def height
+      self[:resolution].split("x").last.to_i rescue nil
+    end
+
+    private
+    def supports_option?(option)
+      option = RUBY_VERSION < "1.9" ? "convert_#{option}" : "convert_#{option}".to_sym
+      private_methods.include?(option)
+    end
+
+    def convert_aspect(value)
+      "-aspect #{value}"
+    end
+
+    def calculate_aspect
+      width, height = self[:resolution].split("x")
+      width.to_f / height.to_f
+    end
+
+    def calculate_aspect?
+      self[:aspect].nil? && self[:resolution]
+    end
+
+    def convert_video_codec(value)
+      "-vcodec #{value}"
+    end
+
+    def convert_frame_rate(value)
+      "-r #{value}"
+    end
+
+    def convert_resolution(value)
+      "-s #{value}"
+    end
+
+    def convert_video_bitrate(value)
+      "-b:v #{k_format(value)}"
+    end
+
+    def convert_audio_codec(value)
+      "-acodec #{value}"
+    end
+
+    def convert_audio_bitrate(value)
+      "-b:a #{k_format(value)}"
+    end
+
+    def convert_audio_sample_rate(value)
+      "-ar #{value}"
+    end
+
+    def convert_audio_channels(value)
+      "-ac #{value}"
+    end
+
+    def convert_video_max_bitrate(value)
+      "-maxrate #{k_format(value)}"
+    end
+
+    def convert_video_min_bitrate(value)
+      "-minrate #{k_format(value)}"
+    end
+
+    def convert_buffer_size(value)
+      "-bufsize #{k_format(value)}"
+    end
+
+    def convert_video_bitrate_tolerance(value)
+      "-bt #{k_format(value)}"
+    end
+
+    def convert_threads(value)
+      "-threads #{value}"
+    end
+
+    def convert_duration(value)
+      "-t #{value}"
+    end
+
+    def convert_video_preset(value)
+      "-vpre #{value}"
+    end
+
+    def convert_audio_preset(value)
+      "-apre #{value}"
+    end
+
+    def convert_file_preset(value)
+      "-fpre #{value}"
+    end
+
+    def convert_keyframe_interval(value)
+      "-g #{value}"
+    end
+
+    def convert_seek_time(value)
+      "-ss #{value}"
+    end
+
+    def convert_screenshot(value)
+      value ? "-vframes 1 -f image2" : ""
+    end
+
+    def convert_x264_vprofile(value)
+      "-vprofile #{value}"
+    end
+
+    def convert_x264_preset(value)
+      "-preset #{value}"
+    end
+
+    def convert_watermark(value)
+      "-i #{value}"
+    end
+
+    def convert_watermark_filter(value)
+      case value[:position].to_s
+      when "LT"
+        "-filter_complex 'scale=#{self[:resolution]},overlay=x=#{value[:padding_x]}:y=#{value[:padding_y]}'"
+      when "RT"
+        "-filter_complex 'scale=#{self[:resolution]},overlay=x=main_w-overlay_w-#{value[:padding_x]}:y=#{value[:padding_y]}'"
+      when "LB"
+        "-filter_complex 'scale=#{self[:resolution]},overlay=x=#{value[:padding_x]}:y=main_h-overlay_h-#{value[:padding_y]}'"
+      when "RB"
+        "-filter_complex 'scale=#{self[:resolution]},overlay=x=main_w-overlay_w-#{value[:padding_x]}:y=main_h-overlay_h-#{value[:padding_y]}'"
+      end  
+    end
+
+    def convert_custom(value)
+      value
+    end
+
+    def k_format(value)
+      value.to_s.include?("k") ? value : "#{value}k"
+    end
+  end
+end

data/lib/ffmpeg/errors.rb

@@ -0,0 +1,4 @@
+module FFMPEG
+  class Error < StandardError
+  end
+end

data/lib/ffmpeg/io_monkey.rb

@@ -0,0 +1,42 @@
+require 'timeout'
+require 'thread'
+if RUBY_PLATFORM =~ /(win|w)(32|64)$/
+  begin
+    require 'win32/process'
+  rescue LoadError
+    "Warning: streamio-ffmpeg is missing the win32-process gem to properly handle hung transcodings. Install the gem (in Gemfile if using bundler) to avoid errors."
+  end
+end
+
+#
+# Monkey Patch timeout support into the IO class
+#
+class IO
+  def each_with_timeout(pid, seconds, sep_string=$/)
+    last_update = Time.now
+
+    current_thread = Thread.current
+    check_update_thread = Thread.new do
+      loop do
+        sleep 0.1
+        if last_update - Time.now < -seconds
+          current_thread.raise Timeout::Error.new('output wait time expired')
+        end
+      end
+    end
+
+    each(sep_string) do |buffer|
+      last_update = Time.now
+      yield buffer
+    end
+  rescue Timeout::Error
+    if RUBY_PLATFORM =~ /(win|w)(32|64)$/
+      Process.kill(1, pid)
+    else
+      Process.kill('SIGKILL', pid)
+    end
+    raise
+  ensure
+    check_update_thread.kill
+  end
+end

data/lib/ffmpeg/movie.rb

@@ -0,0 +1,136 @@
+require 'time'
+
+module FFMPEG
+  class Movie
+    attr_reader :path, :duration, :time, :bitrate, :rotation, :creation_time
+    attr_reader :video_stream, :video_codec, :video_bitrate, :colorspace, :resolution, :sar, :dar
+    attr_reader :audio_stream, :audio_codec, :audio_bitrate, :audio_sample_rate
+    attr_reader :container
+
+    def initialize(path)
+      raise Errno::ENOENT, "the file '#{path}' does not exist" unless File.exists?(path)
+
+      @path = path
+
+      # ffmpeg will output to stderr
+      command = "#{FFMPEG.ffmpeg_binary} -i #{Shellwords.escape(path)}"
+      output = Open3.popen3(command) { |stdin, stdout, stderr| stderr.read }
+
+      fix_encoding(output)
+
+      output[/Input \#\d+\,\s*(\S+),\s*from/]
+      @container = $1
+
+      output[/Duration: (\d{2}):(\d{2}):(\d{2}\.\d{2})/]
+      @duration = ($1.to_i*60*60) + ($2.to_i*60) + $3.to_f
+
+      output[/start: (\d*\.\d*)/]
+      @time = $1 ? $1.to_f : 0.0
+
+      output[/creation_time {1,}: {1,}(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})/]
+      @creation_time = $1 ? Time.parse("#{$1}") : nil
+
+      output[/bitrate: (\d*)/]
+      @bitrate = $1 ? $1.to_i : nil
+
+      output[/rotate\ {1,}:\ {1,}(\d*)/]
+      @rotation = $1 ? $1.to_i : nil
+
+      output[/Video:\ (.*) (|(default))/]
+      @video_stream = $1
+
+      output[/Audio:\ (.*) (|(default))/]
+      @audio_stream = $1
+
+      if @video_stream
+        commas_except_in_parenthesis = /(?:\([^()]*\)|[^,])+/ # regexp to handle "yuv420p(tv, bt709)" colorspace etc from http://goo.gl/6oi645
+        @video_codec, @colorspace, resolution, video_bitrate = @video_stream.scan(commas_except_in_parenthesis).map(&:strip)
+        @video_bitrate = video_bitrate =~ %r(\A(\d+) kb/s\Z) ? $1.to_i : nil
+        @resolution = resolution.split(" ").first rescue nil # get rid of [PAR 1:1 DAR 16:9]
+        @sar = $1 if @video_stream[/SAR (\d+:\d+)/]
+        @dar = $1 if @video_stream[/DAR (\d+:\d+)/]
+      end
+
+      if @audio_stream
+        @audio_codec, audio_sample_rate, @audio_channels, unused, audio_bitrate = @audio_stream.split(/\s?,\s?/)
+        @audio_bitrate = audio_bitrate =~ %r(\A(\d+)) ? $1.to_i : nil
+        @audio_sample_rate = audio_sample_rate[/\d*/].to_i
+      end
+
+      @invalid = true if @video_stream.to_s.empty? && @audio_stream.to_s.empty?
+      @invalid = true if output.include?("is not supported")
+      @invalid = true if output.include?("could not find codec parameters")
+    end
+
+    def valid?
+      not @invalid
+    end
+
+    def width
+      resolution.split("x")[0].to_i rescue nil
+    end
+
+    def height
+      resolution.split("x")[1].to_i rescue nil
+    end
+
+    def calculated_aspect_ratio
+      aspect_from_dar || aspect_from_dimensions
+    end
+
+    def calculated_pixel_aspect_ratio
+      aspect_from_sar || 1
+    end
+
+    def size
+      File.size(@path)
+    end
+
+    def audio_channels
+      return nil unless @audio_channels
+      return @audio_channels[/\d*/].to_i if @audio_channels["channels"]
+      return 1 if @audio_channels["mono"]
+      return 2 if @audio_channels["stereo"]
+      return 6 if @audio_channels["5.1"]
+    end
+
+    def frame_rate
+      return nil unless video_stream
+      video_stream[/(\d*\.?\d*)\s?fps/] ? $1.to_f : nil
+    end
+
+    def transcode(output_file, options = EncodingOptions.new, transcoder_options = {}, &block)
+      Transcoder.new(self, output_file, options, transcoder_options).run &block
+    end
+
+    def screenshot(output_file, options = EncodingOptions.new, transcoder_options = {}, &block)
+      Transcoder.new(self, output_file, options.merge(screenshot: true), transcoder_options).run &block
+    end
+
+    protected
+    def aspect_from_dar
+      return nil unless dar
+      w, h = dar.split(":")
+      aspect = w.to_f / h.to_f
+      aspect.zero? ? nil : aspect
+    end
+
+    def aspect_from_sar
+      return nil unless sar
+      w, h = sar.split(":")
+      aspect = w.to_f / h.to_f
+      aspect.zero? ? nil : aspect
+    end
+
+    def aspect_from_dimensions
+      aspect = width.to_f / height.to_f
+      aspect.nan? ? nil : aspect
+    end
+
+    def fix_encoding(output)
+      output[/test/] # Running a regexp on the string throws error if it's not UTF-8
+    rescue ArgumentError
+      output.force_encoding("ISO-8859-1")
+    end
+  end
+end

data/lib/ffmpeg/transcoder.rb

@@ -0,0 +1,127 @@
+require 'open3'
+require 'shellwords'
+
+module FFMPEG
+  class Transcoder
+    @@timeout = 30
+
+    def self.timeout=(time)
+      @@timeout = time
+    end
+
+    def self.timeout
+      @@timeout
+    end
+
+    def initialize(movie, output_file, options = EncodingOptions.new, transcoder_options = {})
+      @movie = movie
+      @output_file = output_file
+
+      if options.is_a?(String) || options.is_a?(EncodingOptions)
+        @raw_options = options
+      elsif options.is_a?(Hash)
+        @raw_options = EncodingOptions.new(options)
+      else
+        raise ArgumentError, "Unknown options format '#{options.class}', should be either EncodingOptions, Hash or String."
+      end
+
+      @transcoder_options = transcoder_options
+      @errors = []
+
+      apply_transcoder_options
+    end
+
+    def run(&block)
+      transcode_movie(&block)
+      if @transcoder_options[:validate]
+        validate_output_file(&block)
+        return encoded
+      else
+        return nil
+      end
+    end
+
+    def encoding_succeeded?
+      @errors << "no output file created" and return false unless File.exists?(@output_file)
+      @errors << "encoded file is invalid" and return false unless encoded.valid?
+      true
+    end
+
+    def encoded
+      @encoded ||= Movie.new(@output_file)
+    end
+
+    private
+    # frame= 4855 fps= 46 q=31.0 size=   45306kB time=00:02:42.28 bitrate=2287.0kbits/
+    def transcode_movie
+      @command = "#{FFMPEG.ffmpeg_binary} -y -i #{Shellwords.escape(@movie.path)} #{@raw_options} #{Shellwords.escape(@output_file)}"
+      FFMPEG.logger.info("Running transcoding...\n#{@command}\n")
+      @output = ""
+
+      Open3.popen3(@command) do |stdin, stdout, stderr, wait_thr|
+        begin
+          yield(0.0) if block_given?
+          next_line = Proc.new do |line|
+            fix_encoding(line)
+            @output << line
+            if line.include?("time=")
+              if line =~ /time=(\d+):(\d+):(\d+.\d+)/ # ffmpeg 0.8 and above style
+                time = ($1.to_i * 3600) + ($2.to_i * 60) + $3.to_f
+              else # better make sure it wont blow up in case of unexpected output
+                time = 0.0
+              end
+              progress = time / @movie.duration
+              yield(progress) if block_given?
+            end
+          end
+
+          if @@timeout
+            stderr.each_with_timeout(wait_thr.pid, @@timeout, 'size=', &next_line)
+          else
+            stderr.each('size=', &next_line)
+          end
+
+        rescue Timeout::Error => e
+          FFMPEG.logger.error "Process hung...\n@command\n#{@command}\nOutput\n#{@output}\n"
+          raise Error, "Process hung. Full output: #{@output}"
+        end
+      end
+    end
+
+    def validate_output_file(&block)
+      if encoding_succeeded?
+        yield(1.0) if block_given?
+        FFMPEG.logger.info "Transcoding of #{@movie.path} to #{@output_file} succeeded\n"
+      else
+        errors = "Errors: #{@errors.join(", ")}. "
+        FFMPEG.logger.error "Failed encoding...\n#{@command}\n\n#{@output}\n#{errors}\n"
+        raise Error, "Failed encoding.#{errors}Full output: #{@output}"
+      end
+    end
+
+    def apply_transcoder_options
+       # if true runs #validate_output_file
+      @transcoder_options[:validate] = @transcoder_options.fetch(:validate) { true }
+
+      return if @movie.calculated_aspect_ratio.nil?
+      case @transcoder_options[:preserve_aspect_ratio].to_s
+      when "width"
+        new_height = @raw_options.width / @movie.calculated_aspect_ratio
+        new_height = new_height.ceil.even? ? new_height.ceil : new_height.floor
+        new_height += 1 if new_height.odd? # needed if new_height ended up with no decimals in the first place
+        @raw_options[:resolution] = "#{@raw_options.width}x#{new_height}"
+      when "height"
+        new_width = @raw_options.height * @movie.calculated_aspect_ratio
+        new_width = new_width.ceil.even? ? new_width.ceil : new_width.floor
+        new_width += 1 if new_width.odd?
+        @raw_options[:resolution] = "#{new_width}x#{@raw_options.height}"
+      end
+    end
+
+    def fix_encoding(output)
+      output[/test/]
+    rescue ArgumentError
+      output.force_encoding("ISO-8859-1")
+    end
+  end
+end

data/lib/ffmpeg/version.rb

@@ -0,0 +1,3 @@
+module FFMPEG
+  VERSION = "2.0.0"
+end

data/lib/streamio-ffmpeg.rb

@@ -0,0 +1,48 @@
+$LOAD_PATH.unshift File.dirname(__FILE__)
+
+require 'logger'
+require 'stringio'
+
+require 'ffmpeg/version'
+require 'ffmpeg/errors'
+require 'ffmpeg/movie'
+require 'ffmpeg/io_monkey'
+require 'ffmpeg/transcoder'
+require 'ffmpeg/encoding_options'
+
+module FFMPEG
+  # FFMPEG logs information about its progress when it's transcoding.
+  # Jack in your own logger through this method if you wish to.
+  #
+  # @param [Logger] log your own logger
+  # @return [Logger] the logger you set
+  def self.logger=(log)
+    @logger = log
+  end
+
+  # Get FFMPEG logger.
+  #
+  # @return [Logger]
+  def self.logger
+    return @logger if @logger
+    logger = Logger.new(STDOUT)
+    logger.level = Logger::INFO
+    @logger = logger
+  end
+
+  # Set the path of the ffmpeg binary.
+  # Can be useful if you need to specify a path such as /usr/local/bin/ffmpeg
+  #
+  # @param [String] path to the ffmpeg binary
+  # @return [String] the path you set
+  def self.ffmpeg_binary=(bin)
+    @ffmpeg_binary = bin
+  end
+
+  # Get the path to the ffmpeg binary, defaulting to 'ffmpeg'
+  #
+  # @return [String] the path to the ffmpeg binary
+  def self.ffmpeg_binary
+    @ffmpeg_binary || 'ffmpeg'
+  end
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: r7streamio_ffmpeg
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Rodrigo Martins
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.1'
+description: 
+email:
+- rodrigo@rrmartins.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG
+- LICENSE
+- README.md
+- lib/ffmpeg/encoding_options.rb
+- lib/ffmpeg/errors.rb
+- lib/ffmpeg/io_monkey.rb
+- lib/ffmpeg/movie.rb
+- lib/ffmpeg/transcoder.rb
+- lib/ffmpeg/version.rb
+- lib/streamio-ffmpeg.rb
+homepage: http://github.com/r7com/streamio-ffmpeg
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Wraps ffmpeg to read metadata and transcodes videos. Copy with changes on
+  github.com/streamio/streamio-ffmpeg
+test_files: []