vcs_ruby 0.8.0

data/bin/vcs.rb

@@ -0,0 +1,145 @@
+#!/usr/bin/ruby
+
+# Video Contact Sheet Ruby: 
+# ----------------------
+#
+# Generates contact sheets of videos
+#
+# Prerequisites: Ruby, ImageMagick, ffmpeg/libav or mplayer
+#
+
+# Load library path for development
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), "../lib")
+
+require 'optparse'
+require 'vcs'
+require 'yaml'
+
+include VCSRuby
+
+
+# Configuration can Override options
+options = 
+{ 
+             quiet: false, 
+           verbose: false, 
+          capturer: :any,
+            format: nil,
+            output: []
+}
+
+# Command Line Parameter arguments
+
+arguments =
+{
+    '--capturer' => [:ffmpeg, :libav, :mplayer, :any],
+    '--format' => [:png, :jpg, :jpeg, :tiff],
+    '--funky' =>  [:polaroid, :photos, :overlap, :rotate, :photoframe, :polaroidframe, :film, :random]
+}  
+
+# Command Line Parameters
+optparse = OptionParser.new do|opts| 
+  opts.separator $vcs_ruby_name + ' ' + $vcs_ruby_version.to_s
+  opts.separator ''
+  opts.on( '-i [INTERVAL]', '--interval [INTERVAL]', 'Set the interval [INTERVAL]') do |interval|
+    options[:interval] = TimeIndex.new interval
+  end
+  opts.on( '-c [COLMNS]', '--columns [COLUMNS]', 'Arrange the output in <COLUMNS> columns.') do |columns|
+    options[:columns] = columns.to_i
+  end
+  opts.on( '-r [ROWS]', '--rows [ROWS]', 'Arrange the output in <ROWS> rows.') do |rows|
+    options[:rows] = rows.to_i
+  end
+  opts.on( '-H [HEIGHT]', '--height [HEIGHT]', 'Set the output (individual thumbnail) height.') do |height|
+    options[:height] = height.to_i
+  end
+  opts.on( '-W [WIDTH]', '--width [WIDTH]', 'Set the output (individual thumbnail) width.') do |width|
+    options[:width] = width.to_i
+  end
+  opts.on( '-A [ASPECT]', '--aspect [ASPECT]', 'Aspect ratio. Accepts a floating point number or a fraction.') do |aspect|
+    options[:aspect] = aspect.to_f
+  end
+  opts.on( '-f [FROM]', '--from [FROM]', 'Set starting time. No caps before this.') do |from|
+    options[:from] = TimeIndex.new from
+  end
+  opts.on( '-t [TO]', '--to [TO]', 'Set ending time. No caps beyond this.') do |to|
+    options[:to] = TimeIndex.new to
+  end
+  opts.on( '-T [TITLE]', '--title [TITLE]', 'Set ending time. No caps beyond this.') do |title|
+    options[:title] = title
+  end
+  opts.on( '-f [format]', '--format [FORMAT]', arguments['--format'], 'Formats: ' + Tools::list_arguments(arguments["--format"])) do |format|
+    options[:format] = format
+  end
+  opts.on('-C [CAPTURER]', '--capture [CAPTURER]', arguments['--capturer'], 'Capturer: ' + Tools::list_arguments(arguments["--capturer"])) do |capturer|
+    options[:capturer] = capturer
+  end
+  opts.on( '-T [TITLE]', '--title [TITLE]', 'Set ending time. No caps beyond this.') do |title|
+    options[:title] = title
+  end
+  opts.on( '-o [FILE]', '--output [FILE]', 'File name of output. When ommited will be derived from the input filename. Can be repeated for multiple files.') do |file|
+    options[:output] << file
+  end
+  opts.on( '-s [SIGNATURE]', '--signature [SIGNATURE]', 'Change the image signature to your preference.') do |signature|
+    options[:signature] = signature
+  end
+  opts.on( '--no-signature', 'Remove footer with signature') do 
+    options[:no_signature] = true
+  end
+  opts.on( '-l [HIGHLIGHT]', '--highlight [HIGHLIGHT]' 'Add the frame found at timestamp [HIGHLIGHT] as a highlight.') do |highlight|
+    options[:highlight] = TimeIndex.new highlight
+  end
+  opts.on( '-q', '--quiet', 'Don\'t print progress messages just errors. Repeat to mute completely, even on error.') do |file|
+    options[:quiet] = true
+  end
+  opts.on("-V", "--verbose", "More verbose Output.") do
+    options[:verbose] = true
+  end
+  opts.on( '-v', '--version', 'Version' ) do 
+    puts $vcs_ruby_name + ' ' + $vcs_ruby_version.to_s
+    exit 0 
+  end 
+  
+  opts.on( '-h', '--help', 'Prints help' ) do 
+    options[:help] = true
+  end 
+
+  opts.separator ''
+  opts.separator 'Examples:'
+  opts.separator '  Create a contact sheet with default values (4 x 4 matrix):'
+  opts.separator '  $ vcs video.avi'
+  opts.separator ''
+  opts.separator '  Create a sheet with vidcaps at intervals of 3 and a half minutes, save to'
+  opts.separator '  "output.jpg":'
+  opts.separator '  $ vcs -i 3m30 input.wmv -o output.jpg'
+  opts.separator ''
+  opts.separator '  Create a sheet with vidcaps starting at 3 mins and ending at 18 mins in 2m intervals'
+  opts.separator '  $ vcs --from 3m --to 18m -i 2m input.avi'
+  opts.separator ''
+  opts.separator '  See more examples at vcs-ruby homepage <https://github.com/FreeApophis/vcs.rb>.'
+  opts.separator ''
+end
+
+Tools::print_help optparse if ARGV.empty?
+  
+optparse.parse!
+
+puts options.inspect
+
+Tools::print_help optparse if options[:help] || ARGV.empty?
+
+Tools::verbose = options[:verbose]
+Tools::quiet = options[:quiet]
+
+# Invoke ContactSheet
+
+begin
+  ARGV.each_with_index do |video, index|
+    sheet = Tools::contact_sheet_with_options video, options
+    sheet.initialize_filename(options[:output][index]) if options[:output][index]
+    sheet.build
+  end
+rescue Exception => e
+  STDERR.puts "ERROR: #{e.message}"
+end
+

