media_trim 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 36ab2c24be1441d81a352ca71f72e7476e5bc748cde55da317fac140063c5a6d
+  data.tar.gz: bb39ea9a3dd5b8e91da60dd6b6e64d1e03b31330647cfb5ec7666041d470ee89
+SHA512:
+  metadata.gz: b5fa5f3e4634c0f04197744edf1c809a9ff139931af5ba6911b8098c5de37abe26f14b3353de3ae7468868f1435256549b025634e723d4973d8333abcd4ce0c9
+  data.tar.gz: 21fa1ee01fa7b71392e2acd7f40a4b1e63ee69f6fcbc8300939b542974b39b4a76ec232ce02d4b8aca6d0e63000f6edc47a31e673af908721e3ab2b22163175f

data/.rubocop.yml

@@ -0,0 +1,64 @@
+require:
+  - rubocop-md
+  - rubocop-performance
+  - rubocop-rake
+
+AllCops:
+  Exclude:
+    - binstub/**/*
+    - exe/**/*
+    - vendor/**/*
+    - Gemfile*
+  NewCops: enable
+
+Gemspec/DeprecatedAttributeAssignment:
+  Enabled: false
+
+Gemspec/RequireMFA:
+  Enabled: false
+
+Gemspec/RequiredRubyVersion:
+  Enabled: false
+
+Layout/HashAlignment:
+  EnforcedColonStyle: table
+  EnforcedHashRocketStyle: table
+
+Layout/LineLength:
+  Max: 150
+
+Metrics/AbcSize:
+  Max: 40
+
+Metrics/BlockLength:
+  Exclude:
+    - media_trim.gemspec
+  Max: 40
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/MethodLength:
+  Max: 40
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Max: 15
+
+Naming/FileName:
+  Exclude:
+    - Rakefile
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: comma

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+
+
+## 0.2.0
+
+* Packaged as a gem.
+
+
+## 0.1.0
+
+* Initial release as a script.

data/README.md

