video_transcoding 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e1a2160cfa70551d7ab81f91c0e3cd683ac0b9bf
-  data.tar.gz: b1a56c9b2e5a5b5e2dec110828f7014ace48f217
+  metadata.gz: 87623b30297fe1ddbce3986414be06e26c569b60
+  data.tar.gz: 5676f1d6d2167969670e434ee920135ec04646f5
 SHA512:
-  metadata.gz: c7d9f359bacd4c0a44cebaf916da150921b26073f88d1dbe0a0b6b49c1a939c5e3d0fa5254f41e1a6596554ddab4ae9c35086b59d515f8ff9da91b32d1799f69
-  data.tar.gz: 41beec3d9fe83947cf35bc51c17db29e05054b8f82c91604ba221dacd4e3bb8f47d26499e47ca5dc094d2c5481f6c7f544cfba24098e2d85ee989fe7fd0b1873
+  metadata.gz: 560af874e2847c118be25ec00fd9ee9197a3c41c09960c89ead29084ec62775fdb0ab93911a4a34be52af2e9ce86182077ef998667a2178d20755064b1db6e86
+  data.tar.gz: 6caf5107757863ac5da7d91a76119473394cbe81f8be1c8b5e4da06d9466c6fd8b41303522afe1652423656e7ad510a729cea0c2101b68cad045cb2c7a88acbb

data/README.md