data/lib/capturer.rb

@@ -0,0 +1,35 @@
+#
+# Capturer Baseclass
+#
+
+module VCSRuby
+  class Capturer
+    def available?
+      false
+    end
+
+    def name
+      raise "NotImplmentedException"
+    end
+
+    def load_video
+      raise "NotImplmentedException"
+    end
+
+    def length
+      raise "NotImplmentedException"
+    end
+  
+    def width
+      raise "NotImplmentedException"
+    end
+  
+    def height
+      raise "NotImplmentedException"
+    end
+
+    def grab time
+      raise "NotImplmentedException"
+    end
+  end
+end

data/lib/command.rb

@@ -0,0 +1,37 @@
+#
+# Command
+#
+
+module VCSRuby
+  class Command
+    attr_reader :name, :available
+    def initialize name, command
+      @name = name
+      @command = which(command)
+      @available = !!@command
+    end
+
+    def execute parameter, streams = "2> /dev/null"
+      raise "Command '#{name}' not available" unless available
+
+      if Tools::windows?
+        `cmd /C #{@command} #{parameter}`
+      else
+        `#{@command} #{parameter} #{streams}`
+      end
+    end
+
+private
+    # http://stackoverflow.com/questions/2108727/which-in-ruby-checking-if-program-exists-in-path-from-ruby
+    def which cmd
+      exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+      ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+        exts.each do |ext|
+          exe = File.join(path, "#{cmd}#{ext}")
+          return exe if File.executable?(exe) && !File.directory?(exe)
+        end
+      end
+      return nil
+    end
+  end
+ end

data/lib/configuration.rb

@@ -0,0 +1,103 @@
+#
+# Configuration
+#
+
+require 'font'
+
+module VCSRuby
+  class Configuration
+    attr_accessor :capturer
+    attr_reader :header_font, :title_font, :timestamp_font, :signature_font
+
+    def initialize
+      default_config_file = File.expand_path("defaults.yml", File.dirname(__FILE__))
+      local_config_files = ['~/.vcs.rb.yml']
+
+      config = ::YAML::load_file(default_config_file)
+      local_config_files.select{ |f| File.exists?(f) }.each do |local_config_file|
+        puts "Local configuration file loaded: #{local_config_file}" if Tools.verbose?
+        local_config = YAML::load_file(local_config_file)
+        cconfig.merge(local_config)
+      end
+
+      @config = config
+
+      @header_font    = Font.new @config['style']['header']['font'],    @config['style']['header']['size']
+      @title_font     = Font.new @config['style']['title']['font'],     @config['style']['title']['size']
+      @timestamp_font = Font.new @config['style']['timestamp']['font'], @config['style']['timestamp']['size']
+      @signature_font = Font.new @config['style']['signature']['font'], @config['style']['signature']['size']
+    end
+
+    def rows
+      @config['main']['rows'] ? @config['main']['rows'].to_i : nil
+    end
+
+    def columns
+      @config['main']['columns'] ? @config['main']['columns'].to_i : nil
+    end
+
+    def interval
+      @config['main']['interval'] ? TimeIndex.new(@config['main']['interval']) : nil
+    end
+
+    def padding
+      @config['main']['padding'] ? @config['main']['padding'].to_i : 2
+    end
+
+    def quality
+      @config['main']['quality'] ? @config['main']['quality'].to_i : 90
+    end
+
+    def header_background
+      @config['style']['header']['background']
+    end
+
+    def header_color
+      @config['style']['header']['color']
+    end
+
+    def title_background
+      @config['style']['title']['background']
+    end
+
+    def title_color
+      @config['style']['title']['color']
+    end
+
+    def highlight_background
+      @config['style']['highlight']['background']
+    end
+
+    def contact_background
+      @config['style']['contact']['background']
+    end
+
+    def timestamp_background
+      @config['style']['timestamp']['background']
+    end
+
+    def timestamp_color
+      @config['style']['timestamp']['color']
+    end
+
+    def signature_background
+      @config['style']['signature']['background']
+    end
+
+    def signature_color
+      @config['style']['signature']['color']
+    end
+
+    def blank_threshold
+      @config['lowlevel']['blank_threshold'].to_f
+    end
+
+    def blank_evasion?
+      @config['lowlevel']['blank_evasion']
+    end
+
+    def blank_alternatives
+      @config['lowlevel']['blank_alternatives'].map{ |e| TimeIndex.new e.to_i }
+    end
+  end
+ end

