video_transcoding 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cc73a9cc2f744752ca69d781ba9dc91ba0c98b4a
-  data.tar.gz: 701979c5a46294e460f81ae71523f84e03964339
+  metadata.gz: 904cedcc3f672a942705af405ab944ed1fd8a69e
+  data.tar.gz: 682950abf5c67fa62680dacde2a065d1bd88d0c1
 SHA512:
-  metadata.gz: ad694a5a4863f258323f8055bee826b2622dc161ca96c087fc21ddbee6448c31a2bce8304215a6e43b8e50b2b0ebef3fee7c0d855e60c3508fd34f9e7f0f4676
-  data.tar.gz: aac9551f8d8f191d6012b553f877f377c8f102b218062e223bb0376d4b315dd633eb594ef8aef2925752c81cc6d0c198e35ce4af7dc13084043c4c2705d75046
+  metadata.gz: 6b4f1c5c66d22a5af7b34977c9bacb390613ce50367bd851b7747410b9a7bd1141c6609fee6cf5ebcbdb20ca1b74a275f7d36bf43b3038f0b7118d6cd17c9540
+  data.tar.gz: 38668e7971abb556ef149a7838ed93620ff2f1460dd1341a2550bc7e39014d2fbd5fe2c325e661b716b9385b0206a876fb979dc76743a58d481a7793d6fa75dd

data/README.md

@@ -84,31 +84,31 @@ When installing `HandBrakeCLI` or other downloaded programs, make sure the execu
 
 ### Why `transcode-video`?
 
