transcode 1.0.5 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59cae6c1f3477d89285847f141d461e564e7f926f283f9be6b013179b2a97d1b
-  data.tar.gz: 5e1815c63c7e4ca38c994bc7a08a008491c7c1ed3af092df04a93a7f46becbea
+  metadata.gz: 31614466613fcca1314cfdba740f375f534fc2f2496e97849dfa7708eb2439f8
+  data.tar.gz: 062fc1cdb39ea866cfb4f16769f4f2cd0e0db7c997112b77d9eb86eaafe85efd
 SHA512:
-  metadata.gz: fa67a8127e8181097a8a1229c590c8e159af9b63175294f69400db2fb923a71763b21449538d056d1574302ea3ba384f80e4c5a9ba68c921989496458f0dda21
-  data.tar.gz: 0465be0d07c458f038eecb0dc9cd5a5a38da1eb9fc54e0a5fc586bbe27fe98869a180de539fe135e9820be945bc3e2cdee2326b1fc2f5dee9c1055cde7b7c317
+  metadata.gz: 949aa013995bfc786523ff0c13a0077b05f53e591eaccb4263708437e8f49dcc2ac754811ad5af90a52dcd951900e876ea252985772e0aeb30199874654629a8
+  data.tar.gz: 2f34e87bd48e5a8bc145c3016740e635da095b1a78a651ee34e597a6402e97286973e9874871ffd067a4469be9b62cc77a2d35fbaacea43e2b9a3ebbd090f068

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2020-2025 David Rabkin
+Copyright 2020-2026 David Rabkin
 
 Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
 

data/README.adoc

@@ -2,19 +2,19 @@
 :toc: macro
 :!toc-title:
 // URLs:
-:img-build: https://ci.appveyor.com/api/projects/status/yqxb43ltxrjj776a?svg=true
-: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
-:url-build: https://ci.appveyor.com/project/rdavid/transcode
+: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
 :url-license: https://github.com/rdavid/transcode/blob/master/LICENSES/0BSD.txt
-:url-melton: https://lisamelton.net
+: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
@@ -23,37 +23,68 @@
 
 = Transcode
 