data/lib/contact_sheet.rb

@@ -0,0 +1,341 @@
+#
+# Contact Sheet Composited from the Thumbnails
+#
+
+require 'fileutils'
+require 'tmpdir'
+require 'yaml'
+
+require 'vcs'
+
+module VCSRuby
+  class ContactSheet 
+    attr_accessor :capturer, :format, :signature, :title, :highlight
+    attr_reader :thumbnail_width, :thumbnail_height
+    attr_reader :length, :from, :to
+      
+    def initialize video, capturer = :any
+      @capturer = capturer
+      @configuration = Configuration.new
+      @signature = "Created by Video Contact Sheet Ruby"
+      initialize_capturers video
+      initialize_filename(File.basename(@video, '.*'))
+      puts "Processing #{File.basename(video)}..." unless Tools.quiet?
+      detect_video_properties
+      
+      @thumbnails = []
+
+      @tempdir = Dir.mktmpdir
+
+      ObjectSpace.define_finalizer(self, self.class.finalize(@tempdir) )
+
+      initialize_geometry(@configuration.rows, @configuration.columns, @configuration.interval)
+    end
+
+    def initialize_filename filename
+      @out_path = File.dirname(filename)
+      @out_filename = File.basename(filename,'.*')
+      ext = File.extname(filename).gsub('.', '')
+      if ['png', 'jpg', 'jpeg', 'tiff'].include?(ext)
+        @format ||= ext.to_sym
+      end
+    end
+
+    def filename
+      "#{@out_filename}.#{@format ? @format.to_s : 'png'}"
+    end
+
+    def full_path
+      File.join(@out_path, filename)
+    end
+
+    def initialize_geometry(rows, columns, interval)
+      @has_interval = !!interval
+      @rows = rows
+      @columns = columns
+      @interval = interval
+    end
+
+    def rows 
+      @rows
+    end
+
+    def columns
+      @columns
+    end
+
+    def interval
+      @interval || (@to - @from) / (number_of_caps + 1)
+    end
+
+    def number_of_caps
+      if @has_interval
+        (@to - @from) / @interval
+      else
+        if @rows && @columns
+          @rows * @columns
+        else
+          raise "you need at least 2 parameters from columns, rows and interval"
+        end
+      end
+    end
+
+    def thumbnail_width= width
+      @thumbnail_height = (width.to_f / @thumbnail_width * thumbnail_height).to_i
+      @thumbnail_width = width
+    end
+
+    def thumbnail_height= height
+      @thumbnail_width = (height.to_f / @thumbnail_height * thumbnail_width).to_i
+      @thumbnail_height = height
+    end
+
+    def from= time
+      if (TimeIndex.new(0) < time) && (time < to) && (time < @length)
+        @from = time
+      else
+        raise "Invalid From Time"
+      end
+    end
+
+    def to= time
+      if (TimeIndex.new(0) < time) && (from < time) && (time < @length)
+        @to = time
+      else
+        raise "Invalid To Time"
+      end
+    end
+ 
+
+    def self.finalize(tempdir)
+      proc do
+        puts "Cleaning up..." unless Tools.quiet?
+        FileUtils.rm_r tempdir
+      end
+    end
+
+    def build
+      initialize_thumbnails
+      capture_thumbnails
+      
+      puts "Composing standard contact sheet..." unless Tools.quiet?
+      s = splice_montage(montage_thumbs)
+
+      image = MiniMagick::Image.open(s)
+
+      puts "Adding header and footer..." unless Tools.quiet?
+      final = add_header_and_footer image
+
+      puts "Done. Output wrote to '#{filename}'" unless Tools.quiet?
+      FileUtils.mv(final, full_path)
+    end
+
+
+private
+    def selected_capturer
+      result = nil
+      if @capturer == nil || @capturer == :any
+        result = @capturers.first
+      else
+        result =  @capturers.select{ |c| c.name == @capturer }.first
+      end
+      raise "Selected Capturer (#{@capturer.to_s}) not available" unless result
+      return result
+    end
+
+    def initialize_capturers video
+      capturers = []
+      capturers << LibAV.new(video)
+      capturers << MPlayer.new(video)
+      capturers << FFmpeg.new(video)
+
+      @video = video
+      @capturers = capturers.select{ |c| c.available? }
+
+      puts "Available capturers: #{@capturers.map{ |c| c.to_s }.join(', ')}" if Tools.verbose?
+    end
+
+    def initialize_thumbnails
+      time = @from
+      (1..number_of_caps).each do |i|
+        thumb = Thumbnail.new selected_capturer, @video, @configuration
+
+        thumb.width = thumbnail_width
+        thumb.height = thumbnail_height
+        thumb.time = (time += interval)
+        thumb.image_path = File::join(@tempdir, "th#{"%03d" % i}.png")
+
+        @thumbnails << thumb
+      end
+    end
+
+    def capture_thumbnails
+      puts "Capturing in range [#{from}..#{to}]. Total length: #{@length}" unless Tools.quiet?
+
+      @thumbnails.each_with_index do |thumbnail, i|
+        puts "Generating capture ##{i + 1}/#{number_of_caps} #{thumbnail.time}..." unless Tools::quiet?
+        if @configuration.blank_evasion?
+          thumbnail.capture_and_evade interval
+        else
+          thumbnail.capture
+        end
+        thumbnail.apply_filters
+      end
+    end
+
+    def detect_video_properties
+      detect_length
+      detect_dimensions
+    end
+
+    def detect_length
+      @length = selected_capturer.length
+
+      @from = TimeIndex.new 0.0
+      @to = @length
+    end
+
+    def detect_dimensions
+      @thumbnail_width = selected_capturer.width
+      @thumbnail_height = selected_capturer.height
+    end
+
+    def montage_thumbs
+      file_path = File::join(@tempdir, 'montage.png')
+      MiniMagick::Tool::Montage.new do |montage|
+        montage.background @configuration.contact_background
+        @thumbnails.each do |thumbnail|
+          montage << thumbnail.image_path
+        end
+        montage.geometry "+#{@configuration.padding}+#{@configuration.padding}"
+        # rows or columns can be nil (auto fit)
+        montage.tile "#{@columns}x#{@rows}" 
+        montage << file_path
+      end
+      return file_path
+    end
+
+    def splice_montage montage_path
+      file_path = File::join(@tempdir, 'spliced.png')
+      MiniMagick::Tool::Convert.new do |convert|
+        convert << montage_path
+        convert.background @configuration.contact_background
+        convert.splice '5x10'      
+        convert << file_path
+      end    
+      file_path
+     end
+
+    def create_title montage
+      file_path = File::join(@tempdir, 'title.png')
+      MiniMagick::Tool::Convert.new do |convert|
+        convert.stack do |ul|
+          ul.size "#{montage.width}x#{@configuration.title_font.line_height}"
+          ul.xc @configuration.title_background
+          ul.font @configuration.title_font.path
+          ul.pointsize @configuration.title_font.size
+          ul.background @configuration.title_background
+          ul.fill @configuration.title_color
+          ul.gravity 'Center'
+          ul.annotate(0, @title)
+        end
+        convert.flatten
+        convert << file_path
+      end
+      return file_path
+    end
+
+    def create_highlight montage
+      puts "Generating highlight..."
+      thumb = Thumbnail.new selected_capturer, @video, @configuration
+
+      thumb.width = thumbnail_width
+      thumb.height = thumbnail_height
+      thumb.time = @highlight
+      thumb.image_path = File::join(@tempdir, "highlight_thumb.png")
+      thumb.capture
+      thumb.apply_filters
+
+      file_path =  File::join(@tempdir, "highlight.png")
+      MiniMagick::Tool::Convert.new do |convert|
+        convert.stack do |a|
+          a.size "#{montage.width}x#{thumbnail_height+20}"
+          a.xc @configuration.highlight_background
+          a.gravity 'Center'
+          a << thumb.image_path
+          a.composite
+        end
+        convert.stack do |a|
+          a.size "#{montage.width}x1"
+          a.xc 'Black'
+        end
+        convert.append
+        convert << file_path
+      end
+
+      file_path
+    end
+
+    def add_header_and_footer montage
+      file_path = File::join(@tempdir, filename)
+      header_height = @configuration.header_font.line_height * 3
+      signature_height = @configuration.signature_font.line_height + 8
+      MiniMagick::Tool::Convert.new do |convert|
+        convert.stack do |a|
+          a.size "#{montage.width - 18}x1"
+          a.xc @configuration.header_background
+          a.size.+
+          a.font @configuration.header_font.path
+          a.pointsize @configuration.header_font.size
+          a.background @configuration.header_background
+          a.fill 'Black'
+          a.stack do |b|
+            b.gravity 'West'
+            b.stack do |c|
+              c.label 'Filename: '
+              c.font  @configuration.header_font.path
+              c.label File.basename(@video)
+              c.append.+
+            end
+            b.font @configuration.header_font.path
+            b.label "File size: #{Tools.to_human_size(File.size(@video))}"
+            b.label "Length: #{@length.to_timestamp}"
+            b.append
+            b.crop "#{montage.width}x#{header_height}+0+0"
+          end
+          a.append
+          a.stack do |b|
+            b.size "#{montage.width}x#{header_height}"
+            b.gravity 'East'
+            b.fill @configuration.header_color
+            b.annotate '+0-1'
+            b << "Dimensions: #{selected_capturer.width}x#{selected_capturer.height}\nFormat: #{selected_capturer.video_codec} / #{selected_capturer.audio_codec}\nFPS: #{"%.02f" % selected_capturer.fps}"
+          end
+          a.bordercolor @configuration.header_background
+          a.border 9
+        end
+        convert << create_title(montage) if @title
+        convert << create_highlight(montage) if @highlight
+        convert << montage.path
+        convert.append
+        if @signature
+          convert.stack do |a|
+            a.size "#{montage.width}x#{signature_height}"
+            a.gravity 'Center'
+            a.xc @configuration.signature_background
+            a.font @configuration.signature_font.path
+            a.pointsize @configuration.signature_font.size
+            a.fill @configuration.signature_color
+            a.annotate(0, @signature)
+          end
+          convert.append
+        end
+        if format == :jpg || format == :jpeg
+          convert.quality(@configuration.quality)
+        end
+        convert << file_path
+      end
+      file_path
+    end
+  end
+end

