video2gif 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a792d0bc3ded611a4295f7195ab17fbe5a71c65ae84bc527eb02c9f6c667088c
+  data.tar.gz: f17cfefa5ef240925a2915ae089df6c7d9eacd7bf2d1ac449bce6f707a2a15c7
+SHA512:
+  metadata.gz: ba5e69371e4edb486ff79a7ffa539cbf656c3edf1bc1794f58a02add3240fd81acadaaba8502b123990e09efa1d630560b4a20357d747f3349b3f9314864a9aa
+  data.tar.gz: 243ddc56a97b5470d7771e90731dafbb9d0c69c2427e406a4f6f664305fe6d1bd40b27cf29b8a99221dabcce6d76a562ea5321767e161cdf72be165a2a2f94a3

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.1
+before_install: gem install bundler -v 2.0.1

data/CONTRIBUTING.md

@@ -0,0 +1,26 @@
+Contributing
+============
+
+Performance improvements, bug fixes, and compatibility improvements are
+welcome, provided that the change matches the style of the rest of the
+plugin, does not introduce needless complexity, and complies with the
+following guidelines for commits and pull requests.
+
+
+Commits and Pull Requests
+-------------------------
+
+Each commit should contain a single, discrete change which does not
+break when applied in isolation. It should be possible to use
+`git-bisect(1)` on your commits. Do not use merge commits.
+
+Each commit message should begin with a title of about fifty characters
+in length, written in the active tense, imperative mood describing the
+change briefly, followed by a blank line, followed by a longer
+description of the change hard-wrapped to seventy-two columns or less.
+The description should state why the change was necessary.
+
+A pull request may have multiple commits if necessary. Each pull request
+should address a single problem. It should describe the problem it
+addresses and how it intends to solve it. The commits for that pull
+request should solve the problem.

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in video2gif.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,41 @@
+PATH
+  remote: .
+  specs:
+    video2gif (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coderay (1.1.2)
+    diff-lcs (1.3)
+    method_source (0.9.2)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (10.5.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  pry
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  video2gif!
+
+BUNDLED WITH
+   2.0.1

data/LICENSE.txt

@@ -0,0 +1,125 @@
+https://creativecommons.org/publicdomain/zero/1.0/legalcode
+
+  CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+  LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+  ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+  INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+  REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+  PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+  THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+  HEREUNDER.
+
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work
+of authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without
+fear of later claims of infringement build upon, modify, incorporate in
+other works, reuse and redistribute as freely as possible in any form
+whatsoever and for any purposes, including without limitation commercial
+purposes. These owners may contribute to the Commons to promote the
+ideal of a free culture and the further production of creative, cultural
+and scientific works, or to gain reputation or greater distribution for
+their Work in part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or
+she is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under
+its terms, with knowledge of his or her Copyright and Related Rights in
+the Work and the meaning and intended legal effect of CC0 on those
+rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may
+   be protected by copyright and related or neighboring rights
+   ("Copyright and Related Rights"). Copyright and Related Rights
+   include, but are not limited to, the following:
+
+       i. the right to reproduce, adapt, distribute, perform, display,
+          communicate, and translate a Work;
+      ii. moral rights retained by the original author(s) and/or
+          performer(s);
+     iii. publicity and privacy rights pertaining to a person's image or
+          likeness depicted in a Work;
+      iv. rights protecting against unfair competition in regards to a
+          Work, subject to the limitations in paragraph 4(a), below;
+       v. rights protecting the extraction, dissemination, use and reuse
+          of data in a Work;
+      vi. database rights (such as those arising under Directive 96/9/EC
+          of the European Parliament and of the Council of 11 March 1996
+          on the legal protection of databases, and under any national
+          implementation thereof, including any amended or successor
+          version of such directive); and
+     vii. other similar, equivalent or corresponding rights throughout
+          the world based on applicable law or treaty, and any national
+          implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+   of, applicable law, Affirmer hereby overtly, fully, permanently,
+   irrevocably and unconditionally waives, abandons, and surrenders all
+   of Affirmer's Copyright and Related Rights and associated claims and
+   causes of action, whether now known or unknown (including existing as
+   well as future claims and causes of action), in the Work (i) in all
+   territories worldwide, (ii) for the maximum duration provided by
+   applicable law or treaty (including future time extensions), (iii) in
+   any current or future medium and for any number of copies, and (iv)
+   for any purpose whatsoever, including without limitation commercial,
+   advertising or promotional purposes (the "Waiver"). Affirmer makes
+   the Waiver for the benefit of each member of the public at large and
+   to the detriment of Affirmer's heirs and successors, fully intending
+   that such Waiver shall not be subject to revocation, rescission,
+   cancellation, termination, or any other legal or equitable action to
+   disrupt the quiet enjoyment of the Work by the public as contemplated
+   by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+   be judged legally invalid or ineffective under applicable law, then
+   the Waiver shall be preserved to the maximum extent permitted taking
+   into account Affirmer's express Statement of Purpose. In addition, to
+   the extent the Waiver is so judged Affirmer hereby grants to each
+   affected person a royalty-free, non transferable, non sublicensable,
+   non exclusive, irrevocable and unconditional license to exercise
+   Affirmer's Copyright and Related Rights in the Work (i) in all
+   territories worldwide, (ii) for the maximum duration provided by
+   applicable law or treaty (including future time extensions), (iii) in
+   any current or future medium and for any number of copies, and (iv)
+   for any purpose whatsoever, including without limitation commercial,
+   advertising or promotional purposes (the "License"). The License
+   shall be deemed effective as of the date CC0 was applied by Affirmer
+   to the Work. Should any part of the License for any reason be judged
+   legally invalid or ineffective under applicable law, such partial
+   invalidity or ineffectiveness shall not invalidate the remainder of
+   the License, and in such case Affirmer hereby affirms that he or she
+   will not (i) exercise any of his or her remaining Copyright and
+   Related Rights in the Work or (ii) assert any associated claims and
+   causes of action with respect to the Work, in either case contrary to
+   Affirmer's express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+  a. No trademark or patent rights held by Affirmer are waived,
+     abandoned, surrendered, licensed or otherwise affected by this
+     document.
+  b. Affirmer offers the Work as-is and makes no representations or
+     warranties of any kind concerning the Work, express, implied,
+     statutory or otherwise, including without limitation warranties of
+     title, merchantability, fitness for a particular purpose, non
+     infringement, or the absence of latent or other defects, accuracy,
+     or the present or absence of errors, whether or not discoverable,
+     all to the greatest extent permissible under applicable law.
+  c. Affirmer disclaims responsibility for clearing rights of other
+     persons that may apply to the Work or any use thereof, including
+     without limitation any person's Copyright and Related Rights in the
+     Work. Further, Affirmer disclaims responsibility for obtaining any
+     necessary consents, permissions or other rights required for any
+     use of the Work.
+  d. Affirmer understands and acknowledges that Creative Commons is not
+     a party to this document and has no duty or obligation with respect
+     to this CC0 or use of the Work.

data/README.md

@@ -0,0 +1,63 @@
+video2gif
+=========
+
+`video2gif` eases converting any video into a GIF.
+
+It uses [FFMpeg] and optionally [ImageMagick], so it understands any
+video that [FFMpeg] does. It has an array of options to allow you to
+select the part of the video you want, crop it automatically, overlay
+text, and manipulate the color and brightness.
+
+
+Installation
+------------
+
+`video2gif` requires a recent version of [FFMpeg] installed and
+available in the system `$PATH`. If you can run `ffmpeg` from the
+command line, you're probably good. If not, use your favorite package
+manager to install it.
+
+If you install [ImageMagick], further optimization will automatically
+take place on the resulting GIF.
+
+Note that some features may not be available by default. For example,
+tonemapping (used for HDR videos) requires `libzimg` support, not
+included by default in the [FFMpeg] supplied by [Homebrew].
+
+`video2gif` also requires Ruby and the ability to install a new gem. If
+you have this available, run the following command to install it.
+
+    gem install video2gif
+
+
+Usage
+-----
+
+The general syntax for the command follows.
+
+    video2gif <input video> [-o <output filename>] [<options>]
+
+Use `video2gif --help` to see all the options available. Given an input
+video, `video2gif` has a reasonable set of defaults to output a GIF of
+the same size and with the same name in the same directory. However,
+using the options available, you can change the output filename and the
+appearance of the resulting GIF.
+
+_Further documentation to come._
+
+
+License
+-------
+
+This gem is released into the public domain (CC0 license). For details,
+see: https://creativecommons.org/publicdomain/zero/1.0/legalcode
+
+
+Contributing
+------------
+
+To contribute to this plugin, find it on GitHub. Please see the
+[CONTRIBUTING](CONTRIBUTING.markdown) file accompanying it for
+guidelines.
+
+https://github.com/emilyst/video2gif

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'video2gif'
+
+# You can add fixtures and/or initialization code here to make
+# experimenting with your gem easier. You can also use a different
+# console, if you like.
+
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/video2gif

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'video2gif'
+
+Video2gif.run

data/lib/video2gif/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Video2gif
+  VERSION = '0.0.1'
+end

data/lib/video2gif.rb

@@ -0,0 +1,439 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require 'open3'
+require 'logger'
+
+require 'video2gif/version'
+
+
+module Video2gif
+  def self.is_executable?(command)
+    ENV['PATH'].split(File::PATH_SEPARATOR).map do |path|
+      (ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']).map do |extension|
+        File.executable?(File.join(path, "#{command}#{extension}"))
+      end
+    end.flatten.any?
+  end
+
+  def self.parse_args(args, logger)
+    options = {}
+
+    parser = OptionParser.new do |parser|
+      parser.banner = 'Usage: video2gif <video> [options] [<output GIF filename>]'
+      parser.separator ''
+      parser.separator 'General GIF options:'
+
+      parser.on('-s SEEK',
+                '--seek SEEK',
+                'Set time to seek to in the input video (use a count of',
+                'seconds or HH:MM:SS.SS format)') do |s|
+        options[:seek] = s
+      end
+
+      parser.on('-t TIME',
+                '--time TIME',
+                'Set duration to use from the input video (use a count of',
+                'seconds)') do |t|
+        options[:time] = t
+      end
+
+      parser.on('-f FRAMES',
+                '--fps FRAMES',
+                'Set frames per second for the resulting GIF') do |f|
+        options[:fps] = f
+      end
+
+      parser.on('-w WIDTH',
+                '--width WIDTH',
+                'Scale the width of the resulting GIF in pixels (aspect',
+                'ratio is preserved)') do |w|
+        options[:width] = w
+      end
+
+      # parser.on('-hHEIGHT', '--height=HEIGHT', 'Scale the height of the resulting GIF') do |h|
+      #   options[:height] = h
+      # end
+
+      parser.on('-p PALETTE',
+                '--palette PALETTE',
+                'Set the palette size of the resulting GIF (maximum of 255',
+                'colors)') do |p|
+        options[:palette] = p
+      end
+
+      parser.on('-c SIZE',
+                '--crop-size-w SIZE',
+                'Pixel size of width to select from source video, before scaling') do |s|
+        options[:wregion] = s
+      end
+
+      parser.on('-h SIZE',
+                '--crop-size-h SIZE',
+                'Pixel size of height to select from source video, before scaling') do |s|
+        options[:hregion] = s
+      end
+
+      parser.on('-x OFFSET',
+                '--crop-offset-x OFFSET',
+                'Pixel offset from left to select from source video, before scaling') do |o|
+        options[:xoffset] = o
+      end
+
+      parser.on('-y OFFSET',
+                '--crop-offset-y OFFSET',
+                'Pixel offset from top to select from source video, before scaling') do |o|
+        options[:yoffset] = o
+      end
+
+      parser.on('-d [THRESHOLD]',
+                '--crop-detect [THRESHOLD]',
+                'Attempt automatic cropping based on black region, scaled',
+                'from 0 (nothing) to 255 (everything), default threshold 24') do |c|
+        options[:cropdetect] = c || 24
+      end
+
+      parser.on('-o',
+                '--[no-]optimize',
+                'Attempt to optimize GIF size with ImageMagick (default yes if available)') do |o|
+        options[:optimize] = o
+      end
+
+      parser.on('--contrast CONTRAST',
+                'Apply contrast adjustment, scaled from -2.0 to 2.0 (default 1)') do |c|
+        options[:contrast] = c
+        options[:eq] = true
+      end
+
+      parser.on('--brightness BRIGHTNESS',
+                'Apply brightness adjustment, scaled from -1.0 to 1.0 (default 0)') do |b|
+        options[:brightness] = b
+        options[:eq] = true
+      end
+
+      parser.on('--saturation SATURATION',
+                'Apply saturation adjustment, scaled from 0.0 to 3.0 (default 1)') do |s|
+        options[:saturation] = s
+        options[:eq] = true
+      end
+
+      parser.on('--gamma GAMMA',
+                'Apply gamma adjustment, scaled from 0.1 to 10.0 (default 1)') do |g|
+        options[:gamma] = g
+        options[:eq] = true
+      end
+
+      parser.on('--red-gamma GAMMA',
+                'Apply red channel gamma adjustment, scaled from 0.1 to 10.0 (default 1)') do |g|
+        options[:gamma_r] = g
+        options[:eq] = true
+      end
+
+      parser.on('--green-gamma GAMMA',
+                'Apply green channel gamma adjustment, scaled from 0.1 to 10.0 (default 1)') do |g|
+        options[:gamma_g] = g
+        options[:eq] = true
+      end
+
+      parser.on('--blue-gamma GAMMA',
+                'Apply blue channel gamma adjustment, scaled from 0.1 to 10.0 (default 1)') do |g|
+        options[:gamma_b] = g
+        options[:eq] = true
+      end
+
+      parser.on('--tonemap [ALGORITHM]',
+                'Attempt to force tonemapping from HDR (BT.2020) to SDR',
+                '(BT.709) using algorithm (experimental, requires ffmpeg with',
+                'libzimg) (default "hable", "mobius" is a good alternative)') do |t|
+        options[:tonemap] = t || 'hable'
+      end
+
+      parser.separator ''
+      parser.separator 'Text overlay options (only used if text is defined):'
+
+      parser.on('-T TEXT',
+                '--text TEXT',
+                'Set text to overlay on the GIF (use "\n" for line breaks)') do |p|
+        options[:text] = p
+      end
+
+      parser.on('-C TEXTCOLOR',
+                '--text-color TEXTCOLOR',
+                'Set the color for text overlay') do |p|
+        options[:textcolor] = p
+      end
+
+      parser.on('-S TEXTSIZE',
+                '--text-size TEXTSIZE',
+                'Set the point size for text overlay') do |p|
+        options[:textsize] = p
+      end
+
+      parser.on('-B TEXTBORDER',
+                '--text-border TEXTBORDER',
+                'Set the width of the border for text overlay') do |p|
+        options[:textborder] = p
+      end
+
+      parser.on('-F TEXTFONT',
+                '--text-font TEXTFONT',
+                'Set the font name for text overlay') do |p|
+        options[:textfont] = p
+      end
+
+      parser.on('-V TEXTSTYLE',
+                '--text-variant TEXTVARIANT',
+                'Set the font variant for text overlay (e.g., "Semibold")') do |p|
+        options[:textvariant] = p
+      end
+
+      parser.on('-X TEXTXPOS',
+                '--text-x-position TEXTXPOS',
+                'Set the X position for the text, starting from left (default is center)') do |p|
+        options[:xpos] = p
+      end
+
+      parser.on('-Y TEXTXPOS',
+                '--text-y-position TEXTYPOS',
+                'Set the Y position for the text, starting from top (default is near bottom)') do |p|
+        options[:ypos] = p
+      end
+
+      parser.separator ''
+      parser.separator 'Other options:'
+
+      parser.on_tail('-v', '--verbose', 'Show ffmpeg command executed and output') do |p|
+        options[:verbose] = p
+      end
+
+      parser.on_tail('-q', '--quiet', 'Suppress all log output (overrides verbose)') do |p|
+        options[:quiet] = p
+      end
+
+      parser.on_tail('-h', '--help', 'Show this message') do
+        puts parser
+        exit
+      end
+
+      parser.parse!(args)
+    end
+
+    parser.parse!
+
+    unless is_executable?('ffmpeg')
+      puts 'ERROR: Requires FFmpeg to be installed!'
+      exit 1
+    end
+
+    if args.size < 1 || args.size > 2
+      puts 'ERROR: Specify one video to convert at a time!'
+      puts ''
+      puts parser.help
+      exit 1
+    end
+
+    unless File.exists?(args[0])
+      puts "ERROR: Specified video file does not exist: #{args[0]}!"
+      puts ''
+      puts parser.help
+      exit
+    end
+
+    if !is_executable?('convert') && options[:optimize]
+      logger.warn('ImageMagick isn\'t available! Optimization will be'\
+                  ' disabled!') unless options[:quiet]
+      options[:optimize] = false
+    end
+
+    options
+  end
+
+  def self.build_filter_complex(options)
+    fps          = options[:fps]     || 15
+    palette_size = options[:palette] || 256
+    width        = options[:width]   # default is not to scale at all
+
+    # create filter elements
+    fps_filter        = "fps=#{fps}"
+    crop_filter       = options[:cropdetect] || 'crop=' + %W[
+                                                   w=#{ options[:wregion] || 'in_w' }
+                                                   h=#{ options[:hregion] || 'in_h' }
+                                                   x=#{ options[:xoffset] || 0 }
+                                                   y=#{ options[:yoffset] || 0 }
+                                                ].join(':')
+    scale_filter      = "scale=#{width}:-1:flags=lanczos:sws_dither=none" if options[:width] unless options[:tonemap]
+    tonemap_filters   = if options[:tonemap]  # TODO: detect input format
+                          %W[
+                            zscale=w=#{width}:h=-1
+                            zscale=t=linear:npl=100
+                            format=yuv420p10le
+                            zscale=p=bt709
+                            tonemap=tonemap=#{options[:tonemap]}:desat=0
+                            zscale=t=bt709:m=bt709:r=tv
+                            format=yuv420p
+                          ].join(',')
+                        end
+    eq_filter         = if options[:eq]
+                          'eq=' + %W[
+                            contrast=#{options[:contrast] || 1}
+                            brightness=#{options[:brightness] || 0}
+                            saturation=#{options[:saturation] || 1}
+                            gamma=#{options[:gamma] || 1}
+                            gamma_r=#{options[:gamma_r] || 1}
+                            gamma_g=#{options[:gamma_g] || 1}
+                            gamma_b=#{options[:gamma_b] || 1}
+                          ].join(':')
+                        end
+    palettegen_filter = "palettegen=max_colors=#{palette_size}:stats_mode=diff"
+    paletteuse_filter = 'paletteuse=dither=sierra2_4a:diff_mode=rectangle'
+    drawtext_filter   = if options[:text]
+                          count_of_lines = options[:text].scan(/\\n/).count + 1
+
+                          x      = options[:xpos]        || '(main_w/2-text_w/2)'
+                          y      = options[:ypos]        || "(main_h-line_h*1.5*#{count_of_lines})"
+                          size   = options[:textsize]    || 32
+                          color  = options[:textcolor]   || 'white'
+                          border = options[:textborder]  || 3
+                          font   = options[:textfont]    || 'Arial'
+                          style  = options[:textvariant] || 'Bold'
+                          text   = options[:text]
+                            .gsub(/\\n/,                                                        '')
+                            .gsub(/([:])/,                                                      '\\\\\\\\\\1')
+                            .gsub(/([,])/,                                                      '\\\\\\1')
+                            .gsub(/\b'\b/,                                                      "\u2019")
+                            .gsub(/\B"\b([^"\u201C\u201D\u201E\u201F\u2033\u2036\r\n]+)\b?"\B/, "\u201C\\1\u201D")
+                            .gsub(/\B'\b([^'\u2018\u2019\u201A\u201B\u2032\u2035\r\n]+)\b?'\B/, "\u2018\\1\u2019")
+
+                          'drawtext=' + %W[
+                            x='#{x}'
+                            y='#{y}'
+                            fontsize='#{size}'
+                            fontcolor='#{color}'
+                            borderw='#{border}'
+                            fontfile='#{font}'\\\\:style='#{style}'
+                            text='#{text}'
+                          ].join(':')
+                        end
+
+    filter_complex = []
+
+    # first, apply the same filters we'll use later in the same order
+    # before applying the palettegen so that we accurately predict the
+    # final palette
+    filter_complex << fps_filter
+    filter_complex << crop_filter if crop_filter
+    filter_complex << scale_filter if options[:width] unless options[:tonemap]
+    filter_complex << tonemap_filters if options[:tonemap]
+    filter_complex << eq_filter if options[:eq]
+    filter_complex << drawtext_filter if options[:text]
+
+    # then generate the palette (and label this filter stream)
+    filter_complex << palettegen_filter + '[palette]'
+
+    # then refer back to the first video input stream and the filter
+    # complex stream to apply the generated palette to the video stream
+    # along with the other filters (drawing text last so that it isn't
+    # affected by scaling)
+    filter_complex << '[0:v][palette]' + paletteuse_filter
+    filter_complex << fps_filter
+    filter_complex << crop_filter if crop_filter
+    filter_complex << scale_filter if options[:width] unless options[:tonemap]
+    filter_complex << tonemap_filters if options[:tonemap]
+    filter_complex << eq_filter if options[:eq]
+    filter_complex << drawtext_filter if options[:text]
+
+    filter_complex.join(',')
+  end
+
+  def self.build_output_filename(args)
+    if args[1]
+      args[1].end_with?('.gif') ? args[1] : args[1] + '.gif'
+    else
+      File.join(File.dirname(args[0]),
+                File.basename(args[0], '.*') + '.gif')
+    end
+  end
+
+  def self.build_ffmpeg_gif_command(args, options, logger)
+    command = []
+    command << 'ffmpeg'
+    command << '-y'  # always overwrite
+    command << '-analyzeduration' << '2147483647' << '-probesize' << '2147483647'
+    command << '-nostdin'
+    command << '-ss' << options[:seek] if options[:seek]
+    command << '-t' << options[:time] if options[:time]
+    command << '-i' << args[0]
+    command << '-filter_complex' << build_filter_complex(options)
+    command << '-f' << 'gif'
+
+    # if we're not optimizing, we won't send to stdout
+    command << (options[:optimize] ? '-' : build_output_filename(args))
+
+    logger.info(command.join(' ')) if options[:verbose] unless options[:quiet]
+
+    command
+  end
+
+  def self.build_convert_optimize_command(args, options, logger)
+    command = []
+    command << 'convert' << '-' << '-layers' << 'Optimize' << build_output_filename(args)
+
+    logger.info(command.join(' ')) if options[:verbose] unless options[:quiet]
+
+    command
+  end
+
+  def self.build_ffmpeg_cropdetect_command(args, options, logger)
+    command = []
+    command << 'ffmpeg'
+    command << '-analyzeduration' << '2147483647' << '-probesize' << '2147483647'
+    command << '-nostdin'
+    command << '-ss' << options[:seek] if options[:seek]
+    command << '-t' << options[:time] if options[:time]
+    command << '-i' << args[0]
+    command << '-filter_complex' << "cropdetect=limit=#{options[:cropdetect]}"
+    command << '-f' << 'null'
+    command << '-'
+
+    logger.info(command.join(' ')) if options[:verbose] unless options[:quiet]
+
+    command
+  end
+
+  def self.run
+    logger = Logger.new(STDOUT)
+    options = parse_args(ARGV, logger)
+
+    if options[:cropdetect]
+      Open3.popen3(*build_ffmpeg_cropdetect_command(ARGV, options, logger)) do |stdin, stdout, stderr, wait_thr|
+        stdin.close
+        stdout.close
+        stderr.each(chomp: true) do |line|
+          logger.info(line) if options[:verbose] unless options[:quiet]
+          options[:cropdetect] = line.match('crop=([0-9]+\:[0-9]+\:[0-9]+\:[0-9]+)') if line.include?('Parsed_cropdetect')
+        end
+        stderr.close
+
+        raise "Process #{wait_thr.pid} failed! Try again with --verbose to see error." unless wait_thr.value.success?
+      end
+    end
+
+    gif_pipeline_items = [build_ffmpeg_gif_command(ARGV, options, logger)]
+    gif_pipeline_items << build_convert_optimize_command(ARGV, options, logger) if options[:optimize]
+
+    read_io, write_io = IO.pipe
+    Open3.pipeline_start(*gif_pipeline_items, out: write_io, err: write_io) do |threads|
+      write_io.close
+      if options[:verbose]
+        read_io.each(chomp: true) { |line| logger.info(line) unless options[:quiet] }
+      else
+        read_io.read(1024) until read_io.eof?
+      end
+      read_io.close
+
+      threads.each do |t|
+        raise "Process #{t.pid} failed! Try again with --verbose to see error." unless t.value.success?
+      end
+    end
+  end
+end

data/video2gif.gemspec

@@ -0,0 +1,43 @@
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'video2gif/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'video2gif'
+  spec.version       = Video2gif::VERSION
+  spec.authors       = ['Emily St.']
+  spec.email         = ['hello@emily.st']
+
+  spec.summary       = %q{Automate converting videos to GIFs using FFMpeg}
+  spec.homepage      = 'https://github.com/emilyst/video2gif'
+  spec.license       = 'CC0'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set
+  # the 'allowed_push_host' to allow pushing to a single host or delete
+  # this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org/'
+    spec.metadata['homepage_uri'] = spec.homepage
+    spec.metadata['source_code_uri'] = "https://github.com/emilyst/video2gif"
+    # spec.metadata['changelog_uri'] = "https://github.com/emilyst/video2gif"
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
+  end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been
+  # added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: video2gif
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Emily St.
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-04-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- hello@emily.st
+executables:
+- video2gif
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CONTRIBUTING.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/video2gif
+- lib/video2gif.rb
+- lib/video2gif/version.rb
+- video2gif.gemspec
+homepage: https://github.com/emilyst/video2gif
+licenses:
+- CC0
+metadata:
+  allowed_push_host: https://rubygems.org/
+  homepage_uri: https://github.com/emilyst/video2gif
+  source_code_uri: https://github.com/emilyst/video2gif
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Automate converting videos to GIFs using FFMpeg
+test_files: []