video_transcoding 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a80da681f701c9145241ab7427a34189885db02d
-  data.tar.gz: bb82f1a8edb1bb6ee6da02362146fa8cdbbf2b4f
+  metadata.gz: a766c53d54b741cc24e1d9ba31579667f8354ce1
+  data.tar.gz: d37b0b0730d5e7800aa7795f4a5caf90c84fbbcc
 SHA512:
-  metadata.gz: 587f0b77d7804f4a65a5aa1aee7c802cd34b5ea25248b5d78ab02b9c44efbdbaca6db6ccec57b770a6a81070b3799100e599364d03bb83d7f538798388de3f66
-  data.tar.gz: dcdb174cfdd6fe0f379169ca569195efc6df074315c4cc3b39253caf92311e71016d0ea44e3cf46fe98fac16bb8da5d24b4bca7ea9256dc5a4c379b1480901b7
+  metadata.gz: fffe7dc4bc59256425bb7fe704033f49fe4b733a49db896a6f1b5274a3e71f5deb85add04bf1976a51aa2f082f9fdd46561096d52c8931e0b9c1e3927ac8e791
+  data.tar.gz: d36bcf4a8ba96c4d7f17519c72af2fb3ea934e28ea8d46d94ed8f0ad3b445d7ba1624f26dfb550fe8aeb4194429a137d35faaa420f392a64211773512a2ff002

data/README.md

@@ -80,9 +80,9 @@ On macOS, `HandBrakeCLI` and all its other dependencies can be easily installed
 
 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. Or you could try installing into the [Windows Subsystem for Linux](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux) as described here:
+On Windows, it's best to follow one of the two methods, manually installing binaries or 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>
+<https://github.com/JMoVS/installing_video_transcoding_on_windows>
 
 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 macOS and Linux, that directory might be `/usr/local/bin`.
 
@@ -198,13 +198,11 @@ The `.m4v` file extension is more "iTunes-friendly," but the file content itself
 
 #### Improving performance
 
-If you're willing to trade some precision for a 45-50% increase in video encoding speed, use the `--quick` option:
+You can increase encoding speed by 70-80% with no easily perceptible loss in video quality by using the `--quick` option:
 
     transcode-video --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.
+The `--quick` option avoids the typical quality problems associated with the x264 video encoder's speed-based presets, especially as that speed increases.
 
 #### Cropping
 