data/lib/defaults.yml

@@ -0,0 +1,35 @@
+main:
+  rows: 4
+  columns: 4 
+  interval: ~
+  padding: 2
+  quality: 95
+style:
+  header:
+    font: DejaVu-Sans-Book
+    size: 14
+    color: Black
+    background: "#afcd7a"
+  title:
+    font: DejaVu-Sans-Book
+    size: 33
+    color: Black
+    background: White
+  highlight:
+    background: LightGoldenRod 
+  contact:
+    background: White
+  timestamp:
+    font: DejaVu-Sans-Book
+    size: 14
+    color: White
+    background: "#000000aa"
+  signature:
+    font: DejaVu-Sans-Book
+    size: 10
+    color: Black
+    background: SlateGray
+lowlevel:
+  blank_evasion: true
+  blank_threshold: 0.10
+  blank_alternatives: [ -5, 5, -10, 10, -30, 30]

data/lib/ffmpeg.rb

@@ -0,0 +1,25 @@
+#
+# FFmpeg Abstraction
+#
+
+require 'command'
+require 'capturer'
+
+module VCSRuby
+  class FFmpeg < Capturer
+    def initialize video
+      @video = video
+      @command = Command.new :ffmpeg, 'ffmpeg'
+    end
+
+    def name
+      :ffmpeg
+    end
+
+    def length
+      info = @command.execute("-i #{@video} -dframes 0 -vframes 0 /dev/null", "2>&1")
+      match = /Duration: ([\d|:|.]*)/.match(info)
+      return TimeIndex.new match[1]
+    end
+  end
+end

