transcode 1.0.6 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f440499f81a31db9e875f0cddc6dc09287eab75d505d467385274a903ee77504
-  data.tar.gz: 40097203d275461d347bf4f137553e34ccd0f9cb64376a0d6f6d7f488fe5aec2
+  metadata.gz: 31614466613fcca1314cfdba740f375f534fc2f2496e97849dfa7708eb2439f8
+  data.tar.gz: 062fc1cdb39ea866cfb4f16769f4f2cd0e0db7c997112b77d9eb86eaafe85efd
 SHA512:
-  metadata.gz: 1a00be08b5cd28da92fc2314d3ce707552fbf0e55f096c139c7d7c41a95d8429e959b82cdcbebf293d40ff04fb42d255379bfd5f105bc68adefdb52094ef0aa6
-  data.tar.gz: b8d823e3aa6c74c3deb877d001fce5e569c890dfd17b3272e0214f4b2c3609e04f6b50667e4e53727f62a4c9b98fd3f91b02e0dd5095ea8ca49d6e8573b1932d
+  metadata.gz: 949aa013995bfc786523ff0c13a0077b05f53e591eaccb4263708437e8f49dcc2ac754811ad5af90a52dcd951900e876ea252985772e0aeb30199874654629a8
+  data.tar.gz: 2f34e87bd48e5a8bc145c3016740e635da095b1a78a651ee34e597a6402e97286973e9874871ffd067a4469be9b62cc77a2d35fbaacea43e2b9a3ebbd090f068

data/README.adoc

@@ -2,10 +2,11 @@
 :toc: macro
 :!toc-title:
 // URLs:
-:img-gem: https://badge.fury.io/rb/transcode.svg
+:img-gem: https://img.shields.io/gem/v/transcode?color=dfaf8f&labelColor=555555&logo=rubygems&logoColor=dcdccc&style=flat
 :img-hoc: https://hitsofcode.com/github/rdavid/transcode?branch=master&label=hits%20of%20code
-:img-license: https://img.shields.io/github/license/rdavid/transcode?color=blue&labelColor=gray&logo=freebsd&logoColor=lightgray&style=flat
-:img-rake: https://github.com/rdavid/transcode/actions/workflows/rake.yml/badge.svg
+:img-license: https://img.shields.io/github/license/rdavid/transcode?color=94bff3&labelColor=555555&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI%2BPHRleHQgeD0iMTIiIHk9IjIwIiBmb250LWZhbWlseT0iSGVsdmV0aWNhLEFyaWFsLHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0iMjgiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZpbGw9IiNkY2RjY2MiPiYjMTY5OzwvdGV4dD48L3N2Zz4%3D&style=flat
+:img-rake: https://img.shields.io/github/actions/workflow/status/rdavid/transcode/rake.yml?branch=master&label=rake&color=7f9f7f&labelColor=555555&logo=github&logoColor=dcdccc&style=flat
+:img-rubocop: https://img.shields.io/github/actions/workflow/status/rdavid/transcode/rubocop.yml?branch=master&color=8cd0d3&label=rubocop&labelColor=555555&logo=rubocop&logoColor=dcdccc&style=flat
 :url-cv: http://cv.rabkin.co.il
 :url-gem: https://badge.fury.io/rb/transcode
 :url-hoc: https://hitsofcode.com/view/github/rdavid/transcode?branch=master
@@ -13,6 +14,7 @@
 :url-melton: https://github.com/lisamelton/video_transcoding
 :url-rake: https://github.com/rdavid/transcode/actions/workflows/rake.yml
 :url-reuse: https://github.com/fsfe/reuse-action
+:url-rubocop: https://github.com/rdavid/transcode/actions/workflows/rubocop.yml
 :url-requirements: https://github.com/lisamelton/video_transcoding/blob/master/README.md?ts=2#requirements
 :url-ruby: https://www.ruby-lang.org/en/documentation/installation
 :url-video: https://github.com/lisamelton/video_transcoding
@@ -21,20 +23,39 @@
 
 = Transcode
 
-image:{img-rake}[rake,link={url-rake}]
-image:{img-gem}[gem version,link={url-gem}]
-image:{img-hoc}[hits of code,link={url-hoc}]
-image:{img-license}[license,link={url-license}]
+[subs=attributes+]
+++++
+<div align="right">
+<a href="{url-rake}"><img src="{img-rake}" alt="rake"></a>
+<a href="{url-rubocop}"><img src="{img-rubocop}" alt="rubocop"></a>
+<a href="{url-gem}"><img src="{img-gem}" alt="gem version"></a>
+<a href="{url-hoc}"><img src="{img-hoc}" alt="hits of code"></a>
+<a href="{url-license}"><img src="{img-license}" alt="license"></a>
+</div>
+++++
 
 toc::[]
 
