brainsome_streamio-ffmpeg 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 945f3f21932ccb39e121d05fa8630766c5738a89
+  data.tar.gz: 76469c827294b76473ad6a6fd03a5ef434e7a481
+SHA512:
+  metadata.gz: 9010b5c343f7c56274c5d5dc5d5f369a3707c861e6e186bd0ff658b3682dfe725148d233db7ee06135588720baa6387a90785ff2797a7da498192f741f06359b
+  data.tar.gz: 94e9f48df5191c512f200e568f8e7f8265706201251b32cf956e46b6e17eec399ff7f4106aa563c6d023e81ef1580d5ad56f61a9d0b908b48f64939a683c3021

data/CHANGELOG

@@ -0,0 +1,175 @@
+== 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,191 @@
+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
+
+This version is tested against ffmpeg 1.0. 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,
+           :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
+```
+
+Disable the enlarge transcoding option to avoid lossy scaling.
+
+``` ruby
+# With original resolution "640x480"
+encoding_options = {:resolution => "1080x2"}
+transcoder_options = {:preserve_aspect_ratio => :width, :enlarge => false}
+# The movie will not be scaled up
+
+encoding_options = {:resolution => "320x2"}
+transcoder_options = {:preserve_aspect_ratio => :width, :enlarge => false}
+# The movie will be scaled down to output resolution "320x240"
+```
+
+With the transcoder option "autorotate" set to true, videos that contain rotation information 
+(usually videos from mobile phones) and would normally play "sideways" are automatically oriented correctly.
+
+``` ruby
+# With original resolution "640x480", rotation "90"
+transcoder_options = {:autoroate => true}
+# The movie is rotated 90 degrees counterclockwise to output resolution "480x640"
+```
+
+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)
+```
+
+### 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 200 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 = 30
+
+# Disable the timeout altogether
+Transcoder.timeout = false
+```
+
+
+Copyright
+---------
+
+Copyright (c) 2011 Streamio AB. See LICENSE for details.

data/lib/ffmpeg/encoding_options.rb

@@ -0,0 +1,147 @@
+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_custom(value)
+      value
+    end
+    
+    def convert_metadata(value)
+      "-metadata:#{value}"
+    end
+
+    def convert_video_filter(value)
+      "-vf #{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,59 @@
+if RUBY_VERSION =~ /1\.8/
+	# Useful when `timeout.rb`, which, on M.R.I 1.8, relies on green threads, does not work consistently.
+	begin
+		require 'system_timer'
+		FFMPEG::Timer = SystemTimer
+	rescue LoadError
+		require 'timeout'
+		FFMPEG::Timer = Timeout
+	end
+else
+	require 'timeout'
+	FFMPEG::Timer = Timeout
+end
+
+require 'win32/process' if RUBY_PLATFORM =~ /(win|w)(32|64)$/
+
+#
+# Monkey Patch timeout support into the IO class
+#
+class IO
+  def each_with_timeout(pid, seconds, sep_string=$/)
+  	sleeping_queue = Queue.new
+  	thread = nil
+
+  	timer_set = lambda do
+  	  thread = new_thread(pid) { FFMPEG::Timer.timeout(seconds) { sleeping_queue.pop } }
+  	end
+
+  	timer_cancel = lambda do
+  		thread.kill if thread rescue nil
+  	end
+
+  	timer_set.call
+  	each(sep_string) do |buffer|
+  		timer_cancel.call
+  		yield buffer
+  		timer_set.call
+  	end
+  ensure
+  	timer_cancel.call
+  end
+
+  private
+  def new_thread(pid, &block)
+  	current_thread = Thread.current
+  	Thread.new do
+  		begin
+  			block.call
+  		rescue Exception => e
+  			current_thread.raise e
+  			if RUBY_PLATFORM =~ /(win|w)(32|64)$/
+  				Process.kill(1, pid)
+  			else
+  				Process.kill('SIGKILL', pid)
+  			end
+  		end
+  	end
+  end
+end

data/lib/ffmpeg/movie.rb

@@ -0,0 +1,119 @@
+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, :dar
+    attr_reader :audio_stream, :audio_codec, :audio_bitrate, :audio_sample_rate
+    
+    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[/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: (.*)/]
+      @video_stream = $1
+      
+      output[/Audio: (.*)/]
+      @audio_stream = $1
+      
+      if video_stream
+        @video_codec, @colorspace, resolution, video_bitrate = video_stream.split(/\s?,\s?/)
+        @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]
+        @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+) kb/s\Z) ? $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 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 if video_stream.nil? 
+      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_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,124 @@
+require 'open3'
+require 'shellwords'
+require 'ffmpeg/transcoders/autorotator'
+require 'ffmpeg/transcoders/scaler'
+
+module FFMPEG
+
+  # transcoder options:
+  # - preserve_aspect_ration: [:width|:height]
+  # - scale_and_enlarge: boolean, default: true 
+  # - autorotate: boolean
+  class Transcoder
+
+    include FFMPEG::Transcoders::Autorotator
+    include FFMPEG::Transcoders::Scaler
+
+    @@timeout = 200
+
+    def self.timeout=(time)
+      @@timeout = time
+    end
+
+    def self.timeout
+      @@timeout
+    end
+
+    def initialize(movie, output_file, options = EncodingOptions.new, transcoder_options = {:enlarge => true})
+      @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
+    
+    # ffmpeg <  0.8: frame=  413 fps= 48 q=31.0 size=    2139kB time=16.52 bitrate=1060.6kbits/s
+    # ffmpeg >= 0.8: frame= 4855 fps= 46 q=31.0 size=   45306kB time=00:02:42.28 bitrate=2287.0kbits/
+    def run
+      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 = ""
+      last_output = nil
+      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
+              elsif line =~ /time=(\d+.\d+)/ # ffmpeg 0.7 and below style
+                time = $1.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
+            if line =~ /Unsupported codec/
+              FFMPEG.logger.error "Failed encoding...\nCommand\n#{command}\nOutput\n#{output}\n"
+              raise "Failed encoding: #{line}"
+            end
+          end
+          
+          if @@timeout
+            stderr.each_with_timeout(wait_thr.pid, @@timeout, "r", &next_line)
+          else
+            stderr.each("r", &next_line)
+          end
+            
+        rescue Timeout::Error => e
+          FFMPEG.logger.error "Process hung...\nCommand\n#{command}\nOutput\n#{output}\n"
+          raise FFMPEG::Error, "Process hung. Full output: #{output}"
+        end
+      end
+
+      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 FFMPEG::Error, "Failed encoding.#{errors}Full output: #{output}"
+      end
+      
+      encoded
+    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
+
+    def apply_transcoder_options
+      apply_autorotate
+      changes_orientation = changes_orientation?
+      apply_preserve_aspect_ratio(changes_orientation)
+    end
+
+    def fix_encoding(output)
+      output[/test/]
+    rescue ArgumentError
+      output.force_encoding("ISO-8859-1")
+    end
+  end
+
+end

data/lib/ffmpeg/transcoders/autorotator.rb

@@ -0,0 +1,27 @@
+module FFMPEG
+  module Transcoders
+    module Autorotator
+      def apply_autorotate
+        return unless autorotate?
+        # remove the rotation information on the video stream so rotation-aware players don't rotate twice
+        @raw_options[:metadata] = 's:v:0 rotate=0'
+        filters = {
+          90  => 'transpose=1',
+          180 => 'hflip,vflip',
+          270 => 'transpose=2'
+        }
+        @raw_options[:video_filter] = filters[@movie.rotation]
+      end
+
+      # we need to know if orientation changes when we scale
+      def changes_orientation?
+        autorotate? && [90, 270].include?(@movie.rotation)
+      end
+
+      def autorotate?
+        @transcoder_options[:autorotate] && @movie.rotation && @movie.rotation != 0
+      end
+
+    end
+  end
+end

data/lib/ffmpeg/transcoders/scaler.rb

@@ -0,0 +1,74 @@
+module FFMPEG
+  module Transcoders
+    module Scaler
+      private
+
+        def preserve_aspect_ratio?
+          @movie.calculated_aspect_ratio && 
+          [:width, :height].include?(@transcoder_options[:preserve_aspect_ratio])
+        end
+        
+        # Scaling with autorotation 
+        #
+        # If scaled in conjuction with autorotation 
+        # and the rotation results in an orientation change
+        # we must "invert" the side that is preserved
+        # as scaling takes place prior to rotation
+        #
+        # Example: 
+        #
+        # Original: resolution => 640x480, rotation => 90 
+        # Requested: resolution => 660x2, preserved_aspect_ration => :width, autorotate => true
+        #
+        # => the orientation will change from landscape to portrait
+        # => we have to invert the preserved_aspect_ration => :height
+        #
+        # Expected Output: resolution => 660x880
+        #
+        # Required Encoding (ffmpeg version < 1.0, scales before rotating, not implemented): resolution => 880x660
+        # Required Encoding (ffmpeg version == 1.0, rotates before scaling, this implementation): resolution => 660x880
+        #
+        def apply_preserve_aspect_ratio(change_orientation=false)
+          return unless preserve_aspect_ratio?
+
+          side = @transcoder_options[:preserve_aspect_ratio]
+          size = @raw_options.send(side)
+          side = invert_side(side) if change_orientation            
+
+          if @transcoder_options[:enlarge] == false
+            original_size = @movie.send(side)
+            size = original_size if original_size < size
+          end
+
+          case side
+          when :width
+            new_height = size / @movie.calculated_aspect_ratio
+            new_height = evenize(new_height)
+            @raw_options[:resolution] = "#{size}x#{new_height}"
+          when :height
+            new_width = size * @movie.calculated_aspect_ratio
+            new_width = evenize(new_width)
+            @raw_options[:resolution] = "#{new_width}x#{size}"
+          end
+
+          invert_resolution if change_orientation 
+        end
+
+        def invert_side(side)
+          side == :height ? :width : :height
+        end
+
+        def invert_resolution
+          @raw_options[:resolution] = @raw_options[:resolution].split("x").reverse.join("x")
+        end
+        
+        # ffmpeg requires full, even numbers for its resolution string -- this method ensures that
+        def evenize(number)
+          number = number.ceil.even? ? number.ceil : number.floor
+          number.odd? ? number += 1 : number # needed if new_height ended up with no decimals in the first place
+        end
+
+    end
+  end
+end
+

data/lib/ffmpeg/version.rb

@@ -0,0 +1,3 @@
+module FFMPEG
+  VERSION = "0.9.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.nil? ? 'ffmpeg' : @ffmpeg_binary
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: brainsome_streamio-ffmpeg
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- David Backeus
+- Brainsome-Developers
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+description: Simple yet powerful wrapper around ffmpeg to get metadata from movies
+  and do transcoding.
+email:
+- david@streamio.se
+- 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ffmpeg/encoding_options.rb
+- lib/ffmpeg/errors.rb
+- lib/ffmpeg/io_monkey.rb
+- lib/ffmpeg/movie.rb
+- lib/ffmpeg/transcoder.rb
+- lib/ffmpeg/transcoders/autorotator.rb
+- lib/ffmpeg/transcoders/scaler.rb
+- lib/ffmpeg/version.rb
+- lib/streamio-ffmpeg.rb
+- README.md
+- LICENSE
+- CHANGELOG
+homepage: http://github.com/torial/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: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Reads metadata and transcodes movies.
+test_files: []