data/lib/font.rb

@@ -0,0 +1,31 @@
+#
+# Font helper
+#
+
+require 'mini_magick'
+
+module VCSRuby
+  class Font
+    attr_reader :name, :path, :size
+
+    def initialize name, size
+      @name = name
+      @path = find_path
+      @size = size
+    end
+
+    def find_path
+      '/usr/share/fonts/truetype/ttf-dejavu/DejaVuSans.ttf'
+    end
+
+    def line_height
+      MiniMagick::Tool::Convert.new do |convert|
+        convert.font path
+        convert.pointsize size
+        convert << 'label:F'
+        convert.format '%h'
+        convert << 'info:'
+      end.to_i
+    end
+  end
+end

data/lib/libav.rb

@@ -0,0 +1,144 @@
+#
+# FFmpeg Abstraction
+#
+
+require 'capturer'
+require 'command'
+require 'time_index'
+
+module VCSRuby
+  class LibAV < Capturer
+
+    CODEC = 2
+    DIMENSION = 4
+    FPS = 6
+
+    def initialize video
+      @video = video
+      @avconv = Command.new :libav, 'avconv'
+      @avprobe = Command.new :libav, 'avprobe'
+      detect_version
+    end
+
+    def name
+      :libav
+    end
+
+    def available?
+      @avconv.available && @avprobe.available
+    end
+
+    def detect_version
+      info = @avconv.execute("-version")
+      match = /avconv ([\d|.|-|:]*)/.match(info)
+      @version = match[1]
+    end
+
+    def length
+      load_probe
+      match = /Duration: ([\d|:|.]*)/.match(@cache)
+      return TimeIndex.new match[1]
+    end
+
+    def width
+      load_probe
+      @width
+    end
+
+    def height
+      load_probe
+      @height
+    end
+
+    def par
+      load_probe
+      @par
+    end
+
+    def dar
+      load_probe
+      @dar
+    end
+
+    def fps
+      load_probe
+      @fps
+    end
+
+    def video_codec
+      load_probe
+
+      @video_codec
+    end
+
+    def audio_codec
+      load_probe
+
+      @audio_codec
+    end
+
+    def grab time, image_path
+      @avconv.execute "-y -ss #{time.total_seconds} -i '#{@video}' -an -dframes 1 -vframes 1 -vcodec png -f rawvideo '#{image_path}'"
+    end
+
+    def to_s
+      "LibAV #{@version}"
+    end
+
+private
+    def load_probe
+      return if @cache
+
+      @cache = @avprobe.execute("'#{@video}'", "2>&1")
+      puts @cache if Tools.verbose?
+
+      parse_video_streams
+      parse_audio_streams
+    end
+
+    def parse_video_streams
+      video_stream = split_stream_line(is_stream?(@cache, /Video/).first)
+
+      dimensions = /(\d*)x(\d*) \[PAR (\d*:\d*) DAR (\d*:\d*)\]/.match(video_stream[DIMENSION])
+    
+      if dimensions
+        @par = dimensions[3]
+        @dar = dimensions[4]
+      else
+        dimensions = /(\d*)x(\d*)/.match(video_stream[DIMENSION])
+      end
+
+      if dimensions
+        @width = dimensions[1].to_i
+        @height = dimensions[2].to_i
+      end
+
+      fps = /([\d|.]+) fps/.match(video_stream[FPS])
+      @fps = fps ? fps[1].to_f : 0.0
+
+      @video_codec = video_stream[CODEC]
+    end
+
+    def parse_audio_streams
+      audio_stream = split_stream_line(is_stream?(@cache, /Audio/).first)
+
+      @audio_codec = audio_stream[CODEC]
+    end
+
+    def is_stream? probe, regex
+      streams(probe).select{ |s| s =~ regex }
+    end
+
+    def streams probe
+      @cache.split(/\r?\n/).map(&:strip).select{|l| l.start_with? 'Stream' }
+    end
+
+    def split_stream_line line
+      parts = line.split(',')
+      stream = parts.shift
+      result = stream.split(':')
+      result += parts
+      return result.map(&:strip)
+    end
+  end
+end

