newbamboo-rvideo 0.9.6

data/CHANGELOG

@@ -0,0 +1,70 @@
+v0.9.6 IN PROGRESS, TODO: need more documentation of changes here, coming later..
+
+Major Enhancements:
+* Inspector#capture_frame behavior moved to new FrameCapturer class
+
+Minor Enhancements:
+* Inspector support for [VARIOUS NEW THINGS, TODO: itemize]
+
+
+v0.9.5 2008-09-09
+Note:
+* Moving hosting to GitHub.
+  http://github.com/zencoder/rvideo/tree
+
+2 major enhancements:
+* Large files, or some tools, would dump out so much output that it could run a server out of memory.
+  Changed the way that output is parsed.  Instead of pulling it all into memory, the log file is sent to 
+  disk, and then post-processed.
+* Added support for yamdi (http://yamdi.sourceforge.net/) for FLV metadata injection.  This is much faster 
+  than flvtool2 on huge files, and uses less memory as well.
+
+
+v0.9.4 2007-12-12
+
+3 major enhancements:
+* Changed transcoder interface. The preferred interface is now to pass the input file to RVideo::Transcoder.new. This allows you to create multiple output files from the same Transcoder object, and inspects the input file metadata before the job is transcoded.
+* Added screengrab functionality to the Inspector class. Fire up an inspector instance on a file, and you can take one or more screenshots through inspected_file.capture_frame("50%").
+* Added resolution/aspect support. Pass :width and :height parameters to a Transcoder instance, and include $resolution$ or $aspect_ratio$ in the recipe. 
+
+4 minor enhancements:
+* Remove old/unnecessary files and features
+* Three additional ffmpeg results: unsupported codec and no output streams
+* One additional flvtool2 result: empty input file
+* Check that input file exists earlier in the transcoding process
+
+
+v0.9.3 2007-10-30
+
+One minor enhancement:
+* Reraise all unhandled RVideo exceptions as TranscoderErrors
+
+
+v0.9.2 2007-10-30
+
+One minor bug fix:
+* Correctly parse invalid files, where duration and bitrate are N/A, but start: 0.000 is included
+
+
+v0.9.1 2007-10-11
+
+One major enhancement:
+* Added Mencoder support. (Andre Medeiros)
+
+Two minor enhancements: 
+* Added total_time method to RVideo::Transcoder instances.
+* Added another error condition for ffmpeg - codec not found.
+
+Two notes:
+* Tried and tested using open3 and open4 for command execution, but mencoder would unexpectedly hang with certain files when using these. Reverted these changes.
+* Mencoder has basic unit tests, but needs more tests. In particular, example output should be added for a variety of cases (especially failures and errors).
+
+
+v0.9.0 2007-09-27
+
+* Public RVideo release.
+
+
+v0.8.0 2007-09-27
+
+* RVideo rewrite.

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/LICENSE

@@ -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

@@ -0,0 +1,68 @@
+CHANGELOG
+config/boot.rb
+ENV
+ENV2
+lib/rvideo/errors.rb
+lib/rvideo/float.rb
+lib/rvideo/frame_capturer.rb
+lib/rvideo/inspector.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/reporter.rb
+lib/rvideo/string.rb
+lib/rvideo/tools/abstract_tool.rb
+lib/rvideo/tools/ffmpeg.rb
+lib/rvideo/tools/ffmpeg2theora.rb
+lib/rvideo/tools/flvtool2.rb
+lib/rvideo/tools/mencoder.rb
+lib/rvideo/tools/mp4box.rb
+lib/rvideo/tools/mp4creator.rb
+lib/rvideo/tools/mplayer.rb
+lib/rvideo/tools/qtfaststart.rb
+lib/rvideo/tools/yamdi.rb
+lib/rvideo/tools/segmenter.rb
+lib/rvideo/transcoder.rb
+lib/rvideo/version.rb
+lib/rvideo.rb
+LICENSE
+Manifest
+Rakefile
+README
+RULES
+rvideo.gemspec
+scripts/txt2html
+setup.rb
+spec/files/boat.avi
+spec/files/kites.mp4
+spec/fixtures/ffmpeg_builds.yml
+spec/fixtures/ffmpeg_results.yml
+spec/fixtures/files.yml
+spec/fixtures/recipes.yml
+spec/integrations/formats_spec.rb
+spec/integrations/frame_capturer_spec.rb
+spec/integrations/inspection_spec.rb
+spec/integrations/recipes_spec.rb
+spec/integrations/rvideo_spec.rb
+spec/integrations/transcoder_integration_spec.rb
+spec/integrations/transcoding_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/support.rb
+spec/units/abstract_tool_spec.rb
+spec/units/ffmpeg_spec.rb
+spec/units/flvtool2_spec.rb
+spec/units/frame_capturer_spec.rb
+spec/units/inspector_spec.rb
+spec/units/mencoder_spec.rb
+spec/units/mp4box_spec.rb
+spec/units/mp4creator_spec.rb
+spec/units/mplayer_spec.rb
+spec/units/qtfaststart_spec.rb
+spec/units/string_spec.rb
+spec/units/transcoder_spec.rb
+tasks/deployment.rake
+tasks/testing.rake
+tasks/transcoding.rake
+tasks/website.rake

data/README

@@ -0,0 +1,106 @@
+= 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.
+
+== Monitoring ffmpeg encoding progress
+
+Damien Tanner has ported across Jonathan Conway's work on reporting progress on ffmpeg. If you pass a block to your execute it will yield the encoding progress:
+
+  transcoder.execute(recipe, {:input_file => "/path/to/input.mp4",
+    :output_file => "/path/to/output.flv", :resolution => "640x360"}) do |progress|
+    puts "#{progress[:tool].tool_command}: #{progress[:progress]}%"
+  end
+
+Progress is only reported for the ffmpeg tool at present, in future hopefully we'll see support extended for more tools.
+
+There is also support for killing hung ffmpeg processes. We found that sometimes a bad file can cause ffmpeg to just stop processing but still sit there using 100% cpu. When monitoring the progress we spawn it off in a separate thread, and then monitor the progress in the main thread. If the ffmpeg process times out by not reporting progress for a specified amount of time, we kill it.
+
+==
+
+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 Zencoder, a commercial video transcoder built by Slantwise 
+Design. Zencoder uses RVideo for its video processing, but adds file queuing,  
+distributed transcoding, a web-based transcoder dashboard, and more. See 
+http://zencoder.tv or http://slantwisedesign.com for more.
+
+Copyright (c) 2007 Jonathan Dahl and Slantwise Design. Released under the MIT 
+license.