-Videos from the [iTunes Store](https://en.wikipedia.org/wiki/ITunes_Store) are my template for a portable format while remaining high enough quality to be mistaken for the originals. Their files are very good quality, only about 20% the size of the same video on a Blu-ray Disc, and play on a wide variety of devices.
+Videos from the [iTunes Store](https://en.wikipedia.org/wiki/ITunes_Store) are my template for a portable format while remaining high enough quality to be mistaken for the originals. Their files are very good quality, much smaller than the same video on a Blu-ray Disc, and play on a wide variety of devices.
 
 HandBrake is a powerful video transcoding tool but it's complicated to configure. It has several presets but they aren't smart enough to automatically change bitrate targets and other encoding options based on different inputs. More importantly, HandBrake's default presets don't produce a predictable output size with sufficient quality.
 
 HandBrake's "AppleTV 3" preset is closest to what I want but transcoding "[Planet Terror (2007)](http://www.blu-ray.com/movies/Planet-Terror-Blu-ray/1248/)" with it results in a huge video bitrate of 19.9 Mbps, very near the original of 22.9 Mbps. And transcoding "[The Girl with the Dragon Tattoo (2011)](http://www.blu-ray.com/movies/The-Girl-with-the-Dragon-Tattoo-Blu-ray/35744/)," while much smaller in output size, lacks detail compared to the original.
 
-So, to follow the iTunes Store template, the `transcode-video` tool configures the [x264 video encoder](http://www.videolan.org/developers/x264.html) within HandBrake to use a [constrained variable bitrate (CVBR)](https://en.wikipedia.org/wiki/Variable_bitrate) mode, and to automatically target bitrates appropriate for different input resolutions.
+So, the `transcode-video` tool configures the [x264 video encoder](http://www.videolan.org/developers/x264.html) within HandBrake to use a [constrained variable bitrate (CVBR)](https://en.wikipedia.org/wiki/Variable_bitrate) mode, and to automatically target bitrates appropriate for different input resolutions.
 
 Input resolution | Target video bitrate
 --- | ---
-1080p or Blu-ray video | 5 Mbps
-720p | 4 Mbps
-480i, 576p or DVD video | 2 Mbps
+1080p or Blu-ray video | 8 Mbps
+720p | 6 Mbps
+480i, 576p or DVD video | 3 Mbps
 
-When audio transcoding is required, it's done in [AAC format](https://en.wikipedia.org/wiki/Advanced_Audio_Coding) and, if the original is [multi-channel surround sound](https://en.wikipedia.org/wiki/Surround_sound), in [Dolby Digital AC-3 format](https://en.wikipedia.org/wiki/Dolby_Digital). Meaning the output can contain two tracks from the same source in different formats. And mono, stereo and surround inputs are all handled differently.
+Actual output video bitrates are usually lower than these targets, especially for DVD video.
 
-Input channels | Pass through | AAC track | AC-3 track
---- | --- | --- | ---
-Mono | AAC only | 80 Kbps | none
-Stereo | AAC only | 160 Kbps | none
-Surround | AC-3 only, up to 448 Kbps | 160 Kbps | 384 Kbps with 5.1 channels
+When audio transcoding is required, it's done in [AAC format](https://en.wikipedia.org/wiki/Advanced_Audio_Coding) and, if the original is [multi-channel surround sound](https://en.wikipedia.org/wiki/Surround_sound), in [Dolby Digital AC-3 format](https://en.wikipedia.org/wiki/Dolby_Digital). Meaning the output can contain two tracks from the same source in different formats. And mono, stereo and surround inputs are all handled differently.
 
-Which makes the output of `transcode-video` very near the same size, quality and configuration as videos from the iTunes Store, including their audio tracks.
+Input channels | AAC track | AC-3 track
+--- | --- | ---
+Mono | 80 Kbps | none
+Stereo | 160 Kbps | none
+Surround | 160 Kbps | 640 Kbps with 5.1 channels
 
-But if the iTunes-style configuration is not suitable, most of these default settings and automatic behaviors can be easily overridden or augmented with additional command line options.
+But most of these default settings and automatic behaviors can be easily overridden or augmented with additional command line options.
 
 ### Why `detect-crop`?
 
@@ -194,31 +194,31 @@ To create MP4 output with the `.m4v` file extension instead of `.mp4`, use the `
 
 The `.m4v` file extension is more "iTunes-friendly," but the file content itself is exactly the same as a file with the `.mp4` extension.
 
-#### Improving quality
+#### Reducing output size
 
-If quality is more important to you than output size, use the `--big` option:
+If reducing output size is more important to you than quality, use the `--small` option:
 
-    transcode-video --big "/path/to/Movie.mkv"
+    transcode-video --small "/path/to/Movie.mkv"
 
-Video bitrate targets are raised 50-60% depending upon the video resolution of your input.
+Video bitrate targets are lowered 33-37% depending upon the video resolution of your input.
 
-Input resolution | Target video bitrate with `--big`
+Input resolution | Target video bitrate with `--small`
 --- | ---
-1080p or Blu-ray video | 8 Mbps
-720p | 6 Mbps
-480i, 576p or DVD video | 3 Mbps
+1080p or Blu-ray video | 5 Mbps
+720p | 4 Mbps
+480i, 576p or DVD video | 2 Mbps
 
-Dolby Digital AC-3 audio bitrate limits are raised 66% to their maximum allowed value. However, there's no impact on the bitrate of mono and stereo AAC audio tracks.
+Dolby Digital AC-3 audio bitrate limits are lowered 40%. However, there's no impact on the bitrate of mono and stereo AAC audio tracks.
 
-Input channels | Pass through<br />with `--big` | AAC track<br />with `--big` | AC-3 track<br />with `--big`
+Input channels | Pass through<br />with `--small` | AAC track<br />with `--small` | AC-3 track<br />with `--small`
 --- | --- | --- | ---
 Mono | AAC only | 80 Kbps | none
 Stereo | AAC only | 160 Kbps | none
-Surround | AC-3 only, up to 640 Kbps | 160 Kbps | 640 Kbps with 5.1 channels
+Surround | AC-3 only, up to 448 Kbps | 160 Kbps | 384 Kbps with 5.1 channels
 
-With `--big`, noisy video and complex surround audio have the most potential for perceptible quality improvements.
+This makes the output of `transcode-video` very near the same size as videos from the iTunes Store, including their audio tracks.
 
-Be aware that performance degrades 6-10% using the `--big` option due to more calculations being made and more bits being written to disk.
+With `--small`, noisy video and complex surround audio have the most potential for perceptible quality loss.
 
 #### Improving performance
 
@@ -226,14 +226,12 @@ If you're willing to trade some precision for a 45-50% increase in video encodin
 
     transcode-video --quick "/path/to/Movie.mkv"
 
-The precision loss is minor and, when combined with the `--big` option, may not even be perceptible:
-
-    transcode-video --big --quick "/path/to/Movie.mkv"
-
 The `--quick` option is also more than 15% speedier than the x264 video encoder's "fast" preset and it avoids the occasional quality loss problems of the "faster" and "veryfast" presets.
 
 Be aware that output files are slightly larger when using the `--quick` option since the loss of precision is also a loss of efficiency.
 
+Performance also improves slightly using the `--small` option due to fewer calculations being made and fewer bits being written to disk.
+
 #### Cropping
 
 No cropping is applied by default. Use the `--crop TOP:BOTTOM:LEFT:RIGHT` option and arguments to indicate the amount of black, non-content border to remove from the edges of your video.
@@ -479,7 +477,7 @@ Use the default settings whenever possible.
 
 Use the `--mp4` or `--m4v` options if your target player can't handle Matroska format.
 
-Use the `--big` option if you can't retain your original source rip or you just have plenty of storage space.
+Use the `--small` option if you're short on storage space or you want your files near the same size as those from the iTunes Store.
 
 Use the `--quick` option if you're in a hurry or you have a huge number of files to transcode.
 

data/bin/transcode-video

@@ -56,8 +56,9 @@ Output options:
     --dry-run       don't transcode, just show `HandBrakeCLI` command and exit
 
 Quality options:
-    --big           raise default limits for both video and AC-3 audio bitrates
-                      (always increases output size)
+    --small, --small-video
+                    lower default limits for both video and AC-3 audio bitrates
+                      or for video only, trading some quality for reduced size
     --quick         trade some precision for 45-50% increase in encoding speed
                       (more than 15% speedier than x264 encoder "fast" preset)
                       (avoids quality loss of "faster" and "veryfast" presets)
@@ -163,12 +164,9 @@ External subtitle options:
                       to previously burned, forced or added subtitle
                       (can be used multiple times)
 
-Alternate ratecontrol options:
-    --cvbr BITRATE  use Constrained VBR ratecontrol at target video bitrate
+Advanced options:
     --abr BITRATE   use modified ABR ratecontrol at average video bitrate
     --vbr QUALITY   use true VBR ratecontrol at constant video quality (0-51)
-
-Advanced options:
 -E, --encoder-option NAME=VALUE|_NAME
                     pass x264 video encoder option by name with value
                       or disable use of option by prefixing name with "_"
@@ -205,10 +203,10 @@ HERE
       @format                     = :mkv
       @log                        = true
       @dry_run                    = false
-      @vbv_maxrate_2160p          = 10000
-      @vbv_maxrate_1080p          = 5000
-      @vbv_maxrate_720p           = 4000
-      @vbv_maxrate_480p           = 2000
+      @vbv_maxrate_2160p          = 16000
+      @vbv_maxrate_1080p          = 8000
+      @vbv_maxrate_720p           = 6000
+      @vbv_maxrate_480p           = 3000
       @quick                      = false
       @crop                       = {:top => 0, :bottom => 0, :left => 0, :right => 0}
       @main_audio                 = nil
@@ -216,8 +214,8 @@ HERE
       @audio_name                 = {}
       @audio_language             = []
       @audio_width                = {:main => :double, :other => :stereo}
-      @ac3_bitrate                = 384
-      @pass_ac3_bitrate           = 448
+      @ac3_bitrate                = 640
+      @pass_ac3_bitrate           = 640
       @copy_audio                 = []
       @copy_audio_name            = []
       @burn_subtitle              = nil
@@ -231,9 +229,9 @@ HERE
       @srt_language               = {}
       @srt_encoding               = {}
       @srt_offset                 = {}
-      @cvbr_bitrate               = nil
       @abr_bitrate                = nil
       @vbr_quality                = nil
+      @cvbr_bitrate               = nil
       @encoder_options            = {}
       @disable_encoder_options    = []
       @handbrake_options          = {'encoder-preset' => 'medium', 'encoder-profile' => 'high'}
@@ -288,7 +286,24 @@ HERE
       opts.on('--no-log')             { @log = false }
       opts.on('--dry-run')            { @dry_run = true }
 
+      opts.on '--small' do
+        @vbv_maxrate_2160p  = 10000
+        @vbv_maxrate_1080p  = 5000
+        @vbv_maxrate_720p   = 4000
+        @vbv_maxrate_480p   = 2000
+        @ac3_bitrate        = 384
+        @pass_ac3_bitrate   = 448
+      end
+
+      opts.on '--small-video' do
+        @vbv_maxrate_2160p  = 10000
+        @vbv_maxrate_1080p  = 5000
+        @vbv_maxrate_720p   = 4000
+        @vbv_maxrate_480p   = 2000
+      end
+
       opts.on '--big' do
+        Console.warn 'Using deprecated option: --big'
         @vbv_maxrate_2160p  = 16000
         @vbv_maxrate_1080p  = 8000
         @vbv_maxrate_720p   = 6000
@@ -593,12 +608,6 @@ HERE
         @srt_offset[@srt_file.size - 1] = arg
       end
 
-      opts.on '--cvbr ARG', Integer do |arg|
-        @cvbr_bitrate = arg
-        @abr_bitrate = nil
-        @vbr_quality = nil
-      end
-
       opts.on '--abr ARG', Integer do |arg|
         @abr_bitrate = arg
         @cvbr_bitrate = nil
@@ -611,6 +620,13 @@ HERE
         @abr_bitrate = nil
       end
 
+      opts.on '--cvbr ARG', Integer do |arg|
+        Console.warn 'Using experimental option: --cvbr'
+        @cvbr_bitrate = arg
+        @abr_bitrate = nil
+        @vbr_quality = nil
+      end
+
       opts.on '-E', '--encoder-option ARG' do |arg|
         if arg =~ /^([a-z0-9][a-z0-9_-]+)=([^ :]+)$/
           @encoder_options[$1] = $2

data/lib/video_transcoding/version.rb

@@ -5,5 +5,5 @@
 #
 
 module VideoTranscoding
-  VERSION = '0.4.0'
+  VERSION = '0.5.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: video_transcoding
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Don Melton
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-01-12 00:00:00.000000000 Z
+date: 2016-01-15 00:00:00.000000000 Z
 dependencies: []
 description: |2
       Video Transcoding is a package of tools to transcode, inspect