data/lib/mplayer.rb

@@ -0,0 +1,19 @@
+#
+# MPlayer Abstraction
+#
+
+require 'command'
+require 'capturer'
+
+module VCSRuby
+  class MPlayer < Capturer
+    def initialize video
+      @video = video
+      @command = Command.new :mplayer, 'mplayer'
+    end
+
+    def name
+      :mplayer
+    end
+  end
+end

data/lib/thumbnail.rb

@@ -0,0 +1,105 @@
+#
+# Thumbnails from video
+#
+
+require 'mini_magick'
+
+module VCSRuby
+  class Thumbnail
+    attr_accessor :width, :height, :aspect
+    attr_accessor :image_path
+    attr_accessor :time
+
+    def initialize capper, video, configuration
+      @capper = capper
+      @video = video
+      @configuration = configuration
+
+      @filters = [method(:resize_filter), method(:timestamp_filter), method(:softshadow_filter)]
+    end
+
+    def capture 
+      @capper.grab @time, @image_path
+    end
+
+    def capture_and_evade interval
+      times = [TimeIndex.new] + @configuration.blank_alternatives
+      times.select! { |t| (t < interval / 2) and (t > interval / -2) }
+      times.map! { |t| @time + t }
+
+      times.each do |time|
+        @time = time
+        capture
+        break unless blank?
+        puts "Blank frame detected. => #{@time}" unless Tools::quiet?
+        puts "Giving up!" if time == times.last && !Tools::quiet?
+      end
+    end
+
+    def blank?
+      image = MiniMagick::Image.open @image_path
+      image.colorspace 'Gray'
+      mean = image['%[fx:image.mean]'].to_f
+      return mean < @configuration.blank_threshold
+    end
+
+    def apply_filters
+      MiniMagick::Tool::Convert.new do |convert|
+        convert.background 'Transparent'
+        convert.fill 'Transparent'
+        convert << @image_path
+        @filters.each do |filter|
+          filter.call(convert)
+        end
+        convert << @image_path
+      end
+    end
+
+private
+    def resize_filter convert
+      convert.resize "#{width}x#{height}!"
+    end
+
+    def timestamp_filter convert
+      convert.stack do |box|
+        box.box @configuration.timestamp_background
+        box.fill  @configuration.timestamp_color
+        box.pointsize @configuration.timestamp_font.size
+        box.gravity 'SouthEast'
+        box.font @configuration.timestamp_font.path
+        box.annotate('+10+10', " #{@time.to_timestamp} ")
+      end
+      convert.flatten
+      convert.gravity 'None'
+    end
+
+    def photoframe_filter convert
+      convert.bordercolor 'White'
+      convert.border 3
+      convert.bordercolor 'Grey60'
+      convert.border 1
+    end
+
+    def softshadow_filter convert
+      convert.stack do |box|
+        box.background 'Black'
+        box.clone.+
+        box.shadow '50x2+4+4'
+        box.background 'None'
+      end
+      convert.swap.+
+      convert.flatten
+      convert.trim
+      convert.repage.+
+    end
+
+    def polaroid_filter
+    end
+
+    def random_rotation_filter
+    end
+
+    def film_filter
+    end
+  end
+end

