powerand-ffmpeg 2.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8b54f1d85f8f8eb48cd261d420774e194c4514ce
+  data.tar.gz: 00230f6e7783dc8c8bacc87c497daad354f8aa05
+SHA512:
+  metadata.gz: b1bcd7442f6adf143d6e36ddd3681340d3481f4cf79a56c4b59039550bcde2c91f2b332a1863959a28fed7d015f7017bef46ba7af0c545800f24eb93fcc5a07c
+  data.tar.gz: 8d3133f63f559295eeb865d8a2df124531b71aa16c3839b3c444fe15ea3c2c0d23b24604c26fc32e01cb9c245e49548e464e1385598f23a056363d054e5a64ec

data/CHANGELOG

@@ -0,0 +1,225 @@
+== Master
+
+Current with 2.1.0
+
+== 2.1.0 2016-03-04
+
+Improvements:
+* Silent mode support, example:
+  FFMPEG::Movie.new('path/name.ext').transcode('new.ext', { silent: true })
+* Added gemspec
+
+== 2.0.0 2016-01-14
+
+New:
+* Support watermarking (thanks smoothdvd)
+* Bumped target ffmpeg version to 2.8
+
+Improvements:
+* Allow parenthesis in colorspace (thanks walterdavis for initial code and rociiu for finding a bug with it)
+* Width and height now switched if video is filmed in portrait mode. ffmpeg 2.7 or later now automatically rotates output
+* Movie metadata now provided with ffprobe (#114). Thanks to Ryan Lovelett for the contributions!
+* Ability to create multiple screenshots at consistent intervals in one pass (#113)
+
+== 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) 2016 powerand 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,218 @@
+powerand FFMPEG
+===============
+
+Simple yet powerful wrapper around the ffmpeg command for reading metadata and transcoding movies.
+
+Installation
+------------
+
+    (sudo) gem install powerand-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.8.4. 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 'powerand-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')
+```
+
+To generate multiple screenshots in a single pass, specify `vframes`. The following code
+generates up to 20 screenshots every 10 seconds:
+
+``` ruby
+movie.screenshot("screenshot.jpg", vframes: 20, frame_rate: '1/6')
+```
+
+To specify the quality when generating compressed screenshots (.jpg), use `quality` which specifies
+ffmpeg `-v:q` option. Quality is an integer between 1 and 31, where lower is better quality:
+
+``` ruby
+movie.screenshot("screenshot.jpg", quality: 3)
+```
+
+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, the gem 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, the gem 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) powerand AB. See LICENSE for details.

data/lib/ffmpeg/encoding_options.rb

@@ -0,0 +1,179 @@
+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/ }
+      watermarkoptions = params.select { |p| p =~ /i / || p=~ /filter_complex/ }  
+      other = params - codecs - presets - watermarkoptions
+      params = watermarkoptions + 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_target(value)
+      "-target #{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)
+      vframes = '-vframes 1 ' unless self[:vframes]
+      value ? "#{vframes}-f image2" : ""
+    end
+
+    def convert_quality(value)
+      "-q:v #{value}"
+    end
+
+    def convert_vframes(value)
+      "-vframes #{value}"
+    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,176 @@
+require 'time'
+require 'multi_json'
+
+module FFMPEG
+  class Movie
+    attr_reader :path, :duration, :time, :bitrate, :rotation, :creation_time
+    attr_reader :video_stream, :video_codec, :video_bitrate, :colorspace, :width, :height, :sar, :dar, :frame_rate
+    attr_reader :audio_stream, :audio_codec, :audio_bitrate, :audio_sample_rate, :audio_channels
+    attr_reader :container
+
+    def initialize(path)
+      raise Errno::ENOENT, "the file '#{path}' does not exist" unless File.exist?(path)
+
+      @path = path
+
+      # ffmpeg will output to stderr
+      command = "#{FFMPEG.ffprobe_binary} -i #{Shellwords.escape(path)} -print_format json -show_format -show_streams -show_error"
+      std_output = ''
+      std_error = ''
+
+      Open3.popen3(command) do |stdin, stdout, stderr|
+        std_output = stdout.read unless stdout.nil?
+        std_error = stderr.read unless stderr.nil?
+      end
+
+      fix_encoding(std_output)
+
+      metadata = MultiJson.load(std_output, symbolize_keys: true)
+
+      if metadata.key?(:error)
+
+        @duration = 0
+
+      else
+
+        video_streams = metadata[:streams].select { |stream| stream.key?(:codec_type) and stream[:codec_type] === 'video' }
+        audio_streams = metadata[:streams].select { |stream| stream.key?(:codec_type) and stream[:codec_type] === 'audio' }
+
+        @container = metadata[:format][:format_name]
+
+        @duration = metadata[:format][:duration].to_f
+
+        @time = metadata[:format][:start_time].to_f
+
+        @creation_time = if metadata[:format].key?(:tags) and metadata[:format][:tags].key?(:creation_time)
+                           Time.parse(metadata[:format][:tags][:creation_time])
+                         else
+                           nil
+                         end
+
+        @bitrate = metadata[:format][:bit_rate].to_i
+
+        unless video_streams.empty?
+          # TODO: Handle multiple video codecs (is that possible?)
+          video_stream = video_streams.first
+          @video_codec = video_stream[:codec_name]
+          @colorspace = video_stream[:pix_fmt]
+          @width = video_stream[:width]
+          @height = video_stream[:height]
+          @video_bitrate = video_stream[:bit_rate].to_i
+          @sar = video_stream[:sample_aspect_ratio]
+          @dar = video_stream[:display_aspect_ratio]
+
+          @frame_rate = unless video_stream[:avg_frame_rate] == '0/0'
+                          Rational(video_stream[:avg_frame_rate])
+                        else
+                          nil
+                        end
+
+          @video_stream = "#{video_stream[:codec_name]} (#{video_stream[:profile]}) (#{video_stream[:codec_tag_string]} / #{video_stream[:codec_tag]}), #{colorspace}, #{resolution} [SAR #{sar} DAR #{dar}]"
+
+          @rotation = if video_stream.key?(:tags) and video_stream[:tags].key?(:rotate)
+                        video_stream[:tags][:rotate].to_i
+                      else
+                        nil
+                      end
+        end
+
+        unless audio_streams.empty?
+          # TODO: Handle multiple audio codecs
+          audio_stream = audio_streams.first
+          @audio_channels = audio_stream[:channels].to_i
+          @audio_codec = audio_stream[:codec_name]
+          @audio_sample_rate = audio_stream[:sample_rate].to_i
+          @audio_bitrate = audio_stream[:bit_rate].to_i
+          @audio_channel_layout = audio_stream[:channel_layout]
+          @audio_stream = "#{audio_codec} (#{audio_stream[:codec_tag_string]} / #{audio_stream[:codec_tag]}), #{audio_sample_rate} Hz, #{audio_channel_layout}, #{audio_stream[:sample_fmt]}, #{audio_bitrate} bit/s"
+        end
+
+      end
+
+      @invalid = true if metadata.key?(:error)
+      @invalid = true if std_error.include?("Unsupported codec")
+      @invalid = true if std_error.include?("is not supported")
+      @invalid = true if std_error.include?("could not find codec parameters")
+    end
+
+    def valid?
+      not @invalid
+    end
+
+    def width
+      rotation.nil? || rotation == 180 ? @width : @height;
+    end
+
+    def height
+      rotation.nil? || rotation == 180 ? @height : @width;
+    end
+
+    def resolution
+      unless width.nil? or height.nil?
+        "#{width}x#{height}"
+      end
+    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_channel_layout
+      # TODO Whenever support for ffmpeg/ffprobe 1.2.1 is dropped this is no longer needed
+      @audio_channel_layout || case(audio_channels)
+                                 when 1
+                                   'stereo'
+                                 when 2
+                                   'stereo'
+                                 when 6
+                                   '5.1'
+                                 else
+                                   'unknown'
+                               end
+    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,130 @@
+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
+
+      FFMPEG.logger.level = Logger::INFO
+
+      if options.is_a?(String) || options.is_a?(EncodingOptions)
+        @raw_options = options
+      elsif options.is_a?(Hash)
+        FFMPEG.logger.level = Logger::ERROR if options[:silent]
+        @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.exist?(@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/powerand-ffmpeg.rb

@@ -0,0 +1,94 @@
+require 'logger'
+require 'stringio'
+require 'byebug'
+
+Proc.new do |this_dir|
+  %w(
+    errors
+    movie
+    io_monkey
+    transcoder
+    encoding_options
+  ).each do |lib_name|
+    require File.join(this_dir, 'ffmpeg', lib_name)
+  end
+end.call(File.dirname(__FILE__))
+
+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
+  # @raise Errno::ENOENT if the ffmpeg binary cannot be found
+  def self.ffmpeg_binary=(bin)
+    if bin.is_a?(String) && !File.executable?(bin)
+      raise Errno::ENOENT, "the ffmpeg binary, \'#{bin}\', is not executable"
+    end
+    @ffmpeg_binary = bin
+  end
+
+  # Get the path to the ffmpeg binary, defaulting to 'ffmpeg'
+  #
+  # @return [String] the path to the ffmpeg binary
+  # @raise Errno::ENOENT if the ffmpeg binary cannot be found
+  def self.ffmpeg_binary
+    @ffmpeg_binary || which('ffmpeg')
+  end
+
+  # Get the path to the ffprobe binary, defaulting to what is on ENV['PATH']
+  #
+  # @return [String] the path to the ffprobe binary
+  # @raise Errno::ENOENT if the ffprobe binary cannot be found
+  def self.ffprobe_binary
+    @ffprobe_binary || which('ffprobe')
+  end
+
+  # Set the path of the ffprobe binary.
+  # Can be useful if you need to specify a path such as /usr/local/bin/ffprobe
+  #
+  # @param [String] path to the ffprobe binary
+  # @return [String] the path you set
+  # @raise Errno::ENOENT if the ffprobe binary cannot be found
+  def self.ffprobe_binary=(bin)
+    if bin.is_a?(String) && !File.executable?(bin)
+      raise Errno::ENOENT, "the ffprobe binary, \'#{bin}\', is not executable"
+    end
+    @ffprobe_binary = bin
+  end
+
+  # Cross-platform way of finding an executable in the $PATH.
+  #
+  #   which('ruby') #=> /usr/bin/ruby
+  # see: http://stackoverflow.com/questions/2108727/which-in-ruby-checking-if-program-exists-in-path-from-ruby
+  def self.which(cmd)
+    exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+    ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+      exts.each { |ext|
+        exe = File.join(path, "#{cmd}#{ext}")
+        return exe if File.executable? exe
+      }
+    end
+    raise Errno::ENOENT, "the #{cmd} binary could not be found in #{ENV['PATH']}"
+  end
+
+end

data/powerand-ffmpeg.gemspec

@@ -0,0 +1,14 @@
+Gem::Specification.new do |s|
+  s.name          = "powerand-ffmpeg"
+  s.version       = "2.1.0"
+  s.date          = "2016-03-05"
+  s.summary       = "powerand FFMPEG"
+  s.description   = %q{
+    Simple yet powerful wrapper around the ffmpeg command
+    for reading metadata and transcoding movies}
+  s.authors       = ["Yudin Artur"]
+  s.email         = ["artur.yudin.88@gmail.com"]
+  s.files         = `git ls-files`.split($/)
+  s.homepage      = "http://rubygems.org/gems/powerand-ffmpeg"
+  s.license       = "MIT"
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: powerand-ffmpeg
+version: !ruby/object:Gem::Version
+  version: 2.1.0
+platform: ruby
+authors:
+- Yudin Artur
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-05 00:00:00.000000000 Z
+dependencies: []
+description: |2-
+
+      Simple yet powerful wrapper around the ffmpeg command
+      for reading metadata and transcoding movies
+email:
+- artur.yudin.88@gmail.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/powerand-ffmpeg.rb
+- powerand-ffmpeg.gemspec
+homepage: http://rubygems.org/gems/powerand-ffmpeg
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: powerand FFMPEG
+test_files: []