rvideo 0.8.0

data/ENV

@@ -0,0 +1,100 @@
+RVideo is only as good as the tools it uses. To make the best use of RVideo, follow these instructions.
+
+1. First, install dependencies.
+
+wget http://www3.mplayerhq.hu/MPlayer/releases/codecs/all-20061022.tar.bz2 (Mencoder complete codec pack)
+wget http://easynews.dl.sourceforge.net/sourceforge/lame/lame-3.97.tar.gz (LAME mp3 encoder)
+a (Ogg)
+sudo gem install flvtool2 (flvtool2 flv packager)
+
+unzip...
+
+svn checkout svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg
+svn checkout svn://svn.mplayerhq.hu/mplayer/trunk mplayer
+
+-. Move mplayer codecs.
+
+sudo mkdir /usr/local/lib/codecs/
+mv essential-20061022/* /usr/local/lib/codecs/
+chmod -R 755 /usr/local/lib/codecs/
+
+3. Build
+add /usr/local/lib to /etc/ld.so.conf
+yum install libncurses-devel
+
+For most:
+./configure --enable-shared
+make
+sudo make install
+
+FAAC
+-- sudo yum install automake, autoconf, libtool, m4, gcc-c++
+sh bootstrap
+./configure
+make
+sudo make install
+
+FAAD
+(report of bugs - http://www.webhostingtalk.com/archive/index.php/t-565563.html and http://wiki.linuxfromscratch.org/blfs/wiki/faad2)
+
+sed -i 's/       /\t/' Makefile.am &&
+sed -i 's/NULL/0/' common/mp4v2/{mp4property.h,rtphint.h} &&
+sed -i '/dd(m/ s/^v/static v/' common/mp4ff/mp4ffint.h
+autoreconf -vif
+./configure && make && sudo make install
+(maybe add --mp4v2 to ./configure?)
+
+XVID
+wget http://downloads.xvid.org/downloads/xvidcore-1.1.3.tar.gz
+./configure etc. from within xvid/build/generic
+
+A52
+wget http://liba52.sourceforge.net/files/a52dec-0.7.4.tar.gz
+./configure etc.
+
+AMR
+???
+wget http://www.3gpp.org/ftp/Specs/archive/26_series/26.104/26104-700.zip
+wget http://www.3gpp.org/ftp/Specs/archive/26_series/26.204/26204-700.zip
+cd ffmpeg/libavcodec/
+mkdir amr_float
+mkdir amrwb_float
+cd amr_float
+unzip ../../../26104-700.zip
+unzip 26104-700_ANSI_C_source_code.zip
+cd ../amrwb_float/
+unzip ../../../26204-700.zip
+unzip 26204-700_ANSI-C_source_code.zip
+** not working. 
+
+X264
+svn co svn://svn.videolan.org/x264/trunk x264
+sudo yum install yasm # for mmx/sse - not sure if these are supported
+./configure --enable-pthread --enable-shared # error adding  --enable-mp4-output
+make && sudo make install
+
+FFMPEG
+./configure --enable-libmp3lame --enable-libogg --enable-libvorbis --enable-liba52 --enable-libxvid --enable-libfaac --enable-libfaad  --enable-libx264 --enable-xvid --enable-pp --enable-shared --enable-gpl
+
+Sources:
+http://vexxhost.com/blog/2007/03/03/installing-ffmpeg-ffmpeg-php-mplayer-mencoder-flv2tool-lame-mp3-encoder-libogg-%E2%80%93-the-easy-way/
+http://cihilt.com/book/export/html/49
+
+TODO
+wget http://downloads.xiph.org/releases/flac/flac-1.2.0.tar.gz (FLAC) *
+faac
+faad
+xvid
+x264
+mp4box
+wget http://downloads.xiph.org/releases/theora/libtheora-1.0alpha7.tar.bz2 (theora) *
+wget http://downloads.xiph.org/releases/vorbis/libvorbis-1.2.0.tar.gz (Vorbis) (Gives error - LD_LIBRARY_PATH something)
+
+liba52 dlopened           no
+libamr-nb support         no
+libamr-wb support         no
+libdc1394 support         no
+libfaad dlopened          no
+libgsm enabled            no
+libnut enabled            no
+libtheora enabled         no

data/ENV2

@@ -0,0 +1,129 @@
+adduser rvideo
+(add rvideo to sudoers)
+su - rvideo
+mkdir src
+cd src
+
+sudo apt-get update (necessary?)
+sudo apt-get install automake
+sudo apt-get install autoconf
+sudo apt-get install libtool
+sudo apt-get install m4
+sudo apt-get install g++ (gcc-c++ in fedora?) # not in OS X - xcode instead?
+sudo apt-get install yasm
+
+wget http://www3.mplayerhq.hu/MPlayer/releases/codecs/all-20061022.tar.bz2
+wget http://easynews.dl.sourceforge.net/sourceforge/lame/lame-3.97.tar.gz
+wget http://downloads.xiph.org/releases/ogg/libogg-1.1.3.tar.gz
+wget http://downloads.xvid.org/downloads/xvidcore-1.1.3.tar.gz
+wget http://liba52.sourceforge.net/files/a52dec-0.7.4.tar.gz
+wget http://downloads.sourceforge.net/faac/faac-1.25.tar.gz
+wget http://downloads.sourceforge.net/faac/faad2-2.5.tar.gz
+wget http://downloads.xiph.org/releases/theora/libtheora-1.0alpha7.tar.bz2
+wget http://downloads.xiph.org/releases/vorbis/libvorbis-1.2.0.tar.gz
+wget http://ftp.penguin.cz/pub/users/utx/amr/amrnb-7.0.0.0.tar.bz2
+wget http://ftp.penguin.cz/pub/users/utx/amr/amrwb-7.0.0.2.tar.bz2
+
+sudo gem install flvtool2
+
+svn checkout svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg
+svn co svn://svn.videolan.org/x264/trunk x264
+
+tar xzvf a52dec-0.7.4.tar.gz
+tar xzvf faac-1.25.tar.gz
+tar xzvf faad2-2.5.tar.gz
+tar xzvf lame-3.97.tar.gz
+tar xzvf xvidcore-1.1.3.tar.gz
+tar xzvf libogg-1.1.3.tar.gz
+tar xjvf all-20061022.tar.bz2
+tar xjvf libtheora-1.0alpha7.tar.bz2
+tar xjvf amrnb-7.0.0.0.tar.bz2
+tar xjvf amrwb-7.0.0.2.tar.bz2
+
+sudo mkdir /usr/local/lib/codecs
+sudo mv all-20061022/* /usr/local/lib/codecs
+sudo chmod -R 755 /usr/local/lib/codecs/
+
+echo /usr/local/lib >>/etc/ld.so.conf # not OS X
+sudo ldconfig -v # not OS X
+
+cd libogg-1.1.3
+./configure --enable-shared && make && sudo make install
+cd ..
+
+cd libvorbis-1.2.0
+./configure --enable-shared && make && sudo make install
+cd ..
+:3
+cd libtheora-1.0alpha7
+./configure --enable-shared && make && sudo make install
+cd ..
+
+cd faac
+# PATCH as described at http://research.m1stereo.tv/wiki/index.php/Build_video_enc_env#faac
+autoreconf -vif
+./configure --with-mp4v2 && make && sudo make install
+cd ..
+
+cd faad2
+
+# OS X - 
+# Patch as per darwinports version
+# Comment out #define HAS_LRINTF block in common.h (including lrintf method definition)
+
+# PATCH as described at (Linux) http://research.m1stereo.tv/wiki/index.php/Build_video_enc_env#faad2
+autoreconf -vif
+./configure && make && sudo make install
+cd ..
+
+cd xvidcore/build/generic
+# OS X (see http://rob.opendot.cl/index.php/useful-stuff/xvid-with-asm-on-os-x/)
+./configure --enable-macosx_module
+Edit build/generic/platform.inc and ADD the flags shown below:
+"-undefined suppress" to SPECIFIC_CFLAGS
+"-f macho -DPREFIX" to AFLAGS (so it reads AFLAGS="AFLAGS=-I$(<D)/ -f macho -DPREFIX")
+"-read_only_relocs suppress" to SPECIFIC_LDFLAGS
+
+# Linux
+./configure && make && sudo make install
+cd ../../..
+
+cd a52dec-0.7.4
+./configure --enable-shared=yes && make && sudo make install
+cd ..
+
+cd lame-3.97
+./configure && make && sudo make install
+cd ..
+
+cd x264
+./configure --enable-pthread && make && sudo make install
+cd ..
+
+cd amrnb-7.0.0.0/ 
+./configure && make && sudo make install
+cd ..
+
+cd amrwb-7.0.0.0/ 
+./configure && make && sudo make install
+cd ..
+
+cd ffmpeg
+# apply patch from http://research.m1stereo.tv/wiki/index.php/Build_video_enc_env - though use libfaad.c, not faad.c
+./configure --enable-libmp3lame --enable-libogg --enable-libvorbis --enable-liba52 --enable-libxvid --enable-libfaac --enable-libfaad  --enable-libx264 --enable-libxvid --enable-pp --enable-shared --enable-gpl --enable-libtheora --enable-libfaadbin --enable-liba52bin --enable-libamr_nb --enable-libamr_wb
+make && sudo make install
+cd ..
+
+
+NOT EXECUTED
+apt-get install libncurses-devel (names of yum packages)
+svn checkout svn://svn.mplayerhq.hu/mplayer/trunk mplayer
+twolame
+flac
+speex
+libdv
+libmad
+libmpeg2
+mpeg4ip
+
+http://graphics.cs.uni-sb.de/NMM/Download/external/nmm-1.0.0/external-libraries-optional/mpeg2dec-0.4.0b.tar.gz

data/History.txt

@@ -0,0 +1,3 @@
+== 0.8.0 2007-09-27
+
+* Major rewrite of RVideo.

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Jonathan Dahl and Slantwise Design
+
+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/Manifest.txt

@@ -0,0 +1,44 @@
+ENV
+ENV2
+History.txt
+License.txt
+Manifest.txt
+README.txt
+RULES
+Rakefile
+config/boot.rb
+lib/rvideo.rb
+lib/rvideo/errors.rb
+lib/rvideo/inspector.rb
+lib/rvideo/reporter.rb
+lib/rvideo/reporter/views/index.html.erb
+lib/rvideo/reporter/views/report.css
+lib/rvideo/reporter/views/report.html.erb
+lib/rvideo/reporter/views/report.js
+lib/rvideo/tools/abstract_tool.rb
+lib/rvideo/tools/ffmpeg.rb
+lib/rvideo/tools/flvtool2.rb
+lib/rvideo/transcoder.rb
+lib/rvideo/version.rb
+scripts/txt2html
+setup.rb
+spec/files/kites.mp4
+spec/fixtures/ffmpeg_builds.yml
+spec/fixtures/files.yml
+spec/fixtures/recipes.yml
+spec/integrations/files/files.yml
+spec/integrations/formats_spec.rb
+spec/integrations/inspection_spec.rb
+spec/integrations/recipes_spec.rb
+spec/integrations/rvideo_spec.rb
+spec/integrations/transcoding_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/units/abstract_tool_spec.rb
+spec/units/ffmpeg_spec.rb
+spec/units/flvtool2_spec.rb
+spec/units/inspector_spec.rb
+spec/units/transcoder_spec.rb
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js

data/README.txt

@@ -0,0 +1,91 @@
+RVideo
+
+RVideo allows you to inspect and process video files.
+
+
+Installation is a little involved. First, install the gem:
+
+  sudo gem install rvideo
+  
+Next, install ffmpeg and (possibly) other related libraries. This is
+documented elsewhere on the web, and can be a headache. If you are on OS X,
+the Darwinports build is reasonably good (though not perfect). Install with:
+
+  sudo port install ffmpeg
+
+Or, for a better build (recommended), add additional video- and audio-related
+libraries, like this:
+
+  sudo port install ffmpeg +lame +libogg +vorbis +faac +faad +xvid +x264 +a52
+  
+Most package management systems include a build of ffmpeg, but many include a
+poor build. So you may need to compile from scratch.
+
+If you want to create Flash Video files, also install flvtool2:
+
+  sudo gem install flvtool2
+
+Once ffmpeg and RVideo are installed, you're set. 
+
+To inspect a file, initialize an RVideo file inspector object. See the 
+documentation for details.
+
+A few examples:
+
+  file = RVideo::Inspector.new(:file => "#{APP_ROOT}/files/input.mp4")
+  
+  file = RVideo::Inspector.new(:raw_response => @existing_response)
+  
+  file = RVideo::Inspector.new(:file => "#{APP_ROOT}/files/input.mp4",
+                                :ffmpeg_binary => "#{APP_ROOT}/bin/ffmpeg")
+
+  file.fps        # "29.97"
+  file.duration   # "00:05:23.4"
+
+To transcode a video, initialize a Transcoder object.
+
+  transcoder = RVideo::Transcoder.new
+
+Then pass a command and valid options to the execute method
+
+  recipe = "ffmpeg -i $input_file$ -ar 22050 -ab 64 -f flv -r 29.97 -s"
+  recipe += " $resolution$ -y $output_file$"
+  recipe += "\nflvtool2 -U $output_file$"
+  begin
+    transcoder.execute(recipe, {:input_file => "/path/to/input.mp4",
+      :output_file => "/path/to/output.flv", :resolution => "640x360"})
+  rescue TranscoderError => e
+    puts "Unable to transcode file: #{e.class} - #{e.message}"
+  end
+
+If the job succeeds, you can access the metadata of the input and output
+files with:
+
+  transcoder.original     # RVideo::Inspector object
+  transcoder.processed    # RVideo::Inspector object
+
+If the transcoding succeeds, the file may still have problems. RVideo
+will populate an errors array if the duration of the processed video
+differs from the duration of the original video, or if the processed
+file is unreadable.
+
+Thanks to Peter Boling for early work on RVideo.
+
+Contribute to RVideo! If you want to help out, there are a few things you can 
+do.
+
+- Use, test, and submit bugs/patches
+- We need a RVideo::Tools::Mencoder class to add mencoder support.
+- Other tool classes would be great - On2, mp4box, Quicktime (?), etc.
+- Submit other fixes, features, optimizations, and refactorings
+
+If RVideo is useful to you, you may also be interested in RMovie, another Ruby
+video library. See http://rmovie.rubyforge.org/ for more.
+
+Finally, watch for Spinoza, a commercial video transcoder built by Slantwise 
+Design. Spinoza uses RVideo for its video processing, but adds file queuing,  
+distributed transcoding, a web-based transcoder dashboard, and more. See 
+http://spinoza.tv or http://slantwisedesign.com for more.
+
+Copyright (c) 2007 Jonathan Dahl and Slantwise Design. Released under the MIT 
+license.

data/RULES

@@ -0,0 +1,11 @@
+Collection of transcoding edge cases and rules
+------------------------
+
+* mpeg4 output errors out if frame rate is not supplied
+  
+  [mpeg4 @ 0x149e810]timebase not supported by mpeg 4 standard
+  Error while opening codec for output stream #0.0 - maybe incorrect parameters such as bit_rate, rate, width or height
+  
+  Solution: provide a frame rate with -r (any frame rate will do)
+  
+  

data/Rakefile

@@ -0,0 +1,163 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/contrib/rubyforgepublisher'
+require 'fileutils'
+require 'hoe'
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts 'To use rspec for testing you must install rspec gem:'
+  puts '$ sudo gem install rspec'
+  exit
+end
+
+include FileUtils
+require File.join(File.dirname(__FILE__), 'lib', 'rvideo', 'version')
+
+AUTHOR = 'Jonathan Dahl (Slantwise Design)'  # can also be an array of Authors
+EMAIL = "jon@slantwisedesign.com"
+DESCRIPTION = "Video transcoding library"
+GEM_NAME = 'rvideo' # what ppl will type to install your gem
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}"
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  @rubyforge_username ||= @config["username"]
+end
+
+RUBYFORGE_PROJECT = 'rvideo' # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+
+NAME = "rvideo"
+REV = nil 
+# UNCOMMENT IF REQUIRED: 
+# REV = `svn info`.each {|line| if line =~ /^Revision:/ then k,v = line.split(': '); break v.chomp; else next; end} rescue nil
+VERS = Rvideo::VERSION::STRING + (REV ? ".#{REV}" : "")
+CLEAN.include ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']
+RDOC_OPTS = ['--quiet', '--title', 'rvideo documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject { |x| Array(x).first == 'hoe' } 
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.author = AUTHOR 
+  p.description = DESCRIPTION
+  p.email = EMAIL
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= CLEAN  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+end
+
+CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\n\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+
+desc 'Generate website files'
+task :website_generate do
+  Dir['website/**/*.txt'].each do |txt|
+    sh %{ ruby scripts/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
+  end
+end
+
+desc 'Upload website files to rubyforge'
+task :website_upload do
+  host = "#{rubyforge_username}@rubyforge.org"
+  remote_dir = "/var/www/gforge-projects/#{PATH}/"
+  local_dir = 'website'
+  sh %{rsync -aCv #{local_dir}/ #{host}:#{remote_dir}}
+end
+
+desc 'Generate and upload website files'
+task :website => [:website_generate, :website_upload, :publish_docs]
+
+desc 'Release the website and new gem version'
+task :deploy => [:check_version, :website, :release] do
+  puts "Remember to create SVN tag:"
+  puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
+    "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
+  puts "Suggested comment:"
+  puts "Tagging release #{CHANGES}"
+end
+
+desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
+task :local_deploy => [:website_generate, :install_gem]
+
+task :check_version do
+  unless ENV['VERSION']
+    puts 'Must pass a VERSION=x.y.z release version'
+    exit
+  end
+  unless ENV['VERSION'] == VERS
+    puts "Please update your version.rb to match the release version, currently #{VERS}"
+    exit
+  end
+end
+
+#require 'rake'
+#require 'spec/rake/spectask'
+require File.dirname(__FILE__) + '/lib/rvideo'
+
+desc "Creates a HTML report using the recipes in report/recipes and files in report/input_files" 
+task(:report) do
+  require 'rvideo/reporter'
+  RVideo::Reporter.run
+end
+
+namespace :spec do
+  desc "Run Unit Specs"
+  Spec::Rake::SpecTask.new("units") do |t| 
+    t.spec_files = FileList['spec/units/**/*.rb']
+  end
+
+  desc "Run Integration Specs"
+  Spec::Rake::SpecTask.new("integrations") do |t| 
+    t.spec_files = FileList['spec/integrations/**/*.rb']
+  end
+end
+
+#desc "Process kites.mp4"
+#task(:transcode) do
+#  RVideo::Transcoder.logger = Logger.new(STDOUT)
+#  
+#  r = RVideo::Recipe.new
+#  r.load("#{FIXTURE_PATH}/recipes.yml")
+#  r.find(:simple_avi)
+#  transcoder = RVideo::Transcoder.new
+#  transcoder.execute(r.command, {:input_file => "#{TEST_FILE_PATH}/kites.mp4", :output_file => "#{TEMP_PATH}/kites-transcoded.avi", :resolution => "320x240"})
+#  puts transcoder.executed_commands.inspect
+#end
+