data/lib/time_index.rb

@@ -0,0 +1,121 @@
+#
+# Time interval
+#
+
+module VCSRuby
+  class TimeIndex
+    include Comparable
+    attr_reader :total_seconds
+
+    def initialize time_index = ''
+      if time_index.instance_of? Float or time_index.instance_of? Fixnum
+        @total_seconds = time_index
+      else
+        @total_seconds = 0.0 
+        @to_parse = time_index.strip
+
+        unless @to_parse.empty?
+          try_parse_ffmpeg_index
+          try_parse_vcs_index
+          try_parse_as_number
+        end
+      end
+    end
+
+    def try_parse_ffmpeg_index
+      parts = @to_parse.split(':')
+      if parts.count == 3
+        @total_seconds += parts[0].to_i * 60 * 60
+        @total_seconds += parts[1].to_i * 60
+        @total_seconds += parts[2].to_f
+      end
+    end
+
+    def try_parse_vcs_index
+      if @to_parse =~ /\d*m|\d*h|\d*s/
+        parts = @to_parse.split(/(\d*h)|(\d*m)|(\d*s)/).select{|e| !e.empty?}
+        parts.each do |part|
+          add_vcs_part part
+        end
+      end
+    end
+
+    def add_vcs_part part
+      return @total_seconds += part.to_i * 60 * 60 if part.end_with? 'h'
+      return @total_seconds += part.to_i * 60 if part.end_with? 'm'
+      @total_seconds += part.to_i
+    end
+
+    def try_parse_as_number
+      temp = @to_parse.to_i
+      if temp.to_s == @to_parse
+        @total_seconds += temp
+      end
+    end
+
+    def total_seconds
+      @total_seconds
+    end
+
+    def hours
+      (@total_seconds.abs / 3600).to_i
+    end
+
+    def minutes
+      ((@total_seconds.abs / 60) % 60).to_i
+    end
+
+    def seconds
+      @total_seconds.abs % 60
+    end
+
+    def + operand
+      if operand.instance_of? Fixnum
+        TimeIndex.new @total_seconds + operand
+      else
+        TimeIndex.new @total_seconds + operand.total_seconds
+      end
+    end
+
+    def - operand
+      if operand.instance_of? Fixnum
+        TimeIndex.new @total_seconds - operand
+      else
+        TimeIndex.new @total_seconds - operand.total_seconds
+      end
+    end
+
+    def * operand
+      TimeIndex.new total_seconds * operand
+    end
+
+    def / operand
+      if operand.instance_of? Fixnum
+        TimeIndex.new @total_seconds / operand
+      else
+        @total_seconds / operand.total_seconds
+      end
+    end
+
+    def <=> operand
+      @total_seconds <=> operand.total_seconds
+    end
+
+    def sign
+      return '-' if @total_seconds < 0
+      ''
+    end
+
+    def to_s
+      "#{sign}#{hours}h#{"%02d" % minutes}m#{"%02d" % seconds}s"
+    end
+
+    def to_timestamp
+      if hours == 0
+        "#{sign}#{"%02d" % minutes}:#{"%02d" % seconds}"
+      else
+        "#{sign}#{hours}:#{"%02d" % minutes}:#{"%02d" % seconds}"
+      end
+    end
+  end
+end