+ifdef::pages-build[]
+++++
+<div id="repo-link">
+  <a href="https://github.com/rdavid/transcode" aria-label="GitHub repository" target="_blank" rel="noopener">
+    <svg viewBox="0 0 16 16" width="18" height="18" fill="currentColor" aria-hidden="true">
+      <path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8Z"/>
+    </svg>
+  </a>
+</div>
+++++
+endif::[]
+
 == About
 
-Transcode is a command-line tool that converts whole directories of video
-files in one run.
-It wraps {url-melton}[Lisa Melton's] {url-video}[Video Transcoding],
-which converts one file per invocation, and applies the same workflow
-to every video in a directory with a single command.
+Transcode converts a whole directory of video files in one run from the
+command line.
+It wraps {url-melton}[Lisa Melton's] {url-video}[Video Transcoding], which
+converts one file per invocation.
+Transcode applies that same workflow to every video in a directory with one
+command.
 
 Transcode can:
 
@@ -47,13 +68,12 @@ Transcode can:
 It recognizes these input formats: `avi`, `flv`, `m2ts`, `m4v`, `mkv`,
 `mp4`, `mpg`, `mpeg`, `mov`, `ts`, `webm`, `vob`, and `wmv`.
 
-== Installation
+== Install
 
 Transcode ships as a Ruby gem and requires Ruby 3.2 or later.
 It runs on macOS, GNU/Linux, Windows, and any other system Ruby
 supports.
-See {url-ruby}[Installing Ruby] if Ruby 3.2+ is not available on your
-platform.
+See {url-ruby}[Installing Ruby] if your platform lacks Ruby 3.2+.
 
 Install with:
 
@@ -62,7 +82,7 @@ Install with:
 gem install transcode
 ----
 
-== Updating
+== Update
 
 Update with:
 
@@ -76,32 +96,32 @@ gem update transcode
 See Video Transcoding's {url-requirements}[requirements] for external
 dependencies.
 
-== Usage
+== Using
 
 [,sh]
 ----
 transcode [options]
-  -a, --act      Perform actual encoding.
-  -u, --aud aud  Audio stream numbers.
-  -d, --dir dir  Source directory to transcode.
-  -m, --mp3      Convert files to MP3.
-  -o, --out out  Output directory.
-  -s, --sca      Scan files in the directory.
-  -t, --sub sub  Subtitle stream numbers.
-  -i, --tit tit  Specific title number.
-  -v, --version  Show version.
-  -w, --wid wid  Width of the table.
+  -a, --act      Performs actual encoding.
+  -u, --aud aud  Sets the audio stream numbers.
+  -d, --dir dir  Sets the directory to transcode.
+  -m, --mp3      Converts files to MP3.
+  -o, --out out  Sets the output directory.
+  -s, --sca      Scans files in the directory.
+  -t, --sub sub  Sets the subtitle stream numbers.
+  -i, --tit tit  Sets the title number.
+  -v, --version  Shows the version.
+  -w, --wid wid  Sets the output table width.
 ----
 
 Transcode performs a dry run by default.
 It prints the commands it would run and a summary table without changing any
 files.
-Pass `--act` to start the encoding.
+Adding `--act` starts the encoding.
 
 Without `--dir` and `--out`, Transcode reads from and writes to the current
 directory.
-The `--aud` and `--sub` options take comma-separated stream numbers, either
-one value applied to every file or one value per file.
+The `--aud` and `--sub` options take comma-separated stream numbers: one
+value applies to every file, or each file takes its own value.
 
 == Examples
 
@@ -136,5 +156,22 @@ transcode --mp3 --act
 
 == License
 
-`transcode` is copyright {url-cv}[David Rabkin] and available under a
+`transcode` carries copyright by {url-cv}[David Rabkin] and ships under a
 {url-license}[Zero-Clause BSD license].
+
+ifdef::pages-build[]
+++++
+<footer id="site-footer">
+  <div class="footer-left">
+    <img src="favicon.svg" alt="" width="20" height="20">
+    <span>transcode by <a href="http://cv.rabkin.co.il" target="_blank" rel="noopener">David Rabkin</a></span>
+  </div>
+  <div class="footer-links">
+    <a href="https://github.com/rdavid/transcode" target="_blank" rel="noopener">GitHub</a>
+    <a href="https://badge.fury.io/rb/transcode" target="_blank" rel="noopener">RubyGems</a>
+    <a href="https://github.com/rdavid/transcode/releases" target="_blank" rel="noopener">Releases</a>
+    <a href="https://github.com/rdavid/transcode/blob/master/LICENSES/0BSD.txt" target="_blank" rel="noopener">0BSD License</a>
+  </div>
+</footer>
+++++
+endif::[]

data/lib/transcode/configurator.rb

@@ -13,22 +13,22 @@ module Transcode
     attr_reader :files
 
     DIC = [
-      ['-a', '--act', 'Perform actual encoding.', nil, :act],
-      ['-u', '--aud aud', 'Audio stream numbers.', Array, :aud],
-      ['-d', '--dir dir', 'Source directory to transcode.', String, :dir],
-      ['-m', '--mp3', 'Convert files to MP3.', nil, :mp3],
-      ['-o', '--out out', 'Output directory.', String, :out],
-      ['-s', '--sca', 'Scan files in the directory.', nil, :sca],
-      ['-t', '--sub sub', 'Subtitle stream numbers.', Array, :sub],
-      ['-i', '--tit tit', 'Specific title number.', Array, :tit],
-      ['-w', '--wid wid', 'Width of the table.', Integer, :wid]
+      ['-a', '--act', 'Performs actual encoding.', nil, :act],
+      ['-u', '--aud aud', 'Sets the audio stream numbers.', Array, :aud],
+      ['-d', '--dir dir', 'Sets the directory to transcode.', String, :dir],
+      ['-m', '--mp3', 'Converts files to MP3.', nil, :mp3],
+      ['-o', '--out out', 'Sets the output directory.', String, :out],
+      ['-s', '--sca', 'Scans files in the directory.', nil, :sca],
+      ['-t', '--sub sub', 'Sets the subtitle stream numbers.', Array, :sub],
+      ['-i', '--tit tit', 'Sets the title number.', Array, :tit],
+      ['-w', '--wid wid', 'Sets the output table width.', Integer, :wid]
     ].freeze
     EXT = %w[
       avi flv m2ts m4v mkv mp4 mpg mpeg mov ts webm vob wmv
     ].join(',').freeze
 
     def add(opt)
-      opt.on('-v', '--version', 'Show version.') do
+      opt.on('-v', '--version', 'Shows the version.') do
         puts "#{File.basename($PROGRAM_NAME)} #{VERSION} #{DATE}"
         exit
       end

data/lib/transcode/transcoder.rb

@@ -40,9 +40,10 @@ module Transcode
       c + " #{file.shellescape}"
     end
 
-    # Converts file, audio, subtitle, and title arrays into an array:
-    #   [ file1 [ aud1, sub1, tit1 ] ]
-    #   [ file2 [ aud2, sub2, tit2 ] ]
+    # Converts file, audio, subtitle, and title arrays into an array of
+    # pairs:
+    #   [ file1, [ aud1, sub1, tit1 ] ]
+    #   [ file2, [ aud2, sub2, tit2 ] ]
     def data
       @data ||= @cfg.files.zip([@cfg.aud, @cfg.sub, @cfg.tit].transpose)
     end
@@ -54,10 +55,28 @@ module Transcode
       end
     end
 
+    def mp3_dst(file)
+      "#{@cfg.out}/#{File.basename(file, '.*')}.mp3"
+    end
+
+    # Skips files whose destination MP3 already exists, so reruns only
+    # convert what's missing.
+    def mp3_files
+      @cfg.files.reject do |f|
+        dst = mp3_dst(f)
+        File.exist?(dst).tap { |exists| warn "Skip: #{f} exists as #{dst}." if exists }
+      end
+    end
+
+    # -q:a 0 requests libmp3lame's highest VBR quality (V0), letting
+    # bitrate adapt to content complexity instead of spending a fixed
+    # rate on simple passages. No -ar is given, so ffmpeg keeps the
+    # source's sample rate when libmp3lame supports it directly (44100,
+    # 48000, 32000, and others), instead of downsampling every file,
+    # most commonly 48kHz video audio, to 44100.
     def mp3_cmd(file)
-      file = file.shellescape
-      "ffmpeg -i #{file} -vn -ar 44100 -ac 2 -ab 192k -f mp3 " \
-        "#{@cfg.out}/#{File.basename(file, '.*')}.mp3"
+      "ffmpeg -nostdin -i #{file.shellescape} -ac 2 -f mp3 -q:a 0 -vn " \
+        "#{mp3_dst(file)}"
     end
 
     def scn_cmd(file)
@@ -66,7 +85,7 @@ module Transcode
 
     def do
       if @cfg.mp3?
-        @cfg.files.each { |f| @rep.add(f, @cfg.act? ? run(mp3_cmd(f)) : true) }
+        mp3_files.each { |f| @rep.add(f, @cfg.act? ? run(mp3_cmd(f)) : true) }
       elsif @cfg.sca?
         @cfg.files.each { |f| @rep.add(f, run(scn_cmd(f))) }
       else

data/lib/transcode/version.rb

@@ -5,6 +5,6 @@
 # SPDX-License-Identifier: 0BSD
 
 module Transcode
-  VERSION = '1.0.6'
-  DATE = '2026-07-15'
+  VERSION = '1.0.7'
+  DATE = '2026-09-13'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: transcode
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.7
 platform: ruby
 authors:
 - David Rabkin