flvtool2 1.0.6

data/CHANGELOG

@@ -0,0 +1,109 @@
+= Changelog FLVTool2 - Flash video manipulation
+
+== Version 1.0.6
+
+* FLVTool2 is now published also as a gem
+* fixed inspect at audio tags (thanks Andrew Wason)
+* updated exe generation to new exerb version (4.1.0)
+* small bugfix for mencoder encoded files causing a segmentation fault
+* Changed newline character of tags.xml file to \n
+
+== Version 1.0.5 RC6
+
+* Fixed bug, that prevented injection of custom metadata
+* Fixed several bugs, that would cause errors if flv-file has only audio tags (Ticket #7)
+
+== Version 1.0.4 RC5
+
+* Reorganized directory structure and namespaces
+* Implemented setup for linux OS
+* Made flvtool2 command systemwide available (Ticket #2)
+* Added rake tasks for svn tagging and rubyforge uploads
+* Added README and CHANGELOG
+* Moved version output to separate file to include in Rakefile
+* Recoded calling of before and after filters (Ticket #5)
+* Fixed that header type flag was not written (Ticket #3)
+* Added hasVideo, hasAudio, hasMetadata, hasCuePoints and hasKeyframes metadata
+
+== Version 1.0.3 RC4
+
+* Redesigned error handling
+* Introduced -a switch, that collapses cutted regions
+
+== Version 1.0.2 RC3
+
+* stream.log will now be overwritten if exists
+* Fixed that files without keyframes could not be updated
+* Fullfilled help screen
+
+== Version 1.0.1 RC2
+
+* Introduced l switch, that logs down infomation to stream.log while infile is read. Very handy for debugging!
+* 'pipe' is also recognized as a keyword for in or out pipes
+* Frame sequence calculations will now be cached, resulting in a much better performance.
+* Removed a bug that lets MiXML fail while reading multiline comments.
+* Windows pipes are broken. Linux pipes work as expected. Will fix that later.
+* Removed a bug, that is caused by one byte too long files, generated by ffmpeg.
+
+== Version 1.0.0 RC1
+
+* added cut command
+* added add command
+* redesigned command line option parsing
+* improved FLVStream
+* added cue point support (onCuePoint tags)
+* made Flash 8 compatible
+* added keyframes in onMetaTag
+* introduced command chaining
+* introduced pipes and redirects
+* improved debug command
+* added simulation mode
+* added Linux start script
+* added automatic exe generation and packaging in Rakefile
+* added version command
+
+== Version 0.18
+
+* made MetaTag read procedure more stable
+
+== Version 0.17
+
+* added -a switch, that prints out meta data even on files not converted to FLV 1.1 (-a means print out [a]ll files)
+* added -c switch, that makes FLVTool2 compatible to flashcom (currently only duration is computed like flashcom would)
+* changed the help screen a bit
+
+== Version 0.16
+
+* print command results are now in the same format, as the flash to_string method would produce
+* new meta-data-creator string
+* application does not shut down anymore, if an error occurs in batch processing
+* added lastkeyframetimestamp
+* added onLastSecond event
+* changed lasttimestamp unit to seconds
+* changed lastkeyframetimestamp unit to seconds
+* added debug command
+
+== Version 0.15
+
+* removed a bug, that removed first video frame, if a meta tag was inserted
+
+== Version 0.14
+
+* added print command (YAML and XML support)
+* made -n switch update files if metadatacreator is not FLVTool2
+* removed a bug, that occurs when input file was corrupt
+
+== Version 0.13
+
+* added -n switch, that only makes updates to FLV v1 files (wich have no meta tag yet or are not taged by FLVTool2)
+
+== Version 0.12
+
+* updated help screen using directories as in-files
+
+== Version 0.11
+
+* first release version
+
+
+

data/LICENSE

@@ -0,0 +1,24 @@
+FLVTool2 - Copyright (c) 2005 Norman Timmler (inlet media e.K., Hamburg, Germany)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. The name of the author may not be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README

@@ -0,0 +1,27 @@
+= FLVTool2 - Flash video manipulation
+
+== Download
+
+http://www.inlet-media.de/flvtool2
+
+== Installation
+
+Unix/Linux/BSD etc.:
+
+Execute following commands in directory of README file:
+
+ruby setup.rb config
+ruby setup.rb setup
+sudo ruby setup.rb install
+
+Windows:
+No installation needed.
+
+== Bug reports
+
+info@inlet-media.de
+
+== License
+
+See LICENSE file.
+

data/Rakefile

@@ -0,0 +1,76 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/gempackagetask'
+require File.dirname(__FILE__) + '/lib/flvtool2/version.rb'
+
+PKG_NAME      = 'flvtool2'
+PKG_VERSION   = FLVTool2.version
+PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION.downcase.gsub(/\s/, '_')}"
+PKG_DESTINATION = "../#{PKG_NAME}"
+RELEASE_NAME  = "REL #{PKG_VERSION}"
+RUBY_FORGE_PROJECT = PKG_NAME
+RUBY_FORGE_USER    = 'inlet'
+
+PKG_FILES = FileList[
+  '[a-zA-Z]*',
+  'bin/**/*', 
+  'examples/**/*',
+  'lib/**/*'
+] - [
+  'test',
+  'flvtool2.exe',
+  'pkg'
+]
+
+task :default => :all_packages
+task :windows => [:make_exe, :zip]
+task :all_packages => [:package, :windows]
+task :release => [:all_packages, :tag_svn, :rubyforge]
+
+task :make_exe do
+  `exerb flvtool2.exy`
+end
+
+task :zip => :make_exe do
+  files = %w{ flvtool2.exe LICENSE CHANGELOG README examples examples/tags.xml }
+  `zip pkg/#{PKG_FILE_NAME}.zip #{files.join(' ')} -x .svn`
+end
+
+task :tag_svn do
+  system("svn cp http://svn.inlet-media.de/svn/flvtool2/trunk http://svn.inlet-media.de/svn/flvtool2/tags/#{PKG_FILE_NAME} -m '* Tag release #{PKG_FILE_NAME}'")
+end
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.summary = 'Flash video (FLV) manipulation tool'
+  s.description = <<-EOF
+    FLVTool2 is a manipulation tool for Macromedia Flash Video files (FLV). It can calculate a lot of meta data, insert an onMetaData tag, cut FLV files, add cue points (onCuePoint), show the FLV structure and print meta data information in XML or YAML.
+  EOF
+
+  s.files = PKG_FILES.to_a.delete_if {|f| f.include?('.svn')}
+  s.require_path = 'lib'
+
+  s.bindir = 'bin'                               # Use these for applications.
+  s.executables = ['flvtool2']
+  s.default_executable = 'flvtool2'
+
+  s.author = "Norman Timmler"
+  s.email = "norman.timmler@inlet-media.de"
+  s.homepage = "http://www.inlet-media.de/flvtool2"
+  s.rubyforge_project = "flvtool2"
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+  pkg.need_zip = false
+  pkg.need_tar = true
+end
+
+desc "Publish the release files to RubyForge."
+task :rubyforge => [ :gem ] do
+  `rubyforge login`
+  system("rubyforge add_release #{PKG_NAME} #{PKG_NAME} 'REL #{PKG_VERSION}' pkg/#{PKG_NAME}-#{PKG_VERSION}.gem")
+  system("rubyforge add_release #{PKG_NAME} #{PKG_NAME} 'REL #{PKG_VERSION}' pkg/#{PKG_NAME}-#{PKG_VERSION}.tgz")
+  system("rubyforge add_release #{PKG_NAME} #{PKG_NAME} 'REL #{PKG_VERSION}' pkg/#{PKG_NAME}-#{PKG_VERSION}.zip -t i386")
+end

data/bin/flvtool2

@@ -0,0 +1,3 @@
+#! /usr/bin/env ruby
+require 'flvtool2'
+

data/examples/tags.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0"?>
+<tags>
+  <!-- an event cue point -->
+  <metatag event="onCuePoint">
+    <name>TestEvent1</name>
+    <timestamp>333</timestamp>
+    <parameters>
+      <speaker>Peter</speaker>
+      <says>Hello my Name is Peter.</says>
+    </parameters>
+    <type>event</type>
+  </metatag>
+
+  <!-- a navigation cue point -->
+  <metatag event="onCuePoint">
+    <name>TestEvent2</name>
+    <timestamp>1000</timestamp>
+    <parameters>
+      <index>1</index>
+      <title>Chapter 1</title>
+    </parameters>
+    <type>navigation</type>
+  </metatag>
+  
+  <!-- this cuepoint overwrites the previuos cue point, because of it's 
+  identical timestamps and the overwrite parameter was set -->
+   
+  <metatag event="onCuePoint" overwrite="true">
+    <name>TestEvent3</name>
+    <timestamp>1000</timestamp>
+    <parameters>
+      <index>1</index>
+      <title>Chapter 2</title>
+    </parameters>
+    <type>navigation</type>
+  </metatag>
+</tags>
+
+

data/flvtool2.exy

@@ -0,0 +1,22 @@
+general:
+  startup: flvtool2.rb
+  core: cui
+  kcode: none
+
+path:
+  - lib
+
+file:
+  flvtool2.rb:
+  flv.rb:
+  flv/amf_string_buffer.rb: 
+  flv/audio_tag.rb: 
+  flv/core_extensions.rb: 
+  flv/meta_tag.rb: 
+  flv/stream.rb: 
+  flv/tag.rb: 
+  flv/video_tag.rb: 
+  flvtool2/base.rb: 
+  flvtool2/version.rb: 
+  mixml.rb: 
+  miyaml.rb: 

data/lib/flv.rb

@@ -0,0 +1 @@
+require 'flv/stream'

data/lib/flv/amf_string_buffer.rb

@@ -0,0 +1,280 @@
+# Copyright (c) 2005 Norman Timmler (inlet media e.K., Hamburg, Germany)
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+# 3. The name of the author may not be used to endorse or promote products
+#    derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+class AMFStringBuffer
+  def initialize(str = nil)
+    @buffer = str || ''
+    @pos = 0
+  end
+  
+  def seek(pos)
+    @pos = pos
+  end
+  
+  def read(length)
+    raise EOFError if @pos + length > @buffer.length
+    rt = @buffer[@pos, length]
+    @pos += length
+    rt
+  end
+  
+  def readchar
+    read(1).unpack('C').first
+  end
+  
+  def write(str)
+    if @pos + str.length > @buffer.length
+      @buffer << ' ' * (@pos + str.length - @buffer.length)
+    end
+    @buffer[@pos, str.length] = str
+    @pos += str.length
+  end
+
+  def close
+  end
+  
+  def to_s
+    @buffer
+  end
+
+  def length
+    @buffer.length
+  end
+
+  def eof?
+    @pos == length
+  end
+
+  def pos
+    @pos
+  end
+  
+  def read__AMF_string
+    read(read__UI16)
+  end
+  
+  def read__AMF_double
+    num = read(8).unpack('G').first.to_f
+  end
+
+  def read__AMF_boolean
+    read__UI8 == 1
+  end
+  
+  def read__AMF_mixed_array
+    size = read__UI32 # is not used
+    hash = {}
+    while !eof?
+      key = read__AMF_string
+      break if key.empty? && (type = read__UI8) == 9
+      hash[key] = read__AMF_data(type)
+    end
+    hash
+  end
+
+  def read__AMF_object
+    object = Object.new
+    while !eof?
+      key = read__AMF_string
+      break if key.empty? && (type = read__UI8) == 9
+      object.instance_variable_set( eval(":@#{key}"), read__AMF_data(type) )
+    end
+    object
+  end
+
+  def read__AMF_array
+    size = read__UI32
+    array = []
+    (1..size).step do |pos|  
+      break if eof?
+      array << read__AMF_data
+    end
+    array
+  end
+  
+  def read__AMF_date
+    utc_time = Time.at((read__AMF_double / 1000).to_i)
+    utc_time + (read__SI16 * 60) - Time.now.gmtoff
+  end
+  
+  def read__AMF_data(type = nil)
+    type ||= read__UI8
+    value = case type.to_i
+    when  0
+      read__AMF_double
+    when  1
+      read__AMF_boolean
+    when  2
+      read__AMF_string
+    when  3
+      read__AMF_object
+    when  8
+      read__AMF_mixed_array
+    when 10
+      read__AMF_array
+    when 11
+      read__AMF_date
+    else
+    end
+    return value
+  end
+  
+  def write__AMF_string(str)
+    write__UI8 2
+    write__UI16 str.length
+    write str
+  end
+  
+  def write__AMF_double(value)
+    write__UI8 0
+    write [value].pack('G')
+  end
+
+  def write__AMF_boolean(value)
+    write__UI8 1
+    value = value ? 1 : 0
+    write [value].pack('C')
+  end
+  
+  def write__AMF_date(time)
+    write__UI8 11
+    write [(time.to_f * 1000.0)].pack('G')
+    write__SI16( (Time.now.gmtoff / 60).to_i ) 
+  end
+  
+  def write__AMF_data(object)
+    if object === true || object === false
+      write__AMF_boolean object
+    elsif object.kind_of? Numeric
+      write__AMF_double object
+    elsif object.kind_of? Time
+      write__AMF_date object
+    elsif object.kind_of? Hash
+      write__AMF_mixed_array object
+    elsif object.kind_of? String
+      write__AMF_string object
+    elsif object.kind_of? Array
+      write__AMF_array object
+    else
+      write__AMF_object object
+    end
+  end
+  
+  def write__AMF_key(key)
+    write__UI16 key.length
+    write key
+  end
+  
+  def write__AMF_mixed_array(hash)
+    write__UI8 8
+    write__UI32 hash.length # length will never be read
+    
+    hash.each_pair do |key, value|
+      write__AMF_key key
+      write__AMF_data value
+    end
+    
+    write__UI16 0
+    write__UI8 9
+  end
+
+  def write__AMF_array(array)
+    write__UI8 10
+    write__UI32 array.length
+    
+    array.each do |value|
+      write__AMF_data value
+    end
+  end
+
+  def write__AMF_object(object)
+    write__UI8 3
+    
+    object.instance_variables.each do |variable|
+      write__AMF_key variable.gsub('@', '')
+      write__AMF_data object.instance_variable_get( variable.intern )
+    end
+    
+    write__UI16 0
+    write__UI8 9
+  end
+  
+  # FIXME: This methods are copied from flv_stream.rb. Should get in here per
+  # include? or something like this.
+  def read__UI8
+    readchar
+  end
+  
+  def read__UI16
+    (readchar << 8) + readchar
+  end
+  
+  def read__UI24
+    (readchar << 16) + (readchar << 8) + readchar
+  end
+  
+  def read__UI32
+    (readchar << 24) + (readchar << 16) + (readchar << 8) + readchar
+  end
+  
+  def read__STRING(length)
+    read length
+  end
+    
+  def read__SI16
+    read(2).reverse.unpack('s').first.to_i
+  end
+  
+  def write__UI8(value)
+    write [value].pack('C')
+  end
+  
+  def write__UI16(value)
+    write [(value >> 8) & 0xff].pack('c')
+    write [value & 0xff].pack('c')
+  end
+
+  def write__UI24(value)
+    write [value >> 16].pack('c')
+    write [(value >> 8) & 0xff].pack('c')
+    write [value & 0xff].pack('c')
+  end
+  
+  def write__UI32(value)
+    write [value].pack('N')
+  end
+  
+  def write__SI16(value)
+    write [(value >> 8) & 0xff].pack('c')
+    write [value & 0xff].pack('c')
+  end
+
+  def write__STRING(string)
+    write string
+  end
+  alias_method :<<, :write__STRING
+  
+end
+