@@ -0,0 +1,175 @@
+# `media_trim` [![Gem Version](https://badge.fury.io/rb/media_trim.svg)](https://badge.fury.io/rb/media_trim)
+
+Trims an audio or video file using `ffmpeg`.
+
+* Works with all formats supported by `ffmpeg`, including `mp3`, `mp4`, `mkv`, and many more.
+* Seeks to the nearest frame positions by re-encoding the media.
+* Reduces file size produced by OBS Studio by over 80 percent.
+* Can be used as a Ruby gem.
+* Installs the `trim` command.
+
+
+## Installation
+
+You need a working Ruby environment to install this program.
+I describe how to set that up [here](http://localhost:4001/ruby/1000-ruby-setup.html).
+
+
+### Standalone
+
+The `trim` command is provided by the `media_trim` Ruby gem.
+Install it like this:
+
+```shell
+$ gem install media_trim
+```
+
+### As a Dependency of a Ruby Program
+
+Add this line to your application’s `Gemfile`:
+
+```ruby
+gem 'media_trim'
+```
+
+Then execute:
+
+```shell
+$ bundle
+```
+
+### As a Dependency of a Ruby Gem
+
+Add the following to your application’s `.gemspec`:
+
+```ruby
+spec.add_dependency 'media_trim'
+```
+
+Then execute:
+
+```shell
+$ bundle
+```
+
+## Usage
+
+### Command-line Usage
+
+```shell
+trim [OPTIONS] dir/file.ext start [[to|for] end]
+```
+
+* The `start` and `end` timecodes have the format `[HH:[MM:]]SS[.XXX]`.
+  Note that decimal seconds may be specified, but frames may not;
+  this is consistent with how `ffmpeg` parses timecodes.
+* `end` defaults to the end of the audio/video file
+
+When run as a command, output files are named by adding a `trim.` prefix to the media file name,
+e.g. `dir/trim.file.ext`.
+By default, the `trim` command does not overwrite pre-existing output files.
+When trimming is complete, the `trim` command displays the trimmed file,
+unless the `-q` option is specified.
+
+`OPTIONS` are:
+
+* `-d` Enable debug output.
+* `-h` Display help information.
+* `-f` Overwrite output file if present.
+* `-v` Verbose output.
+* `-V` Do not view the trimmed file when complete.
+
+
+#### Examples
+
+Crop `dir/file.mp4` from 15.0 seconds to the end of the video, save to `demo/trim.demo.mp4`:
+
+```shell
+$ trim demo/demo.mp4 15
+```
+
+Crop dir/file.mkv from 3 minutes, 25 seconds to 9 minutes, 35 seconds, save to `demo/trim.demo.mp4`:
+
+```shell
+$ trim demo/demo.mp4 3:25 9:35
+```
+
+Same as the previous example, using optional `to` syntax:
+
+```shell
+$ trim demo/demo.mp4 3:25 to 9:35
+```
+
+Save as the previous example, but specify the duration instead of the end time by using the `for` keyword:
+
+```shell
+$ trim demo/demo.mp4 3:25 for 6:10
+```
+
+
+## Figuring Out Start and Stop Times
+
+Need a way to figure out the start and stop times to trim a video?
+[DJV](https://darbyjohnston.github.io/DJV/) is an excellent video viewer.
+
+* Allows frame-by-frame stepping
+* Displays the current time reliabily
+* F/OSS
+* Mac, Windows, Linux
+* High quality
+
+
+## Development
+
+After checking out this git repository, install dependencies by typing:
+
+```shell
+$ bin/setup
+```
+
+You should do the above before running Visual Studio Code.
+
+
+### Run the Tests
+
+```shell
+$ bundle exec rake test
+```
+
+
+### Interactive Session
+
+The following will allow you to experiment:
+
+```shell
+$ bin/console
+```
+
+
+### Local Installation
+
+To install this gem onto your local machine, type:
+
+```shell
+$ bundle exec rake install
+```
+
+
+### To Release A New Version
+
+To create a git tag for the new version, push git commits and tags,
+and push the new version of the gem to https://rubygems.org, type:
+
+```shell
+$ bundle exec rake release
+```
+
+
+## Contributing
+
+Bug reports and pull requests are welcome at https://github.com/mslinn/trim.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,40 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+desc 'Bump patch version'
+task :patch do
+  system 'gem bump --tag'
+end
+
+desc 'Bump minor version'
+task :minor do
+  system 'gem bump --version minor --tag'
+end
+
+desc 'Bump major version'
+task :major do
+  system 'gem bump --version major --tag'
+end
+
+task publish: [:build] do
+  $VERBOSE = nil
+  load 'trim/lib/version.rb'
+  system "gem push pkg/trim-#{Trim::VERSION}.gem"
+end
+
+desc 'Bump patch version, create git tag, build the gem and release to geminabox (default)'
+task release_patch: %i[test patch publish]
+
+desc 'Bump minor version, create git tag, build the gem and release to geminabox'
+task release_minor: %i[test minor publish]
+
+desc 'Bump major version, create git tag, build the gem and release to geminabox'
+task release_major: %i[test major publish]
+
+task default: :test

data/exe/trim

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'media_trim'
+
+media_trim = MediaTrim.new
+media_trim.options
+media_trim.setup ARGV
+media_trim.run

data/lib/media_trim/version.rb

@@ -0,0 +1,3 @@
+module MediaTrimVersion
+  VERSION = '0.2.0'.freeze
+end

data/lib/media_trim.rb

@@ -0,0 +1,16 @@
+require 'colorator'
+require 'fileutils'
+require 'optparse'
+require 'time'
+require_relative 'media_trim/version' unless defined? MediaTrimVersion::VERSION
+require_relative 'trim_class'
+require_relative 'trim_help'
+require_relative 'trim_main'
+require_relative 'trim_run'
+
+if __FILE__ == $PROGRAM_NAME
+  media_trim = MediaTrim.new
+  media_trim.options
+  media_trim.setup ARGV
+  media_trim.run
+end

data/lib/trim_class.rb

@@ -0,0 +1,63 @@
+class MediaTrim
+  def self.add_times(str1, str2)
+    time1 = Time.parse mk_time str1
+    time2 = Time.parse mk_time str2
+    h = time2.strftime('%H').to_i
+    m = time2.strftime('%M').to_i
+    s = time2.strftime('%S').to_i
+    millis = time2.strftime('%L').to_f / 1000.0
+    sum = (time1 + (h * 60 * 60) + (m * 60) + s + millis)
+    return sum.strftime('%H:%M:%S') if h.positive?
+
+    sum.strftime('%M:%S')
+  end
+
+  def self.time_format(elapsed_seconds)
+    elapsed_time = elapsed_seconds.to_i
+    hours = (elapsed_time / (60 * 60)).to_i
+    minutes = ((elapsed_time - (hours * 60)) / 60).to_i
+    seconds = elapsed_time - (hours * 60 * 60) - (minutes * 60)
+
+    result = "#{minutes.to_s.rjust 2, '0'}:#{seconds.to_s.delete_suffix('.0').rjust 2, '0'}"
+    result = "#{hours}:#{result}}" unless hours.zero?
+    result
+  end
+
+  # @return time difference HH:MM:SS, ignoring millis
+  def self.duration(str1, str2)
+    time1 = Time.parse mk_time str1
+    time2 = Time.parse mk_time str2
+
+    MediaTrim.time_format(time2 - time1)
+  end
+
+  # Expand an environment variable reference
+  def self.expand_env(str, die_if_undefined: false)
+    str&.gsub(/\$([a-zA-Z_][a-zA-Z0-9_]*)|\${\g<1>}|%\g<1>%/) do
+      envar = Regexp.last_match(1)
+      raise TrimError, "MediaTrim error: #{envar} is undefined".red, [] \
+        if !ENV.key?(envar) && die_if_undefined # Suppress stack trace
+
+      ENV.fetch(envar, nil)
+    end
+  end
+
+  def self.mk_time(str)
+    case str.count ':'
+    when 0 then "0:0:#{str}"
+    when 1 then "0:#{str}"
+    when 2 then str
+    else raise TrimError, "Error: #{str} is not a valid time"
+    end
+  end
+
+  def self.to_seconds(str)
+    array = str.split(':').map(&:to_i).reverse
+    case array.length
+    when 1 then str.to_i
+    when 2 then array[0] + (array[1] * 60)
+    when 3 then array[0] + (array[1] * 60) + (array[2] * 60 * 60)
+    else raise TrimError, "Error: #{str} is not a valid time"
+    end
+  end
+end

data/lib/trim_help.rb

@@ -0,0 +1,55 @@
+class MediaTrim
+  def self.help(msg = nil)
+    puts "Error: #{msg}.\n".red if msg
+    puts <<~END_HELP
+      media_trim - Trim an audio or video file using ffmpeg
+
+      - Works with all formats supported by ffmpeg, including mp3, mp4, mkv, and many more.
+      - Seeks to the nearest frame positions by re-encoding the media.
+      - Reduces file size produced by OBS Studio by over 80 percent.
+      - Can be used as a Ruby gem.
+      - Installs the 'trim' command.
+
+      When run as a command, output files are named by adding a 'trim.' prefix to the media file name, e.g. 'dir/trim.file.ext'.
+      By default, the trim command does not overwrite pre-existing output files.
+      When trimming is complete, the trim command displays the trimmed file, unless the -q option is specified
+
+      Command-line Usage:
+        trim [OPTIONS] dir/file.ext start [[to|for] end]
+
+      - The start and end timecodes have the format [HH:[MM:]]SS[.XXX]
+        Note that decimal seconds may be specified, but frames may not;
+        this is consistent with how ffmpeg parses timecodes.
+      - end defaults to the end of the audio/video file
+
+      OPTIONS are:
+        -d Enable debug output
+        -f Overwrite output file if present
+        -h Display help information.
+        -v Verbose output
+        -V Do not view the trimmed file when complete.
+
+      Examples:
+        # Crop dir/file.mp4 from 15.0 seconds to the end of the video, save to demo/trim.demo.mp4:
+        trim demo/demo.mp4 15
+
+        # Crop dir/file.mkv from 3 minutes, 25 seconds to 9 minutes, 35 seconds, save to demo/trim.demo.mp4:
+        trim demo/demo.mp4 3:25 9:35
+
+        # Same as the previous example, using optional 'to' syntax:
+        trim demo/demo.mp4 3:25 to 9:35
+
+        # Save as the previous example, but specify the duration instead of the end time by using the for keyword:
+        trim demo/demo.mp4 3:25 for 6:10
+
+      Need a way to figure out the start and stop times to trim a video?
+      DJV is an excellent video viewer https://darbyjohnston.github.io/DJV/
+      - allows frame-by-frame stepping
+      - displays the current time reliabily
+      - F/OSS
+      - Mac, Windows, Linux
+      - High quality
+    END_HELP
+    exit 1
+  end
+end

data/lib/trim_main.rb

@@ -0,0 +1,87 @@
+TrimError = Class.new StandardError # Define a new StandardError subclass
+
+class MediaTrim
+  attr_accessor :copy_filename, :fname, :interval, :msg_end, :overwrite, :quiet, :start, :view
+
+  # @param to [String] end timecode; duration not supported for API
+  def initialize(filename = nil, trimmed_filename = nil, start = '0', to = nil, **options)
+    @fname = MediaTrim.expand_env(filename) if filename
+    @copy_filename = MediaTrim.expand_env(trimmed_filename) if trimmed_filename
+    @start = MediaTrim.time_format start
+    @interval = ['-ss', MediaTrim.time_format(@start)]
+
+    @overwrite = options[:overwrite] ? '-y' : '-n'
+    @quiet     = options[:quiet].nil? || options[:quiet] ? ['-hide_banner', '-loglevel', 'error', '-nostats'] : []
+    @view      = options[:view].nil? ? true : options[:view]
+
+    prepare(@start, to, mode: :timecode) if to
+  end
+
+  def options
+    OptionParser.new do |opts|
+      opts.banner = "Usage: #{$PROGRAM_NAME} [options]"
+
+      opts.on('-f', '--[no-]@overwrite', 'Overwrite any previous output') do |f|
+        @overwrite = f ? '-y' : '-n'
+      end
+      opts.on('-v', '--[no-]verbose', 'Run verbosely') do |v|
+        @quiet = [] if v
+      end
+      opts.on('-h', '', 'Display help') do |_|
+        help
+      end
+      opts.on('-V', '--[no-]@view', 'View ffmpeg output') do |v|
+        @view = false if v
+      end
+    end.parse!
+  end
+
+  # @param argv [array] Copy of ARGV
+  def setup(argv)
+    MediaTrim.help 'Please specify the name of the video file to trim' unless argv[0]
+    @fname = MediaTrim.expand_env argv[0]
+    unless File.exist? @fname
+      puts "Error: '#{File.realpath @fname}' does not exist.".red
+      exit 1
+    end
+    original_filename = File.basename @fname, '.*'
+    ext = File.extname @fname
+    @copy_filename = "#{File.dirname @fname}/trim.#{original_filename}#{ext}"
+
+    MediaTrim.help 'Please specify the time to @start trimming the video file from' unless argv[1]
+    @start = MediaTrim.time_format argv[1]
+
+    @interval = ['-ss', @start]
+    @msg_end = ''
+    index = 2
+    return unless argv.length > index
+
+    if argv[index] == 'for' # duration
+      index += 1
+      MediaTrim.help 'No duration was specified' unless argv.length > index
+      to = prepare @start, argv[index], mode: :duration
+    else # end timecode
+      index += 1 if argv[index] == 'to'
+      MediaTrim.help 'No end time was specified' unless argv.length > index
+      to = prepare @start, argv[index], mode: :timecode
+    end
+    return unless @start >= to
+
+    raise TrimError, "Error: @start time (#{@start}) must be before end time (#{to})" if @start >= to
+  end
+
+  def prepare(from, duration_or_timecode, mode: :duration)
+    if mode == :duration
+      timecode = MediaTrim.time_format duration_or_timecode
+      time_end = MediaTrim.add_times from, timecode
+      @interval += ['-t', time_end]
+      @msg_end = " for a duration of #{timecode} (until #{time_end})"
+    else # end timecode was specified
+      time_end = MediaTrim.time_format(MediaTrim.to_seconds(duration_or_timecode))
+      elapsed_time = MediaTrim.duration from, time_end
+      @interval += ['-to', time_end]
+      @msg_end = " to #{time_end} (duration #{elapsed_time})"
+    end
+    time_end
+  end
+end

data/lib/trim_run.rb

@@ -0,0 +1,48 @@
+class MediaTrim
+  def run
+    raise TrimError, 'Error: No filename was specified'.red unless @fname
+    raise TrimError, 'Error: No trimmed filename was specified'.red unless @copy_filename
+    raise TrimError, 'Error: No starting timestamp was specified'.red unless @start
+    raise TrimError, 'Error: Starting timestamp must be a string'.red unless @start.instance_of? String
+
+    puts "Trimming '#{@fname}' from #{@start}#{@msg_end}".cyan
+    command = ['ffmpeg',
+               *@quiet,
+               '-hwaccel', 'auto',
+               @overwrite,
+               '-i', @fname,
+               '-acodec', 'aac',
+               *@interval,
+               @copy_filename]
+    # puts command.join(' ').yellow
+    start_clock = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    status = system(*command)
+    end_clock = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    elapsed = end_clock - start_clock
+    puts "Trim took #{MediaTrim.time_format elapsed.to_i}".cyan
+    $stdout.flush
+    exit 1 unless status
+
+    # View trimmed file unless -q option was specified
+    return unless @view
+
+    # Open in Windows if running in WSL
+    if File.exist? '/mnt/c/Program Files/DJV2/bin/djv.com'
+      realpath = File.realpath @copy_filename
+      windows_path = `wslpath -m '#{realpath}'`.chomp
+      spawn 'cmd.exe', '/c',
+            'C:\\Program Files\\DJV2\\bin\\djv.com',
+            '-full_screen',
+            '-full_screen_monitor', '2',
+            windows_path
+    elsif `which cmd.exe`
+      exec 'cmd.exe', '/C', '@start', @copy_filename, "--extraintf='luaintf{intf=\"looper_custom_time\"}'"
+    elsif `which xdg-open`
+      # Open any file with its default Linux application with xdg-open.
+      # Define default apps in ~/.local/share/applications/defaults.list,
+      # which is read on every invocation.
+      # See https://askubuntu.com/questions/809981/set-the-default-video-player-from-the-command-line
+      exec 'xdg-open', @copy_filename
+    end
+  end
+end

data/media_trim.gemspec

@@ -0,0 +1,73 @@
+require_relative 'lib/media_trim/version' unless defined? MediaTrimVersion::VERSION
+
+Gem::Specification.new do |spec|
+  host = 'https://github.com/mslinn/media_trim'
+
+  spec.authors               = ['Mike Slinn']
+  spec.bindir                = 'exe'
+  spec.description = <<~END_DESC
+    Trim an audio or video file using ffmpeg
+
+    - Works with all formats supported by ffmpeg, including mp3, mp4, mkv, and many more.
+    - Seeks to the nearest frame positions by re-encoding the media.
+    - Reduces file size procduced by OBS Studio by over 80 percent.
+    - Can be used as a Ruby gem.
+    - Installs the 'trim' command.
+
+    When run as a command, output files are named by adding a 'trim.' prefix to the media file name, e.g. 'dir/trim.file.ext'.
+    By default, the trim command does not overwrite pre-existing output files.
+    When trimming is complete, the trim command displays the trimmed file, unless the -q option is specified
+
+    Command-line Usage:
+      trim [OPTIONS] dir/file.ext start [[to|for] end]
+
+    - The start and end timecodes have the format [HH:[MM:]]SS[.XXX]
+      Note that decimal seconds may be specified, bug frames may not;
+      this is consistent with how ffmpeg parses timecodes.
+    - end defaults to end of the audio/video file
+
+    OPTIONS are:
+      -d Enable debug output.
+      -f Overwrite output file if present.
+      -h Display help information.
+      -v Verbose output.
+      -V Do not @view the trimmed file when complete.
+
+    Examples:
+      # Crop dir/file.mp4 from 15.0 seconds to the end of the video, save to demo/trim.demo.mp4:
+      trim demo/demo.mp4 15
+
+      # Crop dir/file.mkv from 3 minutes, 25 seconds to 9 minutes, 35 seconds, save to demo/trim.demo.mp4:
+      trim demo/demo.mp4 3:25 9:35
+
+      # Same as the previous example, using optional 'to' syntax:
+      trim demo/demo.mp4 3:25 to 9:35
+
+      # Save as the previous example, but specify the duration instead of the end time by using the for keyword:
+      trim demo/demo.mp4 3:25 for 6:10
+  END_DESC
+  spec.email                 = ['mslinn@mslinn.com']
+  spec.files                 = Dir['.rubocop.yml', 'LICENSE.*', 'Rakefile', '{exe,lib,spec}/**/*', '*.gemspec', '*.md']
+  spec.executables           = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.homepage              = 'https://www.mslinn.com/av_studio/425-trimming-media.html'
+  spec.license               = 'MIT'
+  spec.metadata = {
+    'allowed_push_host' => 'https://rubygems.org',
+    'bug_tracker_uri'   => "#{host}/issues",
+    'changelog_uri'     => "#{host}/CHANGELOG.md",
+    'homepage_uri'      => spec.homepage,
+    'source_code_uri'   => host,
+  }
+  spec.name                 = 'media_trim'
+  spec.post_install_message = <<~END_MESSAGE
+
+    Thanks for installing #{spec.name} v#{MediaTrimVersion::VERSION}!
+
+  END_MESSAGE
+  spec.require_paths         = ['lib']
+  spec.required_ruby_version = '>= 2.5.0'
+  spec.summary               = 'Trim an audio or video file using ffmpeg'
+  spec.version               = MediaTrimVersion::VERSION
+
+  spec.add_dependency 'colorator'
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require_relative '../lib/media_trim'
+
+RSpec.configure do |config|
+  config.filter_run_when_matching focus: true
+  # config.order = 'random'
+
+  # See https://relishapp.com/rspec/rspec-core/docs/command-line/only-failures
+  config.example_status_persistence_file_path = '../spec/status_persistence.txt'
+end

data/spec/trim_api_spec.rb

@@ -0,0 +1,43 @@
+require_relative '../lib/media_trim'
+
+# Tests API argument handling
+RSpec.describe(MediaTrim) do
+  it 'initializes with only start timecode' do
+    mt = described_class.new 'demo/demo.mp4', 'demo/trim.demo.mp4', '0'
+    expect(mt.fname).to         eq('demo/demo.mp4')
+    expect(mt.copy_filename).to eq('demo/trim.demo.mp4')
+    expect(mt.start).to         eq('00:00')
+    expect(mt.interval).to      eq(['-ss', '00:00'])
+    expect(mt.msg_end).to       be_nil
+  end
+
+  it 'initializes with end timecode' do
+    mt = described_class.new 'demo/demo.mp4', 'demo/trim.demo.mp4', '0', '1'
+    expect(mt.fname).to         eq('demo/demo.mp4')
+    expect(mt.copy_filename).to eq('demo/trim.demo.mp4')
+    expect(mt.start).to         eq('00:00')
+    expect(mt.interval).to      eq(['-ss', '00:00', '-to', '00:01'])
+    expect(mt.msg_end).to       eq(' to 00:01 (duration 00:01)')
+  end
+
+  it 'initializes when overwrite is specified' do
+    mt = described_class.new 'demo/demo.mp4', 'demo/trim.demo.mp4', '0', overwrite: true
+    expect(mt.overwrite).to be_truthy
+    expect(mt.quiet).not_to be_empty
+    expect(mt.view).to be_truthy
+  end
+
+  it 'initializes when quiet is specified' do
+    mt = described_class.new 'demo/demo.mp4', 'demo/trim.demo.mp4', '0', quiet: false
+    expect(mt.overwrite).to eq('-n')
+    expect(mt.quiet).to be_empty
+    expect(mt.view).to be_truthy
+  end
+
+  it 'initializes when view is specified' do
+    mt = described_class.new 'demo/demo.mp4', 'demo/trim.demo.mp4', '0', view: false
+    expect(mt.overwrite).to eq('-n')
+    expect(mt.quiet).not_to be_empty
+    expect(mt.view).to be_falsey
+  end
+end

data/spec/trim_command_line_spec.rb

@@ -0,0 +1,31 @@
+require_relative '../lib/media_trim'
+
+# Tests command line argument handling
+RSpec.describe(MediaTrim) do
+  mt = described_class.new
+
+  it 'prepares duration' do
+    mt.prepare '1', '1', mode: :duration
+    expect(mt.msg_end).to eq(' for a duration of 00:01 (until 00:02)')
+  end
+
+  it 'prepares end timecode' do
+    mt.prepare '1', '2', mode: :timecode
+    expect(mt.msg_end).to eq(' to 00:02 (duration 00:01)')
+  end
+
+  it 'sets up duration' do
+    mt.setup ['demo/demo.mp4', '1', 'for', '1']
+    expect(mt.msg_end).to eq(' for a duration of 00:01 (until 00:02)')
+  end
+
+  it 'sets up end timecode with to' do
+    mt.setup ['demo/demo.mp4', '1', 'to', '2']
+    expect(mt.msg_end).to eq(' to 00:02 (duration 00:01)')
+  end
+
+  it 'sets up end timecode' do
+    mt.setup ['demo/demo.mp4', '1', '2']
+    expect(mt.msg_end).to eq(' to 00:02 (duration 00:01)')
+  end
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: media_trim
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Mike Slinn
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2023-11-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colorator
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |
+  Trim an audio or video file using ffmpeg
+
+  - Works with all formats supported by ffmpeg, including mp3, mp4, mkv, and many more.
+  - Seeks to the nearest frame positions by re-encoding the media.
+  - Reduces file size procduced by OBS Studio by over 80 percent.
+  - Can be used as a Ruby gem.
+  - Installs the 'trim' command.
+
+  When run as a command, output files are named by adding a 'trim.' prefix to the media file name, e.g. 'dir/trim.file.ext'.
+  By default, the trim command does not overwrite pre-existing output files.
+  When trimming is complete, the trim command displays the trimmed file, unless the -q option is specified
+
+  Command-line Usage:
+    trim [OPTIONS] dir/file.ext start [[to|for] end]
+
+  - The start and end timecodes have the format [HH:[MM:]]SS[.XXX]
+    Note that decimal seconds may be specified, bug frames may not;
+    this is consistent with how ffmpeg parses timecodes.
+  - end defaults to end of the audio/video file
+
+  OPTIONS are:
+    -d Enable debug output.
+    -f Overwrite output file if present.
+    -h Display help information.
+    -v Verbose output.
+    -V Do not @view the trimmed file when complete.
+
+  Examples:
+    # Crop dir/file.mp4 from 15.0 seconds to the end of the video, save to demo/trim.demo.mp4:
+    trim demo/demo.mp4 15
+
+    # Crop dir/file.mkv from 3 minutes, 25 seconds to 9 minutes, 35 seconds, save to demo/trim.demo.mp4:
+    trim demo/demo.mp4 3:25 9:35
+
+    # Same as the previous example, using optional 'to' syntax:
+    trim demo/demo.mp4 3:25 to 9:35
+
+    # Save as the previous example, but specify the duration instead of the end time by using the for keyword:
+    trim demo/demo.mp4 3:25 for 6:10
+email:
+- mslinn@mslinn.com
+executables:
+- trim
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CHANGELOG.md
+- README.md
+- Rakefile
+- exe/trim
+- lib/media_trim.rb
+- lib/media_trim/version.rb
+- lib/trim_class.rb
+- lib/trim_help.rb
+- lib/trim_main.rb
+- lib/trim_run.rb
+- media_trim.gemspec
+- spec/spec_helper.rb
+- spec/trim_api_spec.rb
+- spec/trim_command_line_spec.rb
+homepage: https://www.mslinn.com/av_studio/425-trimming-media.html
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  bug_tracker_uri: https://github.com/mslinn/media_trim/issues
+  changelog_uri: https://github.com/mslinn/media_trim/CHANGELOG.md
+  homepage_uri: https://www.mslinn.com/av_studio/425-trimming-media.html
+  source_code_uri: https://github.com/mslinn/media_trim
+post_install_message: |2+
+
+  Thanks for installing media_trim v0.2.0!
+
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Trim an audio or video file using ffmpeg
+test_files: []
+...