@@ -612,7 +610,7 @@ Plus, I wouldn't use a GUI for these tasks. And it's a bad idea to develop softw
 
 [High Efficiency Video Coding](https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding) or H.265  is the likely successor to [H.264](https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC), which is the format currently output by `transcode-video`. HandBrake has supported H.265 ever since it included the [x265 video encoder](http://x265.org/).
 
-My ratecontrol system can't be applied with the current version of the x265 encoder in HandBrake because it doesn't allow access to `qpmax`, critical for maintaining quality in certain situations. I'll consider adding support once the [fix for `qpmax` support in x265](https://bitbucket.org/multicoreware/x265/issues/232/add-option-to-specify-qpmax) is available in an official HandBrake release.
+My ratecontrol system couldn't be applied with the x265 encoder in older versions of HandBrake because it didn't allow access to `qpmax`, critical for maintaining quality in certain situations. The latest version of HandBrake includes a new encoder which fixes that.
 
 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.
 
@@ -658,6 +656,19 @@ For a few problematic videos, I have to apply options like `--force-rate 23.976
 
 ## History
 
+### [0.16.0](https://github.com/donmelton/video_transcoding/releases/tag/0.16.0)
+
+Friday, January 20, 2017
+
+* Add a `--cvbr` option to `transcode-video`. This is essentially the same as the experimental option of the same name which was removed on February 25, 2016, but now it doesn't have a bitrate argument. It enables a _simple_ constrained variable bitrate (CVBR) ratecontrol system, less constrained the default, producing a more predictable output size while avoiding `VBV underflow` warnings. Use it with `--target big` for the best results.
+* Modify the `--abr` option in `transcode-video` to no longer use a bitrate argument. Instead, it relies on the `--target` option to control bitrate, just like the default ratecontrol system and the new `--cvbr` option. So, passing a bitrate argument is now an error. But you should consider using `--cvbr` instead of `--abr` anyway since the former is almost always higher quality.
+* Remove the deprecated `--no-constrain` option from `detect-crop` and the `--no-constrain-crop` option from `transcode-video`.
+* Modify `convert-video` to allow HEVC format video along with H.264.
+* Update the "README" document to:
+    * Revise and simplify the Windows installation instructions to point users at the fine work by [@samhutchins](https://github.com/samhutchins) and [@JMoVS](https://github.com/JMoVS) on documenting their two methods. Via [ #115](https://github.com/donmelton/video_transcoding/issues/115).
+    * Revise the "Using `transcode-video`" section to correct out-of-date performance data about the `--quick` option.
+    * Revise the H.265 answer in the "FAQ" section with up-to-date information about the x265 video encoder. Via [ #118](https://github.com/donmelton/video_transcoding/pull/118).
+
 ### [0.15.0](https://github.com/donmelton/video_transcoding/releases/tag/0.15.0)
 
 Sunday, January 15, 2017

data/bin/convert-video

@@ -74,7 +74,7 @@ HERE
       media = Media.new(path: arg, allow_directory: false)
       Console.debug media.info
       output = resolve_output(media)
-      fail "no H.264 format video track: #{arg}" unless media.info[:h264]
+      fail "no compatible video track: #{arg}" unless media.info[:h264] or media.info[:hevc]
       fail "no video stream: #{arg}" unless media.info.has_key? :stream
 
       if media.info[:mkv]

data/bin/detect-crop

@@ -55,11 +55,6 @@ HERE
       opts.on('--title ARG', Integer) { |arg| @title = arg }
       opts.on('--constrain')          { @constrain = true }
       opts.on('--values-only')        { @values_only = true }
-
-      opts.on '--no-constrain' do
-        Console.warn 'Using deprecated option: --no-constrain'
-        @constrain = false
-      end
     end
 
     def configure

data/bin/transcode-video

@@ -186,8 +186,11 @@ External subtitle options:
                       (can be used multiple times)
 
 Advanced options:
-    --abr BITRATE   use modified ABR ratecontrol at average video bitrate
-                      (more predictable size but lower quality than default)
+    --cvbr          use simple constrained variable bitrate (CVBR) ratecontrol
+                      (more predictable size while avoiding VBV underflows)
+                      (use with `--target big` for best results)
+    --abr           use modified average bitrate (ABR) ratecontrol
+                      (predictable size but lower quality than default)
     --vbr QUALITY   use true VBR ratecontrol at constant video quality (0-51)
                       (unpredictable size but useful for comparison to default)
 -E, --encoder-option NAME=VALUE|_NAME
@@ -226,10 +229,10 @@ HERE
       @format                     = :mkv
       @log                        = true
       @dry_run                    = false
-      @vbv_maxrate_2160p          = 12000
-      @vbv_maxrate_1080p          = 6000
-      @vbv_maxrate_720p           = 3000
-      @vbv_maxrate_480p           = 1500
+      @max_bitrate_2160p          = 12000
+      @max_bitrate_1080p          = 6000
+      @max_bitrate_720p           = 3000
+      @max_bitrate_480p           = 1500
       @quick                      = false
       @veryquick                  = false
       @crop                       = {:top => 0, :bottom => 0, :left => 0, :right => 0}
@@ -259,7 +262,8 @@ HERE
       @srt_language               = {}
       @srt_encoding               = {}
       @srt_offset                 = {}
-      @abr_bitrate                = nil
+      @use_cvbr                   = false
+      @use_abr                    = false
       @vbr_quality                = nil
       @encoder_options            = {}
       @disable_encoder_options    = []
@@ -318,27 +322,27 @@ HERE
       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
+          @max_bitrate_2160p  = 16000
+          @max_bitrate_1080p  = 8000
+          @max_bitrate_720p   = 4000
+          @max_bitrate_480p   = 2000
         when 'small'
-          @vbv_maxrate_2160p  = 8000
-          @vbv_maxrate_1080p  = 4000
-          @vbv_maxrate_720p   = 2000
-          @vbv_maxrate_480p   = 1000
+          @max_bitrate_2160p  = 8000
+          @max_bitrate_1080p  = 4000
+          @max_bitrate_720p   = 2000
+          @max_bitrate_480p   = 1000
         when /^([0-9]+p)=([1-9][0-9]*)$/
           bitrate = $2.to_i
 
           case $1
           when '2160p'
-            @vbv_maxrate_2160p = bitrate
+            @max_bitrate_2160p = bitrate
           when '1080p'
-            @vbv_maxrate_1080p = bitrate
+            @max_bitrate_1080p = bitrate
           when '720p'
-            @vbv_maxrate_720p = bitrate
+            @max_bitrate_720p = bitrate
           when '480p'
-            @vbv_maxrate_480p = bitrate
+            @max_bitrate_480p = bitrate
           else
             fail UsageError, "invalid target video bitrate resolution: #{$1}"
           end
@@ -346,12 +350,12 @@ HERE
           @target_bitrate = nil
         else
           unless arg =~ /^[1-9][0-9]*$/
-            fail UsageError, "invalid rate argument: #{arg}"
+            fail UsageError, "invalid bitrate argument: #{arg}"
           end
+
           @target_bitrate = arg.to_i
         end
 
-        @abr_bitrate = nil
         @vbr_quality = nil
       end
 
@@ -399,11 +403,6 @@ HERE
         @constrain_crop = true
       end
 
-      opts.on '--no-constrain-crop' do
-        Console.warn 'Using deprecated option: --no-constrain-crop'
-        @constrain_crop = false
-      end
-
       opts.on '--fallback-crop ARG' do |arg|
         @fallback_crop = case arg
         when 'handbrake', 'mplayer', 'none'
@@ -702,14 +701,22 @@ HERE
         @srt_offset[@srt_file.size - 1] = arg
       end
 
-      opts.on '--abr ARG', Integer do |arg|
-        @abr_bitrate = arg
+      opts.on '--cvbr' do
+        @use_cvbr = true
+        @use_abr = false
+        @vbr_quality = nil
+      end
+
+      opts.on '--abr' do
+        @use_abr = true
+        @use_cvbr = false
         @vbr_quality = nil
       end
 
       opts.on '--vbr ARG', Float do |arg|
         @vbr_quality = arg
-        @abr_bitrate = nil
+        @use_cvbr = false
+        @use_abr = false
       end
 
       opts.on '-E', '--encoder-option ARG' do |arg|
@@ -910,16 +917,16 @@ HERE
 
       if width > 1920 or height > 1080
         encoder_level = '5.1'
-        vbv_maxrate = @vbv_maxrate_2160p
+        max_bitrate = @max_bitrate_2160p
       elsif width > 1280 or height > 720
         encoder_level = '4.0'
-        vbv_maxrate = @vbv_maxrate_1080p
+        max_bitrate = @max_bitrate_1080p
       elsif width * height > 720 * 576
         encoder_level = '3.1'
-        vbv_maxrate = @vbv_maxrate_720p
+        max_bitrate = @max_bitrate_720p
       else
         encoder_level = '3.0'
-        vbv_maxrate = @vbv_maxrate_480p
+        max_bitrate = @max_bitrate_480p
       end
 
       case encoder
@@ -930,38 +937,37 @@ HERE
         handbrake_options['encoder-profile'] = 'main'
       end
 
-      if @abr_bitrate.nil? and @vbr_quality.nil?
-        handbrake_options['quality'] = '1'
-
+      if @vbr_quality.nil?
         if @target_bitrate.nil?
           unless media.info[:directory]
             bitrate = ((((media.info[:size] * 8) / media.info[:duration]) / 1000) / 1000) * 1000
 
-            if bitrate < vbv_maxrate
-              min_bitrate = vbv_maxrate / 2
+            if bitrate < max_bitrate
+              min_bitrate = max_bitrate / 2
 
               if bitrate < min_bitrate
-                vbv_maxrate = min_bitrate
+                max_bitrate = min_bitrate
               else
-                vbv_maxrate = bitrate
+                max_bitrate = bitrate
               end
             end
           end
         else
-          vbv_maxrate = @target_bitrate
+          max_bitrate = @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['crf-max']      = '25'
-        encoder_options['qpmax']        = '34'
-      else
-        unless @abr_bitrate.nil?
-          handbrake_options['vb'] = @abr_bitrate.to_s
-          encoder_options['qpmax'] = '34'
+        if @use_abr
+          handbrake_options['vb'] = max_bitrate.to_s
+        else
+          handbrake_options['quality'] = '1'
+          encoder_options['vbv-maxrate'] = max_bitrate.to_s
+          encoder_options['vbv-bufsize'] = (@encoder_options.fetch('vbv-maxrate', max_bitrate).to_i * 2).to_s
+          encoder_options['crf-max'] = @use_cvbr ? '30' : '25'
         end
 
-        handbrake_options['quality'] = @vbr_quality.to_s.gsub(/\.0+$/, '') unless @vbr_quality.nil?
+        encoder_options['qpmax'] = '34' unless @use_cvbr
+      else
+        handbrake_options['quality'] = @vbr_quality.to_s.gsub(/\.0+$/, '')
       end
 
       if  (@quick or @veryquick) and

data/lib/video_transcoding/media.rb

@@ -131,6 +131,7 @@ module VideoTranscoding
       end
 
       @info[:h264]    = false
+      @info[:hevc]    = false
       @info[:mpeg2]   = false
       audio_track     = 0
       subtitle_track  = 0
@@ -148,6 +149,8 @@ module VideoTranscoding
 
               if attributes =~ /^h264/
                 @info[:h264] = true
+              elsif attributes =~ /^hevc/
+                @info[:hevc] = true
               elsif attributes =~ /^mpeg2video/
                 @info[:mpeg2] = true
               end

data/lib/video_transcoding/version.rb

@@ -5,5 +5,5 @@
 #
 
 module VideoTranscoding
-  VERSION = '0.15.0'
+  VERSION = '0.16.0'
 end

metadata

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