apple-tv-converter 0.2.0 → 0.3.0

data/Gemfile

@@ -0,0 +1,11 @@
+source :rubygems
+
+gemspec
+
+gem 'streamio-ffmpeg', :path => File.expand_path(File.join(File.dirname(__FILE__)), 'gems', 'streamio-ffmpeg')
+gem 'language_list'
+gem 'imdb'
+
+group :development do
+  gem 'awesome_print'
+end

data/Gemfile.lock

@@ -0,0 +1,44 @@
+PATH
+  remote: .
+  specs:
+    apple-tv-converter (0.3.0)
+      imdb (~> 0.6.8)
+      language_list (~> 0.0.3)
+      streamio-ffmpeg (~> 0.9.0)
+
+PATH
+  remote: ./gems/streamio-ffmpeg
+  specs:
+    streamio-ffmpeg (0.9.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    awesome_print (1.1.0)
+    diff-lcs (1.1.3)
+    hpricot (0.8.6)
+    imdb (0.6.8)
+      hpricot (~> 0.8.4)
+    language_list (0.0.3)
+    rake (0.9.6)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+
+PLATFORMS
+  ruby
+  x86-mingw32
+
+DEPENDENCIES
+  apple-tv-converter!
+  awesome_print
+  imdb
+  language_list
+  rake (~> 0.9.2)
+  rspec (~> 2.7)
+  streamio-ffmpeg!

data/README.md

@@ -4,9 +4,8 @@ Command line utility to convert media to a format playable on the AppleTV. Suppo
 
 ## On Mac OSX
 
-- Uses [ffmpeg](http://ffmpeg.org) to encode video and audio
+- Uses [ffmpeg](http://ffmpeg.org) to encode video and audio, as well as extracting embedded subtitles
 - Uses [Subler](http://code.google.com/p/subler/)'s command line interface to add the subtitles and set the iTunes metadata tags 
-- Uses [MKVToolNix](http://www.bunkus.org/videotools/mkvtoolnix/) to extract the embedded subtitles from MKV files 
 
 # Command line usage
 
@@ -20,6 +19,8 @@ Usage: apple-tv-converter [options] [file]
     -l, --languages eng,por,...      Only keep audio and subtitles in the specified languages
     -d, --dir [DIRECTORY]            Process all files in DIRECTORY recursively
         --itunes                     Add processed file to iTunes library, if it isn't there yet
+        --imdb [ID]                  Gather data from IMDB (optionally specifying movie id. If an id isn't specified
+                                     the program looks for a file on the same directory, named <id>.imdb)
 
 Common options:
     -h, --help                       Show this message

data/gems/streamio-ffmpeg/CHANGELOG

@@ -0,0 +1,198 @@
+== HEAD
+
+Improvements:
+* Simpler implementation for timeouts.
+  Should be far less cpu and memory dependent (don't spawn a thread for every line of output)
+  Timeout spec now passes in Rubinius (using 1.9 mode)
+* Give helpful error message for windows users lacking the win32-process gem (thanks casoetan)
+* Add Movie#container (thanks vitalis)
+
+Changes:
+* Default timeout lowered to 30 seconds
+
+Bugs:
+* Avoid crash if asking for frame_rate of a video without video stream (thanks squidarth)
+* Fix crash when doing audio transcoding on ffmpeg >= 1.0.1 (thanks vitalis)
+
+Deprecations:
+* Removed support for Ruby 1.8
+* Removed support for ffmpeg 0.7
+
+Refactorings:
+* Quite a few, see commit history for details.
+
+== 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/gems/streamio-ffmpeg/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/gems/streamio-ffmpeg/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/gems/streamio-ffmpeg/README.md

@@ -0,0 +1,180 @@
+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
+
+Compatibility
+-------------
+
+### Ruby
+
+Only guaranteed to work with MRI Ruby 1.9.3 or later.
+Should work with rubinius head in 1.9 mode.
+Will not work in jruby until they fix: http://goo.gl/Z4UcX (should work in the upcoming 1.7.2)
+
+### ffmpeg
+
+The current gem is tested against ffmpeg 0.11.1. 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
+```
+
+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 30 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 = 10
+
+# Disable the timeout altogether
+Transcoder.timeout = false
+```
+
+
+Copyright
+---------
+
+Copyright (c) 2011 Streamio AB. See LICENSE for details.