data/lib/tools.rb

@@ -0,0 +1,67 @@
+#
+# Dependencies
+#
+
+module VCSRuby
+  class Tools
+    def self.windows?
+      false
+    end
+
+    def self.verbose= verbose
+      @verbose = verbose
+      @quiet = false if @verbose
+    end
+
+    def self.verbose?
+      @verbose
+    end
+
+    def self.quiet= quiet
+      @quiet = quiet
+      @verbose = false if @quiet
+    end
+
+    def self.quiet?
+      @quiet
+    end
+
+    def self.list_arguments arguments
+      arguments.map{ |argument| argument.to_s }.join(', ')
+    end
+
+    def self.print_help optparse
+      puts optparse.summarize
+      exit 0
+    end
+
+    def self.contact_sheet_with_options video, options
+      sheet = VCSRuby::ContactSheet.new video, options[:capturer]
+      sheet.format = options[:format] if options[:format]
+      sheet.title = options[:title] if options[:title]
+      sheet.signature = options[:signature] if options[:signature]
+      sheet.signature = nil if options[:no_signature]
+
+      if options[:rows] || options[:columns] || options[:interval]
+        sheet.initialize_geometry(options[:rows], options[:columns], options[:interval])
+      end
+
+      sheet.thumbnail_width = options[:width] if options[:width]
+      sheet.thumbnail_height = options[:height] if options[:height]
+      sheet.from = options[:from] if options[:from]
+      sheet.to = options[:to] if options[:to]
+      sheet.highlight = options[:highlight] if options[:highlight]
+
+      return sheet
+    end
+
+    def self.to_human_size size
+      powers = { 'B'  => 1 << 10, 'KiB' => 1 << 20, 'MiB' => 1 << 30, 'GiB' => 1 << 40, 'TiB' => 1 << 50 }
+      powers.each_pair do |prefix, power| 
+        if size < power
+          return format('%.2f',size.to_f / (power >> 10)) + ' ' + prefix
+        end
+      end
+    end
+  end
+end

data/lib/vcs.rb

@@ -0,0 +1,14 @@
+#
+# Video Contact Sheet Ruby
+#
+
+require 'command'
+require 'configuration'
+require 'contact_sheet'
+require 'ffmpeg'	
+require 'libav'	
+require 'mplayer'
+require 'thumbnail'
+require 'time_index'
+require 'tools'
+require 'version'

data/lib/version.info

@@ -0,0 +1 @@
+0.8.1

data/lib/version.rb

@@ -0,0 +1,25 @@
+#
+# Version of vcs.rb
+#
+
+module VCSRuby
+  def self.version_path
+    File.expand_path("version.info", File.dirname(__FILE__))
+  end
+
+  def self.read_version
+    File.open(version_path, &:readline)
+  end
+
+  def self.update_version
+    parts = File.open(version_path, &:readline).split('.').map(&:strip)
+    parts[2] = (parts[2].to_i + 1).to_s
+    File.open(version_path, 'w') {|f| f.write(parts.join('.')) }
+
+    $vcs_ruby_version
+  end
+end
+
+$vcs_ruby_version = Gem::Version.new(VCSRuby::read_version)
+$vcs_ruby_name = 'Video Contact Sheet Ruby'
+$vcs_ruby_short = 'vcr.rb'

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: vcs_ruby
+version: !ruby/object:Gem::Version
+  version: 0.8.0
+  prerelease: 
+platform: ruby
+authors:
+- Thomas Bruderer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minimagick
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Creates a contact sheet of a video, usable as library or as a script.
+  Based on VCS *NIX
+email: apophis@apophis.ch
+executables:
+- vcs.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/time_index.rb
+- lib/font.rb
+- lib/tools.rb
+- lib/mplayer.rb
+- lib/thumbnail.rb
+- lib/contact_sheet.rb
+- lib/ffmpeg.rb
+- lib/version.rb
+- lib/libav.rb
+- lib/capturer.rb
+- lib/version.info
+- lib/vcs.rb
+- lib/command.rb
+- lib/configuration.rb
+- lib/defaults.yml
+- bin/vcs.rb
+homepage: https://github.com/FreeApophis/vcs.rb
+licenses:
+- GPL3
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.8.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- libav or ffmpeg or mplayer
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Generates contact sheets of videos
+test_files: []