@@ -83,7 +83,9 @@ On OS X, the other dependencies can be easily installed via [Homebrew](http://br
 
 On Linux, package management systems vary so it's best consult the indexes for those systems. But there's a Homebrew port available called [Linuxbrew](http://linuxbrew.sh/) and it doesn't require root access.
 
-On Windows, it's best to search the Web for the appropriate binary or add-on package manager. The [VideoHelp](http://www.videohelp.com) and [Cygwin](https://cygwin.com/) sites are a good place to start.
+On Windows, it's best to search the Web for the appropriate binary or add-on package manager. The [VideoHelp](http://www.videohelp.com) and [Cygwin](https://cygwin.com/) sites are a good place to start. Or you could try installing into the [Windows Subsystem for Linux](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux) as described here:
+
+<https://gist.github.com/JMoVS/75f3c6b344648deef59bc761e5e5a0e6>
 
 When installing `HandBrakeCLI` or other downloaded programs, make sure the executable binary is in a directory listed in your `PATH` environment variable. On Unix-style systems like OS X and Linux, that directory might be `/usr/local/bin`.
 
@@ -101,9 +103,9 @@ So, the `transcode-video` tool configures the [x264 video encoder](http://www.vi
 
 Input resolution | Target video bitrate
 --- | ---
-1080p or Blu-ray video | 8000 Kbps
-720p | 4000 Kbps
-480i, 576p or DVD video | 2000 Kbps
+1080p or Blu-ray video | 6000 Kbps
+720p | 3000 Kbps
+480i, 576p or DVD video | 1500 Kbps
 
 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.
 
@@ -193,30 +195,6 @@ 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.
 
-#### Reducing output size
-
-If reducing output size is more important to you than a possible loss in quality, use the `--small` option:
-
-    transcode-video --small "/path/to/Movie.mkv"
-
-Video bitrate targets are lowered 33-37% depending upon the video resolution of your input.
-
-Input resolution | Target video bitrate with `--small`
---- | ---
-1080p or Blu-ray video | 5000 Kbps
-720p | 3000 Kbps
-480i, 576p or DVD video | 1600 Kbps
-
-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 `--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 448 Kbps | 160 Kbps | 384 Kbps with 5.1 channels
-
-With `--small`, noisy video and complex surround audio have the most potential for perceptible quality loss.
-
 #### Improving performance
 
 If you're willing to trade some precision for a 45-50% increase in video encoding speed, use the `--quick` option:
@@ -227,8 +205,6 @@ The `--quick` option is also more than 15% speedier than the x264 video encoder'
 
 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 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.
@@ -481,9 +457,9 @@ Preset name | Note
 `faster` | use with caution
 `fast` | good but you might want to use `--quick` instead
 `medium` | default
-`slow` | <!---->
-`slower` | <!---->
-`veryslow` | <!---->
+`slow` | &#8203;
+`slower` | &#8203;
+`veryslow` | &#8203;
 `placebo` | not recommended
 
 Presets faster than `medium` trade precision and compression efficiency for more speed. That tradeoff is acceptable for the `fast` preset. But you may notice occasional quality loss problems when using the `faster` or `veryfast` presets.
@@ -496,8 +472,6 @@ Use the default settings whenever possible.
 
 Use the `--mp4` or `--m4v` options if your target player can't handle Matroska format.
 
-Use the `--small` option if you want more space savings.
-
 Use the `--quick` option if you're in a hurry.
 
 Use `detect-crop` before transcoding to manually review and apply the best crop values.
@@ -599,8 +573,6 @@ My ratecontrol system can't be applied with the current version of the x265 enco
 
 But support also requires equivalent quality at a smaller size when using my rate control system. And performance is an issue. While speed continues to improve, the x265 encoder is still considerably slower than the current H.264 system.
 
-In the meantime, I recommend using the `--small` option to reduce output size. As a bonus, it's also faster.
-
 ### What about hardware-based video transcoding?
 
 Using hardware with [Intel Quick Sync Video](https://en.wikipedia.org/wiki/Intel_Quick_Sync_Video) instead of software like x264 is certainly faster. HandBrake even supports that hardware on some platforms. However, my default ratecontrol system can't be applied to existing hardware encoders because they lack API to change the necessary settings.
@@ -627,18 +599,34 @@ What I don't use are [peak signal-to-noise ratios](https://en.wikipedia.org/wiki
 
 I use the default settings. That's why they're the defaults.
 
-But sometimes I use the `--small` option for more space savings.
-
 I never use the `--crop detect` function of `transcode-video` because I don't trust either `HandBrakeCLI` or `mplayer` to always get it right without supervision. Instead, I use the separate `detect-crop` tool before transcoding to manually review and apply the best crop values.
 
 I let `transcode-video` automatically burn any forced subtitles into the output video track when the "forced" flag is enabled in the original.
 
 I never include separate subtitle tracks, but I do add audio commentary tracks.
 
-For a few problematic videos, I have to apply options like `--force-rate 23.976 --filter detelecine`. For others, options like `--encoder-option zones=...` to adjust bitrate distribution. But both of these cases are rare.
+For a few problematic videos, I have to apply options like `--force-rate 23.976 --filter detelecine`. But that's rare.
 
 ## History
 
+### [0.12.0](https://github.com/donmelton/video_transcoding/releases/tag/0.12.0)
+
+Friday, October 14, 2016
+
+* Revise the ratecontrol system and default target video bitrates in `transcode-video` so that output is smaller and transcoding is faster. Via [ #90](https://github.com/donmelton/video_transcoding/issues/90).
+    * Increase the value of `vbv-bufsize` to be twice that of `vbv-maxrate`, the target. This is much more likely to produce an output video bitrate nearer to that target.
+    * Lower the targets to accomodate this new accuracy and avoid wasting bitrate and time on unneeded quality.
+* Deprecate the `--small` and `--small-video` options in `transcode-video`.
+* Add a variation of the `--target` option with `big` and `small` arguments to `transcode-video`. The `small` macro provides output similar to, but still smaller than, the old `--small-video` option. The `big` macro provides output even larger than the old ratecontrol system and targets.
+* Remove unnecessary boundary checking of the target video bitrate in `transcode-video`.
+* Modify `transcode-video` so adding `--handbrake-option encoder=x265` is all that is needed to enable _experimental_ HEVC transcoding. Use this _only_ with `HandBrakeCLI` nightly builds from September 29, 2016, or later.
+* Update the "README" document to:
+    * Revise the default target video bitrates.
+    * Remove all references to the `--small` option since it's now deprecated.
+    * Add the Windows Subsystem for Linux as a possible installation platform. Via [ #89](https://github.com/donmelton/video_transcoding/pull/89) from [@JMoVS](https://github.com/JMoVS).
+    * Replace visible HTML comments with zero-width spaces.
+    * Tweak the description of how I use `transcode-video`. Yes, again.
+
 ### [0.11.1](https://github.com/donmelton/video_transcoding/releases/tag/0.11.1)
 
 Monday, September 26, 2016

data/bin/transcode-video

@@ -56,9 +56,15 @@ Output options:
     --dry-run       don't transcode, just show `HandBrakeCLI` command and exit
 
 Quality options:
-    --small         lower video bitrate target and AC-3 audio bitrate limits,
-                      trading some quality for reduced size
-    --small-video   lower video bitrate target only
+    --target big|small
+                    apply video bitrate target macro for all input resolutions
+                      (`big` trades some size for increased quality)
+                      (`small` trades some quality for reduced size)
+    --target [2160p=|1080p=|720p=|480p=]BITRATE
+                    set video bitrate target (default: based on input)
+                      or target for specific input resolution
+                      (can be exceeded to maintain video quality)
+                      (can be used multiple times)
     --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)
@@ -79,11 +85,6 @@ Video options:
     --pixel-aspect X:Y
                     set pixel aspect ratio (default: 1:1)
                       (e.g.: make X larger than Y to stretch horizontally)
-    --target [1080p=|720p=|480p=]BITRATE
-                    set video bitrate target (default: based on input)
-                      or target for specific input resolution
-                      (can be exceeded to maintain video quality)
-                      (can be used multiple times)
     --force-rate FPS
                     force constant video frame rate
                       (`23.976` applied automatically for some inputs)
@@ -219,10 +220,10 @@ HERE
       @format                     = :mkv
       @log                        = true
       @dry_run                    = false
-      @vbv_maxrate_2160p          = 16000
-      @vbv_maxrate_1080p          = 8000
-      @vbv_maxrate_720p           = 4000
-      @vbv_maxrate_480p           = 2000
+      @vbv_maxrate_2160p          = 12000
+      @vbv_maxrate_1080p          = 6000
+      @vbv_maxrate_720p           = 3000
+      @vbv_maxrate_480p           = 1500
       @quick                      = false
       @crop                       = {:top => 0, :bottom => 0, :left => 0, :right => 0}
       @constrain_crop             = false
@@ -254,7 +255,7 @@ HERE
       @vbr_quality                = nil
       @encoder_options            = {}
       @disable_encoder_options    = []
-      @handbrake_options          = {'encoder-preset' => 'medium', 'encoder-profile' => 'high'}
+      @handbrake_options          = {'encoder-preset' => 'medium'}
       @disable_handbrake_options  = []
       @temporary                  = nil
     end
@@ -306,21 +307,63 @@ HERE
       opts.on('--no-log')             { @log = false }
       opts.on('--dry-run')            { @dry_run = true }
 
+      opts.on '--target ARG' do |arg|
+        case arg
+        when 'big'
+          @vbv_maxrate_2160p  = 16000
+          @vbv_maxrate_1080p  = 8000
+          @vbv_maxrate_720p   = 4000
+          @vbv_maxrate_480p   = 2000
+        when 'small'
+          @vbv_maxrate_2160p  = 8000
+          @vbv_maxrate_1080p  = 4000
+          @vbv_maxrate_720p   = 2000
+          @vbv_maxrate_480p   = 1000
+        when /^([0-9]+p)=([1-9][0-9]*)$/
+          bitrate = $2.to_i
+
+          case $1
+          when '2160p'
+            @vbv_maxrate_2160p = bitrate
+          when '1080p'
+            @vbv_maxrate_1080p = bitrate
+          when '720p'
+            @vbv_maxrate_720p = bitrate
+          when '480p'
+            @vbv_maxrate_480p = bitrate
+          else
+            fail UsageError, "invalid target video bitrate resolution: #{$1}"
+          end
+
+          @target_bitrate = nil
+        else
+          unless arg =~ /^[1-9][0-9]*$/
+            fail UsageError, "invalid rate argument: #{arg}"
+          end
+          @target_bitrate = arg.to_i
+        end
+
+        @abr_bitrate = nil
+        @vbr_quality = nil
+      end
+
       opts.on '--small' do
-        @vbv_maxrate_2160p  = 10000
-        @vbv_maxrate_1080p  = 5000
-        @vbv_maxrate_720p   = 3000
-        @vbv_maxrate_480p   = 1600
+        Console.warn 'Using deprecated option: --small'
+        @vbv_maxrate_2160p  = 8000
+        @vbv_maxrate_1080p  = 4000
+        @vbv_maxrate_720p   = 2000
+        @vbv_maxrate_480p   = 1000
         @ac3_bitrate        = 384
         @pass_ac3_bitrate   = 448
         @target_bitrate     = nil
       end
 
       opts.on '--small-video' do
-        @vbv_maxrate_2160p  = 10000
-        @vbv_maxrate_1080p  = 5000
-        @vbv_maxrate_720p   = 3000
-        @vbv_maxrate_480p   = 1600
+        Console.warn 'Using deprecated option: --small-video'
+        @vbv_maxrate_2160p  = 8000
+        @vbv_maxrate_1080p  = 4000
+        @vbv_maxrate_720p   = 2000
+        @vbv_maxrate_480p   = 1000
         @target_bitrate     = nil
       end
 
@@ -403,35 +446,6 @@ HERE
         end
       end
 
-      opts.on '--target ARG' do |arg|
-        if arg =~ /^([0-9]+p)=([1-9][0-9]*)$/
-          bitrate = $2.to_i
-
-          case $1
-          when '2160p'
-            @vbv_maxrate_2160p = bitrate
-          when '1080p'
-            @vbv_maxrate_1080p = bitrate
-          when '720p'
-            @vbv_maxrate_720p = bitrate
-          when '480p'
-            @vbv_maxrate_480p = bitrate
-          else
-            fail UsageError, "invalid target video bitrate resolution: #{$1}"
-          end
-
-          @target_bitrate = nil
-        else
-          unless arg =~ /^[1-9][0-9]*$/
-            fail UsageError, "invalid rate argument: #{arg}"
-          end
-          @target_bitrate = arg.to_i
-        end
-
-        @abr_bitrate = nil
-        @vbr_quality = nil
-      end
-
       opts.on '--force-rate ARG' do |arg|
         unless arg =~ /^[1-9][0-9]*(?:\.[0-9]+)?$/
           fail UsageError, "invalid force rate argument: #{arg}"
@@ -860,19 +874,27 @@ HERE
       handbrake_options[anamorphic] = nil unless @handbrake_options.has_key? 'custom-anamorphic'
 
       if width > 1920 or height > 1080
-        handbrake_options['encoder-level'] = '5.1'
+        encoder_level = '5.1'
         vbv_maxrate = @vbv_maxrate_2160p
       elsif width > 1280 or height > 720
-        handbrake_options['encoder-level'] = '4.0'
+        encoder_level = '4.0'
         vbv_maxrate = @vbv_maxrate_1080p
       elsif width * height > 720 * 576
-        handbrake_options['encoder-level'] = '3.1'
+        encoder_level = '3.1'
         vbv_maxrate = @vbv_maxrate_720p
       else
-        handbrake_options['encoder-level'] = '3.0'
+        encoder_level = '3.0'
         vbv_maxrate = @vbv_maxrate_480p
       end
 
+      case @handbrake_options.fetch('encoder', 'x264')
+      when 'x264'
+        handbrake_options['encoder-profile'] = 'high'
+        handbrake_options['encoder-level'] = encoder_level
+      when 'x265'
+        handbrake_options['encoder-profile'] = 'main'
+      end
+
       if @abr_bitrate.nil? and @vbr_quality.nil?
         handbrake_options['quality'] = '1'
 
@@ -891,17 +913,11 @@ HERE
             end
           end
         else
-          if @target_bitrate < 2
-            vbv_maxrate = 2
-          elsif @target_bitrate > 300000
-            vbv_maxrate = 300000
-          else
-            vbv_maxrate = @target_bitrate
-          end
+          vbv_maxrate = @target_bitrate
         end
 
         encoder_options['vbv-maxrate']  = vbv_maxrate.to_s
-        encoder_options['vbv-bufsize']  = (@encoder_options.fetch('vbv-maxrate', vbv_maxrate).to_i / 2).to_s
+        encoder_options['vbv-bufsize']  = (@encoder_options.fetch('vbv-maxrate', vbv_maxrate).to_i * 2).to_s
         encoder_options['crf-max']      = '25'
         encoder_options['qpmax']        = '34'
       else

data/lib/video_transcoding/version.rb

@@ -5,5 +5,5 @@
 #
 
 module VideoTranscoding
-  VERSION = '0.11.1'
+  VERSION = '0.12.0'
 end

metadata

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