-image:{img-rake}[rake,link={url-rake}]
-image:{img-build}[build,link={url-build}]
-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 tool designed for transcoding multiple video files.
-It builds upon {url-melton}[Lisa Melton's] Video Transcoding and applies
-this technique to each video file within a directory.
+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:
+
+* Convert an entire directory to `.m4v` in a single run.
+* Select the main audio and burned-in subtitle stream for each file.
+* Extract audio to `.mp3`.
+* Scan files to list their available audio and subtitle streams.
+* Print a summary table of the results.
 
-== Installation
+It recognizes these input formats: `avi`, `flv`, `m2ts`, `m4v`, `mkv`,
+`mp4`, `mpg`, `mpeg`, `mov`, `ts`, `webm`, `vob`, and `wmv`.
 
-The tool is designed to work on macOS, GNU/Linux, Windows, Unix-like OS.
-It is packaged as a Gem and require Ruby version 3.2 or later.
-See {url-ruby}[Installing Ruby] if you don't have the proper version on your
-platform.
+== Install
 
-Use this command to 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 your platform lacks Ruby 3.2+.
+
+Install with:
 
 [,sh]
 ----
 gem install transcode
 ----
 
-== Updating
+== Update
 
-Use this command to update the package:
+Update with:
 
 [,sh]
 ----
@@ -62,40 +93,85 @@ gem update transcode
 
 == Requirements
 
-See Video Transcoding's {url-requirements}[requirements].
+See Video Transcoding's {url-requirements}[requirements] for external
+dependencies.
 
-== Usage
+== Using
 
 [,sh]
 ----
 transcode [options]
-  -a, --act      Real encoding.
-  -s, --sca      Scans files at the directory.
-  -m, --mp3      Converts files to mp3.
-  -d, --dir dir  Directory to transcode.
-  -i, --tit tit  Specific title by number.
-  -o, --out out  Directory to output.
-  -u, --aud aud  Audio stream numbers.
-  -t, --sub sub  Subtitle stream numbers.
-  -w, --wid wid  Width of the table.
-  -v, --version  Shows version.
+  -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.
 ----
 
-== Example
+Transcode performs a dry run by default.
+It prints the commands it would run and a summary table without changing any
+files.
+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: one
+value applies to every file, or each file takes its own value.
+
+== Examples
+
+Scan the source directory to inspect the available audio and subtitle
+streams:
+
+[,sh]
+----
+transcode --sca --dir [source]
+----
+
+Transcode three files from `[source]` to `[destination]` with the selected
+audio and subtitle streams.
+Add `--act` once the plan looks right:
 
 [,sh]
 ----
 transcode \
+  --act \
   --aud 1,3,1 \
   --dir [source] \
   --out [destination] \
   --sub 2,1,3
 ----
 
-It converts three files from source with certain audio and subtitle streams.
-Inspect first with `--sca` option to see audio and subtitle streams.
+Extract the audio of every file in the current directory to `.mp3`:
+
+[,sh]
+----
+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/bin/transcode

@@ -1,10 +1,14 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative '../lib/transcode'
 
-Transcode::Transcoder.new.do
+begin
+  Transcode::Transcoder.new.do
+rescue StandardError => e
+  abort "transcode: #{e.message}"
+end

data/lib/transcode/configurator.rb

@@ -1,10 +1,11 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'optparse'
+require_relative 'string'
 
 module Transcode
   # Handles input parameters.
@@ -12,22 +13,22 @@ module Transcode
     attr_reader :files
 
     DIC = [
-      ['-a', '--act', 'Real encoding.', nil, :act],
-      ['-s', '--sca', 'Scans files at the directory.', nil, :sca],
-      ['-m', '--mp3', 'Converts files to mp3.', nil, :mp3],
-      ['-d', '--dir dir', 'Directory to transcode.', String, :dir],
-      ['-i', '--tit tit', 'Specific title by number.', Array, :tit],
-      ['-o', '--out out', 'Directory to output.', String, :out],
-      ['-u', '--aud aud', 'Audio stream numbers.', Array, :aud],
-      ['-t', '--sub sub', 'Subtitle stream numbers.', Array, :sub],
-      ['-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 = %i[
+    EXT = %w[
       avi flv m2ts m4v mkv mp4 mpg mpeg mov ts webm vob wmv
-    ].map(&:to_s).join(',').freeze
+    ].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
@@ -54,8 +55,7 @@ module Transcode
       @files = Dir.glob("#{dir}/*.{#{EXT}}").select { |f| File.file? f }
       sub = !mp3?
       @files += Dir.glob("#{dir}/*").select { |f| File.directory? f } if sub
-      @files.sort_by!(&:naturalized)
-      @files.sort_by!(&:swapcase)
+      @files.sort_by! { |f| f.swapcase.naturalized }
     end
 
     def validate
@@ -65,19 +65,19 @@ module Transcode
       validate_tit
       validate_val(aud, :aud)
       validate_val(sub, :sub)
-      raise "Width of the table should exceeds 14 symbols: #{wid}." if wid < 15
+      raise "Width of the table must exceed 14 characters: #{wid}." if wid < 15
     end
 
     def validate_dir(dir, isw)
       raise "#{dir}: No such directory." unless File.directory?(dir)
 
       err = isw ? File.writable?(dir) : File.readable?(dir)
-      raise "#{out}: Permission denied." unless err
+      raise "#{dir}: Permission denied." unless err
     end
 
     def validate_fil
       bad = files.reject { |f| File.readable?(f) }
-      raise "#{dir} doesn't have #{EXT} files or directories." if files.empty?
+      raise "#{dir} has no #{EXT} files or directories." if files.empty?
       raise "#{bad.join(',')}: Permission denied." unless bad.empty?
     end
 
@@ -101,7 +101,7 @@ module Transcode
       if s == 1
         @options[tag] = Array.new(f, val.first)
       else
-        raise "#{tag} and files do not suit #{s} != #{f}." unless s == f
+        raise "#{tag} count #{s} doesn't match file count #{f}." unless s == f
       end
     end
 
@@ -137,9 +137,10 @@ module Transcode
       @options[:sub]
     end
 
+    # Returns the table width, falling back to the terminal width when the
+    # option is not set.
     def wid
       if @options[:wid].nil?
-        # Reads current terminal width.
         wid = `tput cols`
         wid.to_s.empty? ? 79 : wid.to_i
       else

data/lib/transcode/reporter.rb

@@ -1,14 +1,15 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'terminal-table'
+require_relative 'timer'
 require_relative 'utils'
 
 module Transcode
-  # Formats and prints output data.
+  # Formats and prints the summary table.
   class Reporter
     def initialize(act, tit, wid)
       @act = act

data/lib/transcode/string.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
+# SPDX-License-Identifier: 0BSD
+
+# Adds a natural sort method. It converts a string such as "Filename 10"
+# into an array with floats in place of numbers, ["Filename", 10.0], as
+# suggested in https://stackoverflow.com/q/4078906.
+class String
+  def naturalized
+    scan(/[^\d.]+|[\d.]+/).map { |f| f.match?(/\d+(\.\d+)?/) ? f.to_f : f }
+  end
+end

data/lib/transcode/timer.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
+# SPDX-License-Identifier: 0BSD
+
+# Measures elapsed time and reports it as a humanized string.
+class Timer
+  @less_sec = 'less than a second'
+  class << self
+    attr_reader :less_sec
+  end
+
+  DIC = [
+    [60,   :seconds, :second],
+    [60,   :minutes, :minute],
+    [24,   :hours,   :hour],
+    [1000, :days,    :day]
+  ].freeze
+
+  def initialize
+    @sta = Time.now
+  end
+
+  def read
+    humanize(Time.now - @sta)
+  end
+
+  def humanize(sec)
+    return '' if sec.nil?
+    return Timer.less_sec if sec < 1
+
+    DIC.filter_map do |cnt, nms, nm1|
+      next if sec <= 0
+
+      sec, n = sec.divmod(cnt)
+      "#{n.to_i} #{n.to_i == 1 ? nm1 : nms}"
+    end.compact.reverse.join(' ')
+  end
+end

data/lib/transcode/transcoder.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'English'
@@ -17,7 +17,8 @@ module Transcode
       @rep = Reporter.new(@cfg.act?, "#{@cfg.dir} -> #{@cfg.out}", @cfg.wid)
     end
 
-    # Runs command and prints output instantly. Returns true on success.
+    # Runs a command and prints its output as it arrives. Returns true on
+    # success.
     def run(cmd)
       cmd += ' 2>&1'
       puts "Run: #{cmd}."
@@ -28,8 +29,8 @@ module Transcode
     end
 
     def m4v_cmd(file, aud, sub, tit)
-      c = 'transcode-video --m4v --no-log --preset veryslow'\
-          " --output #{@cfg.out}"
+      c = 'transcode-video --m4v --no-log --preset veryslow ' \
+          "--output #{@cfg.out}"
       unless tit == '0'
         c += "/#{File.basename(file.shellescape)}-#{tit}.m4v"
         c += " --title #{tit}"
@@ -39,9 +40,10 @@ module Transcode
       c + " #{file.shellescape}"
     end
 
-    # Converts files, audibale, subtitles and titles arrays to 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
@@ -53,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)
@@ -65,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/utils.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'ellipsized'
 
-# All methods are static.
+# Provides string helpers as class methods.
 class Utils
   @sep = '~'
   class << self
@@ -17,47 +17,3 @@ class Utils
     end
   end
 end
-
-# Returns string with humanized time interval.
-class Timer
-  @less_sec = 'less than a second'
-  class << self
-    attr_reader :less_sec
-  end
-
-  DIC = [
-    [60,   :seconds, :second],
-    [60,   :minutes, :minute],
-    [24,   :hours,   :hour],
-    [1000, :days,    :day]
-  ].freeze
-
-  def initialize
-    @sta = Time.now
-  end
-
-  def read
-    humanize(Time.now - @sta)
-  end
-
-  def humanize(sec)
-    return '' if sec.nil?
-    return Timer.less_sec if sec < 1
-
-    DIC.map do |cnt, nms, nm1|
-      next if sec <= 0
-
-      sec, n = sec.divmod(cnt)
-      "#{n.to_i} #{n.to_i != 1 ? nms : nm1}"
-    end.compact.reverse.join(' ')
-  end
-end
-
-# Adds natural sort method. This converts something like "Filename 10" into a
-# simple array with floats in place of numbers [ "Filename", 10.0 ]. See:
-#  https://stackoverflow.com/q/4078906
-class String
-  def naturalized
-    scan(/[^\d.]+|[\d.]+/).collect { |f| f.match(/\d+(\.\d+)?/) ? f.to_f : f }
-  end
-end

data/lib/transcode/version.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2020-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2020-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 module Transcode
-  VERSION = '1.0.5'
-  DATE = '2025-08-04'
+  VERSION = '1.0.7'
+  DATE = '2026-09-13'
 end

data/lib/transcode.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'transcode/transcoder'

metadata

@@ -1,15 +1,59 @@
 --- !ruby/object:Gem::Specification
 name: transcode
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.7
 platform: ruby
 authors:
 - David Rabkin
 bindir: bin
 cert_chain: []
-date: 2025-08-04 00:00:00.000000000 Z
-dependencies: []
-description: "    Transcode is a wrapper on Video Transcoding.\n"
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ellipsized
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: video_transcoding
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+description: |2
+      Transcode wraps Lisa Melton's Video Transcoding and converts whole
+      directories of video files in one run.
 email: david@rabkin.co.il
 executables:
 - transcode
@@ -18,41 +62,25 @@ extra_rdoc_files:
 - LICENSE
 - README.adoc
 files:
-- ".github/dependabot.yml"
-- ".github/styles/config/vocabularies/Base/accept.txt"
-- ".github/workflows/actionlint.yml"
-- ".github/workflows/rake.yml"
-- ".github/workflows/reuse.yml"
-- ".github/workflows/rubocop.yml"
-- ".github/workflows/typos.yml"
-- ".github/workflows/vale.yml"
-- ".github/workflows/yamllint.yml"
-- ".gitignore"
-- ".travis.yml"
-- ".vale.ini"
-- Gemfile
-- Gemfile.lock
 - LICENSE
-- LICENSES/0BSD.txt
 - README.adoc
-- REUSE.toml
-- Rakefile
-- _typos.toml
-- appveyor.yml
 - bin/transcode
 - lib/transcode.rb
 - lib/transcode/configurator.rb
 - lib/transcode/reporter.rb
+- lib/transcode/string.rb
+- lib/transcode/timer.rb
 - lib/transcode/transcoder.rb
 - lib/transcode/utils.rb
 - lib/transcode/version.rb
-- test/test_utils.rb
-- transcode.gemspec
 homepage: https://github.com/rdavid/transcode
 licenses:
 - 0BSD
 metadata:
+  bug_tracker_uri: https://github.com/rdavid/transcode/issues
+  homepage_uri: https://github.com/rdavid/transcode
   rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/rdavid/transcode
 rdoc_options: []
 require_paths:
 - lib
@@ -69,5 +97,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Tools to transcode batch of video files
+summary: Tool to transcode batches of video files
 test_files: []

data/.github/dependabot.yml

@@ -1,13 +0,0 @@
-# SPDX-FileCopyrightText: 2023-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-version: 2
-updates:
-  - package-ecosystem: github-actions
-    directory: /
-    schedule:
-      interval: daily
-  - package-ecosystem: bundler
-    directory: /
-    schedule:
-      interval: daily

data/.github/styles/config/vocabularies/Base/accept.txt

@@ -1,5 +0,0 @@
-Rabkin
-Shellbase
-transcode
-Transcode
-Transcoding

data/.github/workflows/actionlint.yml

@@ -1,24 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-name: actionlint
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-env:
-  URL: https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash # yamllint disable-line
-jobs:
-  actionlint:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - name: Download actionlint
-        id: get_actionlint
-        run: bash <(curl "$URL")
-      - name: Check workflow files
-        run: ${{ steps.get_actionlint.outputs.executable }} -color

data/.github/workflows/rake.yml

@@ -1,37 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-name: rake
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  rake:
-    strategy:
-      fail-fast: false
-      matrix:
-        os:
-          - macos-13
-          - macos-14
-          - macos-15
-          - ubuntu-22.04
-          - ubuntu-24.04
-          - windows-2022
-          - windows-2025
-        ruby:
-          - 3.2
-          - 3.3
-          - 3.4
-    name: Rake on ${{ matrix.os }} / Ruby ${{ matrix.ruby }}
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-      - run: bundle exec rake

data/.github/workflows/reuse.yml

@@ -1,18 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-name: reuse
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  reuse:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: fsfe/reuse-action@v5

data/.github/workflows/rubocop.yml

@@ -1,22 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-name: rubocop
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  rubocop:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: andrewmcodes/rubocop-linter-action@v3.3.0
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          exit_on_failure: true

data/.github/workflows/typos.yml

@@ -1,18 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-name: typos
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  typos:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: crate-ci/typos@v1.34.0

data/.github/workflows/vale.yml

@@ -1,21 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-name: vale
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  vale:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - run: sudo apt-get install asciidoctor
-      - uses: errata-ai/vale-action@reviewdog
-        with:
-          fail_on_error: true

data/.github/workflows/yamllint.yml

@@ -1,21 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-name: yamllint
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  yamllint:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ibiqlik/action-yamllint@v3
-        with:
-          file_or_dir: ./.github/*.yml ./.github/workflows/*.yml
-          strict: true

data/.gitignore

@@ -1,13 +0,0 @@
-*.gem
-.bundle/
-.DS_Store
-.github/styles/.vale-config
-.github/styles/alex
-.github/styles/Google
-.github/styles/Joblint
-.github/styles/proselint
-.github/styles/Readability
-.github/styles/write-good
-.idea/
-coverage/
-rdoc/

data/.travis.yml

@@ -1,14 +0,0 @@
-# SPDX-FileCopyrightText: 2023-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-language: ruby
-rvm:
-  - ~>3.2
-branches:
-  only:
-    - master
-install:
-  - bundle install
-script:
-  - set -e
-  - bundle exec rake

data/.vale.ini

@@ -1,7 +0,0 @@
-MinAlertLevel = suggestion
-Packages = Google, proselint, write-good, alex, Readability, Joblint
-StylesPath = .github/styles
-Vocab = Base
-
-[*.adoc]
-BasedOnStyles = Vale, Google, proselint, write-good, alex, Readability, Joblint

data/Gemfile

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2020-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
-
-source 'https://rubygems.org'
-gem 'ellipsized'
-gem 'minitest'
-gem 'rake'
-gem 'rubocop'
-gem 'terminal-table'
-gem 'video_transcoding'

data/Gemfile.lock

@@ -1,54 +0,0 @@
-GEM
-  remote: https://rubygems.org/
-  specs:
-    ast (2.4.3)
-    ellipsized (0.3.0)
-    json (2.13.2)
-    language_server-protocol (3.17.0.5)
-    lint_roller (1.1.0)
-    minitest (5.25.5)
-    parallel (1.27.0)
-    parser (3.3.9.0)
-      ast (~> 2.4.1)
-      racc
-    prism (1.4.0)
-    racc (1.8.1)
-    rainbow (3.1.1)
-    rake (13.3.0)
-    regexp_parser (2.11.0)
-    rubocop (1.79.1)
-      json (~> 2.3)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.46.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.46.0)
-      parser (>= 3.3.7.2)
-      prism (~> 1.4)
-    ruby-progressbar (1.13.0)
-    terminal-table (4.0.0)
-      unicode-display_width (>= 1.1.1, < 4)
-    unicode-display_width (3.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
-    video_transcoding (0.25.3)
-
-PLATFORMS
-  arm64-darwin-24
-  ruby
-
-DEPENDENCIES
-  ellipsized
-  minitest
-  rake
-  rubocop
-  terminal-table
-  video_transcoding
-
-BUNDLED WITH
-   2.7.1

data/LICENSES/0BSD.txt

@@ -1,5 +0,0 @@
-Copyright 2020-2025 David Rabkin
-
-Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/REUSE.toml

@@ -1,14 +0,0 @@
-# SPDX-FileCopyrightText: 2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
-version = 1
-[[annotations]]
-path = [
-	".github/styles/**",
-	".gitignore",
-	".vale.ini",
-	"Gemfile.lock",
-	"README.adoc",
-]
-precedence = "override"
-SPDX-FileCopyrightText = "2025 David Rabkin"
-SPDX-License-Identifier = "0BSD"

data/Rakefile

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2020-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
-
-task default: %w[test]
-
-task :test do
-  ruby 'test/test_utils.rb'
-end

data/_typos.toml

@@ -1,4 +0,0 @@
-# SPDX-FileCopyrightText: 2023-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
-[default.extend-words]
-nin = "nin"

data/appveyor.yml

@@ -1,28 +0,0 @@
-# SPDX-FileCopyrightText: 2023-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
----
-version: '{build}'
-skip_tags: true
-clone_depth: 10
-branches:
-  only:
-    - master
-  except:
-    - gh-pages
-os: Windows Server 2012
-environment:
-  matrix:
-    - ruby_version: "26-x64"
-install:
-  - ps: |
-      $Env:PATH = "C:\Ruby${Env:ruby_version}\bin;${Env:PATH}"
-  - bundle config --local path vendor/bundle
-  - ruby -v
-  - bundle -v
-build_script:
-  - bundle update
-  - bundle install
-test_script:
-  - bundle exec rake --quiet
-cache:
-  - vendor/bundle

data/test/test_utils.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2020-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
-
-require 'minitest/autorun'
-require_relative '../lib/transcode/utils'
-
-class TestUtils < Minitest::Test
-  def setup
-    @tim = Timer.new
-  end
-
-  def test_timer
-    assert_equal(Timer.less_sec, @tim.read)
-    sleep(1)
-    assert_equal('1 second', @tim.read)
-    sleep(1)
-    assert_equal('2 seconds', @tim.read)
-  end
-
-  def test_trim
-    s = Utils.sep
-    assert_equal("ni#{s}bo", Utils.trim('ninesymbo', 5))
-    assert_equal("te#{s}ls", Utils.trim('tensymbols', 5))
-    assert_equal("nin#{s}bo", Utils.trim('ninesymbo', 6))
-    assert_equal("ten#{s}ls", Utils.trim('tensymbols', 6))
-  end
-end

data/transcode.gemspec

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: 2023-2025 David Rabkin
-# SPDX-License-Identifier: 0BSD
-
-$LOAD_PATH.unshift File.expand_path("#{File.dirname(__FILE__)}/lib")
-
-require 'transcode'
-
-Gem::Specification.new do |s|
-  s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
-  s.required_ruby_version = '>=3.2'
-  s.name = 'transcode'
-  s.version = Transcode::VERSION
-  s.date = Transcode::DATE
-  s.summary = 'Tools to transcode batch of video files'
-  s.description = <<-HERE
-    Transcode is a wrapper on Video Transcoding.
-  HERE
-  s.license = '0BSD'
-  s.author = 'David Rabkin'
-  s.email = 'david@rabkin.co.il'
-  s.homepage = 'https://github.com/rdavid/transcode'
-  s.files = `git ls-files`.split($RS)
-  s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  s.extra_rdoc_files = ['LICENSE', 'README.adoc']
-  s.metadata['rubygems_mfa_required'] = 'true'
-end