muvy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 86d7b6a8c11d0ce8195f6d35bf9400028771c85a
+  data.tar.gz: a8c38340f7e011b1821f89f0e6ce7f040382dfd9
+SHA512:
+  metadata.gz: 209b168a3b90bd569a48504295a4a745adbaf4e08c46d742d73b9027d12624fa6327dc9369fe738fbaf8a65f27f4d8668b048279eefb7723c4bd930397677122
+  data.tar.gz: 9bbcaa4a1ff2a929d2d1983d493e387b3f9124c104a9e74e6c9b5b84c6670e6266eed611b69fad1097873c4d009b473a1c99214df8cdae231f8a11f6d62859d4

data/.gitignore

@@ -0,0 +1,54 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.15.4

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Aaron Agarunov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,172 @@
+![muvy-header](https://i.imgur.com/Akc3Fh9.png)
+
+**muvy** is a simple Ruby movie barcode generator.  
+You can feed it a youtube video, phone gallery, or any locally stored video files. It pulls most of the frames out, moves around the colors, and throws them back together in a neat montage.
+
+------
+* [Install](#install)
+  * [Notes](#notes)
+  * [Getting Started](#getting-started)
+* [Usage](#usage)
+  * [Basics](#basics)
+  * [Options](#options)
+  * [Features](#features)
+* [Examples](#examples)
+* [Links](#links)
+------
+
+## Install
+
+### Notes
+
+* Currently version 0.2.0, with many [features still planned](#features).
+
+### Getting Started
+
+#### macOS
+If you don't already have FFmpeg, ImageMagick, or youtube-dl installed, you can download all of them with [Homebrew](https://brew.sh/). You can use `ffmpeg -v`, `convert -v`, or `youtube-dl --version` at the terminal to check if you've already got them.
+
+With Homewbrew, just bring up a terminal session and type:  
+```sh
+$ brew install ffmpeg
+$ brew install imagemagick
+$ brew install youtube-dl
+$ gem install muvy
+```
+
+#### Windows
+1. You can [download Ruby here](https://rubyinstaller.org/).  
+2. Then you can grab [FFmpeg here](http://ffmpeg.zeranoe.com/builds/).   
+3. ..and then download [ImageMagick here](https://www.imagemagick.org/script/download.php#windows), **noting**:
+  * On the nth installation window, you need to check 2 boxes:
+    * [x] Add folder to your path variable
+    * [x] Download legacy binaries
+4. And finally get [youtube-dl here](https://rg3.github.io/youtube-dl/download.html).   
+5. Then, you can install any gem like so:  
+```sh
+$ gem install muvy
+```
+
+
+## Usage
+
+### Basics
+
+| Type   | Command: `muvy [Type] [Options]`                                    | Support                                                                                       |
+|--------|--------------------------------------------|-----------------------------------------------------------------------------------------------|
+| URL    | `muvy https://someVideoSite.com/someVidID` | [youtube-dl supported sites](https://rg3.github.io/youtube-dl/supportedsites.html) |
+| Local  | `muvy /Documents/Fave-Films/movie.mp4`  | [FFmpeg supported formats](https://www.ffmpeg.org/general.html#File-Formats)                                                      |
+| Folder | `muvy /Downloads/Phone-Backup-1/Photos`   | [ImageMagick supported formats](https://www.imagemagick.org/script/formats.php)                                                 |
+
+### Options
+
+#### `-p, --path`
+
+Optionally specify the path where your final image will be saved.  
+**Default**: your present working directory
+
+#### `-s, --style`
+Optionally specify currently supported styles: [solid](link) or [stretch](link).  
+**Default**: solid
+
+#### `-g, --gradient`
+Optionally add a gradient on top of the final image.
+
+Choose one:
+```
+black:heavy black:medium black:light
+white:heavy white:medium white:light
+```
+**Default**: none
+
+[See examples](link)  
+
+#### `--arc`
+Pass `--arc` to wrap all of the lines around a center point.
+
+[See examples](link)  
+
+#### `--rotate`
+Pass `--rotate` to rotate the final image 90 degrees, i.e. to draw horizontal lines,
+where the top is the 'start' of your media file.  
+TODO - check if the last sentence is true
+
+#### `-h, --height`
+Optionally specify a custom height for the output image.
+
+#### `--format`
+Optionally force the download quality for `youtube-dl`.  
+This determines the height of your image when using `-s stretch` only if you didn't specify --height.  
+**Default**: 135 *(854x480 DASH at 24fps)*  
+
+See [youtube-dl docs on format selection](https://github.com/rg3/youtube-dl/blob/master/README.md#format-selection).
+
+#### `--frame_rate`
+Optionally specify the amount of frames to extract per second from the media.  
+This determines the width of the image.  
+
+You should run `muvy [..]` without this option once and check the stats printout
+to get an idea of a better number.  
+For example, if the stats printout used "1.6 fps," passing `--frame_rate 3.2`
+would double the amount of frames, lines, and subsequently the width.
+
+> Setting this to an unreasonable number might cause hundreds of thousands
+of files to be temporarily created in your system's temp files.
+
+#### `--start` and `--end`
+Optionally specify starting and ending times for processing videos.  
+If you only specify one of them, the other will default to the start/end.
+
+[Examples](link)
+
+### Features
+- [x] Accepting image galleries, local videos, and online videos
+- [x] Specifying start & end times for frame extraction
+- [x] Vertical lines
+- [x] Horizontal lines
+- [x] Stretched output (average of each line of pixels)
+- [x] Arc distortion
+- [ ] Spotmap output ('QR' code)
+- [ ] Slit scan output
+- [ ] 'Bedforms' output
+- [ ] Dominant color algorithms
+ - [ ] via ImageMagick histograms
+ - [ ] via k-means clustering
+- [ ] Fade to black or white on edges
+- [ ] Pixel thickness control
+- [ ] Colorspace adjustments
+- [ ] Accept music files
+ - [ ] Generate audio waveforms
+ - [ ] Randomize waveform colors
+- [ ] Presets
+
+## Examples
+
+## Troubleshooting
+
+Make sure you can access `ffmpeg -v`, `magick -v`, and `youtube-dl --version` on the command line. If you can't, you likely have to update your existing PATH environment variable [like this](https://video.stackexchange.com/questions/20495/how-do-i-set-up-and-use-ffmpeg-in-windows).
+
+You might also want to update all three binaries.
+
+If it's not working out, [I've linked more generators](#links) and methods that you can try out, most of them depending on some combination of `ffmpeg` and `ImageMagick`.
+
+## Links
+* Binaries · Gems
+  * [FFmpeg](https://www.ffmpeg.org/documentation.html) · [Streamio FFmpeg](https://github.com/streamio/streamio-ffmpeg)
+  * [ImageMagick](https://www.imagemagick.org/script/command-line-options.php) · [MiniMagick](https://github.com/minimagick/minimagick)
+  * [youtube-dl](https://github.com/rg3/youtube-dl) · [youtube-dl.rb](https://github.com/layer8x/youtube-dl.rb)
+* Other Works & Inspirations
+  * [Zach Whalen's Barcoder](http://zachwhalen.net/pg/barcoder/)
+  * [arcanesanctum generator](http://arcanesanctum.net/movie-barcode-generator/)
+  * [moviebarcode on tumblr](http://moviebarcode.tumblr.com/)
+  * [/u/etherealpenguin on reddit](https://www.reddit.com/r/dataisbeautiful/comments/3rb8zi/the_average_color_of_every_frame_of_a_given_movie/)
+  * [Colors of Motion](http://thecolorsofmotion.com/films)
+* Slit scanning
+  * [informal catalogue of research on this topic by Levin](http://www.flong.com/texts/lists/slit_scan/)
+* K-means clustering as dominant color algorithms
+  * [k-means clustering on wikipedia](link)
+* ImageMagick Histograms
+  * [Sparse color docs](http://www.imagemagick.org/Usage/canvas/#sparse-color)
+  * [Stackoverflow discussion (1)](https://stackoverflow.com/questions/40381273/apply-gradient-mask-on-image-that-already-has-transparency-with-imagemagick)
+* ImageMagick support
+  * tremendous thank you to [fmw](http://www.fmwconcepts.com/imagemagick/index.php) & [snibgo](http://im.snibgo.com/index.htm)

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "muvy"
+
+# 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.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

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/muvy

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'muvy'
+
+Muvy::CLI.new.start

data/lib/muvy.rb

@@ -0,0 +1,5 @@
+require "muvy/version"
+require "muvy/cli"
+
+module Muvy
+end

data/lib/muvy/cli.rb

@@ -0,0 +1,119 @@
+require 'muvy/media'
+require 'muvy/errors'
+require 'slop'
+
+module Muvy
+  class CLI
+    attr_reader :media, :options
+
+    def start
+      parse
+      handle_media
+      handle_path
+      convert_options
+      read_media
+    end
+
+    def parse
+      @options = Slop.parse do |o|
+        o.banner = "Usage: muvy [media link, file, or file path] [options]"
+
+        o.separator ""
+        o.separator "Optional adjustments:"
+        o.string  "-p", "--path", "Directory to save final images, " +
+                  "\n\t\t\s\s\s\sDefault: your pwd → #{Dir.pwd}",
+                  default: Dir.pwd
+        o.string  "-s", "--style", "Choose image style: solid, stretch " +
+                  "\n\t\t\s\s\s\sDefault: solid",
+                  default: "solid"
+        o.string  "-g", "--gradient", "Add a gradient over the final image" +
+                  "\n\t\t\s\s\s\sChoose one from: black:heavy black:medium black:light" +
+                  "\n\t\t\s\s\s\s\t\t\s\s\s\s\swhite:heavy white:medium white:light" +
+                  "\n\t\t\s\s\s\sDefault: none"
+        o.boolean "--arc", "Wrap all of the lines around a center point"
+        o.boolean "-r", "--rotate", "Image will have horizontal lines"
+        o.integer "-h", "--height", "Custom height of the final image"
+        o.string "--start", "Custom video start time"
+        o.string "--end", "Custom video end time"
+        o.string "--format", "Force youtube-dl to use a specific video quality"
+        o.string "--frame_rate", <<~FPS
+          Set a custom frame rate. Be careful!
+          \t\t\s\s\s\sSetting this to a high number might cause hundreds of
+          \t\t\s\s\s\sthousands of images to be generated in your sytem's temp dir.
+          \t\t\s\s\s\sThe specific frame_rate used by default for your file is printed
+          \t\t\s\s\s\safter generation. You can use that number to make a reasonable change.
+        FPS
+
+        o.separator "More:"
+        o.on "--help", "Shows this usage page" do
+          abort o.to_s
+        end
+
+        o.on "-v", "--version", "Displays the version" do
+          abort "muvy version #{VERSION}"
+        end
+      end
+    rescue Slop::Error => e
+      abort <<~ERROR
+        #{e}.
+        Type `muvy --help` to see options, or visit the
+        github repo for extensive usage examples.
+      ERROR
+    end
+
+    private
+
+    def handle_media
+      @media = options.arguments.shift
+      raise Muvy::Errors::NoMediaInput if media.nil?
+    rescue => e
+      abort input_error(e)
+    end
+
+    # if -path was specified but is invalid, raise an error
+    # if -path was not specified, it was set to the pwd by Slop defaults
+    def handle_path
+      raise Muvy::Errors::InvalidPathOption unless File.directory?(options[:path])
+    rescue => e
+      abort "#{e}: You specified a non-existent path '#{options[:path]}'"
+    end
+
+    # FileUtils.remove_entry_secure is called before ::mktmpdir returns
+    def read_media
+      Dir.mktmpdir do |tmp_dir|
+        options[:tmp_dir] = tmp_dir
+        puts "Using #{tmp_dir} to store jobs locally..."
+
+        Media.new(media, options).run
+      end
+    rescue => e
+      abort media_error(e)
+    ensure
+      puts "#{options[:tmp_dir]} was erased." if options[:tmp_dir]
+    end
+
+    def convert_options
+      @options = options.to_hash # finalize
+    end
+
+    def input_error(e)
+      <<~INPUT_ERROR
+        #{e}
+        You forgot to enter a URL, file, or folder with images.
+
+        #{options}
+      INPUT_ERROR
+    end
+
+    def media_error(e)
+      <<~MEDIA_ERROR
+        #{e}
+        Media is unrecognized.
+        The input was not a valid URL, file, or folder with images.
+
+        #{options}
+      MEDIA_ERROR
+    end
+
+  end
+end

data/lib/muvy/download.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'youtube-dl.rb'
+
+module Muvy
+  class Download
+    attr_reader :media, :options, :settings
+
+    def initialize(media, options = {})
+      @media = media
+      @options = options
+    end
+
+    def run
+      @settings = merge_settings
+
+      download_video
+      send_video
+    end
+
+    private
+
+    def download_video
+      vid = YoutubeDL.download(media, settings)
+      add_options(vid)
+
+      puts <<~DOWNLOADED
+        Download complete.
+        Video title: #{vid.information[:title]}
+        Video URL: #{vid.information[:webpage_url]}
+        Video format: #{vid.information[:format]} saved as #{vid.information[:ext]}
+          as #{vid.information[:_filename]}
+        File size: #{(vid.information[:filesize] / 1.024e6).round(2)} MB.
+      DOWNLOADED
+    end
+
+    # Add important settings to @options hash for use by FFmpeg
+    def add_options(vid)
+      options[:fps] = vid.information[:fps]
+      options[:media_length] = vid.information[:duration]
+    end
+
+    def send_video
+      Video.new(settings[:output], options).run if File.exists?(settings[:output])
+    rescue => e
+      puts e
+    end
+
+    # defaults holds default values
+    # options holds command-line arguments
+    # settings merges defaults with options where appropriate
+    def merge_settings
+      defaults = {
+        continue: false,
+        format: 135,
+        output: "#{options[:tmp_dir]}/" +
+                Time.now.strftime("%d-%m-%Y-%H%M%S") +
+                ".mp4"
+      }
+
+      @settings = defaults.merge!(options.select { |k, v| defaults.key?(k) && v })
+    end
+  end
+end

data/lib/muvy/errors.rb

@@ -0,0 +1,9 @@
+module Muvy
+  module Errors
+    class NoMediaInput < ArgumentError; end
+
+    class InvalidMediaInput < ArgumentError; end
+
+    class InvalidPathOption < ArgumentError; end
+  end
+end

data/lib/muvy/image.rb

@@ -0,0 +1,125 @@
+require "mini_magick"
+
+module Muvy
+  class Image
+    attr_reader :media, :options
+
+    def initialize(media, options)
+      @media = media
+      @options = options
+    end
+
+    def run
+      montage
+      modification
+      printout
+    end
+
+    private
+
+    def montage
+      MiniMagick::Tool::Montage.new do |montage|
+        montage << "#{media}/thumb*.png"
+        montage.mode("Concatenate")
+        montage.tile("x1")
+        options[:img] =
+          File.absolute_path(options[:path]) +
+          "/muvy-" +
+          Time.now.strftime('%d-%m-%H%M%S') +
+          ".png"
+        montage << options[:img]
+      end
+    end
+
+    def modification
+      image = MiniMagick::Image.new(options[:img])
+
+      # TODO: Programatically trigger the methods based on options `nil` status
+      resize(image)
+      gradient(image)
+      rotate(image)
+      arc
+    end
+
+    # Arbitrary default height 720
+    def resize(image)
+      if options[:style] != "stretch"
+        image.resize "#{image.width}x#{options[:height] ||= 720}!"
+      elsif options[:height] # and style is stretch
+        image.resize "#{image.width}x#{options[:height]}!"
+      end
+    end
+
+    def gradient(image)
+      if options[:gradient]
+        choice = options[:gradient].split(":")
+        choice_path = "#{options[:tmp_dir]}/muvy-gradient.png"
+
+        weights = {
+          "heavy" => 1.6,
+          "medium" => 0.9,
+          "light" => 0.5
+        }
+
+        MiniMagick::Tool::Convert.new do |cmd|
+          cmd.size("#{image.width}x#{image.height}")
+          cmd << "gradient:"
+          cmd << "-function" << "Polynomial" << "-4,4,.1"
+          cmd << "-evaluate" << "Pow" << weights[choice[1]]
+          cmd.negate unless choice[0] == "white"
+          cmd.stack do |stack|
+            stack.merge! ["+clone", "-fill", "Black", "-colorize", "100"]
+          end
+          cmd << "+swap"
+          cmd << "-alpha" << "Off"
+          cmd.compose("CopyOpacity")
+          cmd << "-composite"
+          cmd.negate unless choice[0] == "black"
+          cmd << choice_path
+        end
+
+        gradient_image = MiniMagick::Image.new(choice_path)
+        apply_gradient = image.composite(gradient_image) do |composite|
+          composite.compose "Over"
+        end
+
+        apply_gradient.write(options[:img])
+      end
+    end
+
+    def rotate(image)
+      image.rotate(90) if options[:rotate]
+    end
+
+    def arc
+      if options[:arc]
+        MiniMagick::Tool::Convert.new do |cmd|
+          cmd << options[:img]
+          cmd << "-gravity" << "center"
+          cmd << "+repage"
+          cmd << "-virtual-pixel" << "Transparent"
+          cmd << "-distort" << "Arc" << "366"
+          cmd << options[:img]
+        end
+      end
+    end
+
+    def printout
+      image = MiniMagick::Image.open(options[:img])
+      puts <<~PRINTOUT_IMG
+        Saved to #{options[:img]}.
+        Width: #{image.dimensions[0]}, Height: #{image.dimensions[1]}
+        Type: #{image.type}
+        Colorspace: #{image.colorspace}
+      PRINTOUT_IMG
+
+      puts <<~PRINTOUT_VIDEO if options[:fps]
+
+        Thumbnails made at #{options[:frame_rate] ? options[:frame_rate] : (options[:fps] / (options[:media_length]**(1 / 1.99))).round(4) } frames per second.
+        Original video duration was #{options[:media_length]}.
+        #{'Start time: ' + options[:start].to_s if options[:start]}
+        #{'End time: ' + options[:end].to_s if options[:end]}
+      PRINTOUT_VIDEO
+    end
+  end
+end

data/lib/muvy/imagefolder.rb

@@ -0,0 +1,56 @@
+require "mini_magick"
+
+module Muvy
+  class ImageFolder
+    attr_reader :media, :options, :photos
+
+    def initialize(media, options)
+      @media = media
+      @options = options
+      @photos = add_photos
+    end
+
+    def run
+      average
+      send_thumbs
+    end
+
+    private
+
+    def add_photos
+      Dir.glob("#{media}/*")
+    end
+
+    def average
+      # Store the average photos here
+      Dir.mkdir("#{options[:tmp_dir]}/muvy-img-folder/")
+
+      photos.each_with_index do |photo, i|
+        MiniMagick::Tool::Convert.new do |convert|
+          convert << photo
+          convert.resize("1x#{height}!")
+          convert << "#{options[:tmp_dir]}/muvy-img-folder/thumb#{i.to_s.rjust(6, '0')}.png"
+        end
+      end
+    end
+
+    def height
+      if options[:style] == "stretch"
+        options[:height] ? options[:height] : (abort <<~NO_HEIGHT)
+          You specified an image folder and 'stretch' with the --style flag.
+          You should also specify a uniform height with the --height option.
+        NO_HEIGHT
+      else
+        # Arbitrary default height 720
+        options[:height] ||= 720
+
+        # 1x1 to get average colors ('solid' style)
+        1
+      end
+    end
+
+    def send_thumbs
+      Image.new("#{options[:tmp_dir]}/muvy-img-folder", options).run
+    end
+  end
+end

data/lib/muvy/media.rb

@@ -0,0 +1,62 @@
+require 'muvy/download'
+require 'muvy/video'
+require 'muvy/imagefolder'
+require 'muvy/errors'
+require 'uri'
+
+module Muvy
+  class Media
+    attr_reader :media, :options, :type
+
+    def initialize(media, options)
+      @media = media
+      @options = options
+    end
+
+    def run
+      get_type
+      send_type
+    end
+
+    private
+
+    def send_type
+      Muvy.const_get(type.to_s).new(media, options).run
+    end
+
+    # Checks the first argument (store in :media, access via getter).
+    # Determines if it should be read by Download (type - online URL),
+    # by Video (type - local media), or by Image (type - local image files).
+    # Unrecognized inputs invoke the usage heredocs and banners at `CLI`
+    def get_type
+      if valid_url?(media)
+        @type = :Download
+      elsif file_exists?(media)
+        @type = :Video
+      elsif path_exists?(media)
+        @type = :ImageFolder
+      else
+        raise Muvy::Errors::InvalidMediaInput
+      end
+    end
+
+    # Accepts a string that behaves like a URL.
+    # The URL must have a valid URI scheme (e.g. http) to differentiate
+    # it from file paths. URI module doesn't recognize #host without it.
+    def valid_url?(url)
+      encoded_url = URI.escape(url)
+      parsed_url = URI.parse(encoded_url)
+      !parsed_url.host.nil?
+    end
+
+    def file_exists?(file)
+      file_path = File.absolute_path(file)
+      File.file?(file_path)
+    end
+
+    def path_exists?(path)
+      full_path = File.absolute_path(path)
+      File.directory?(full_path)
+    end
+  end
+end

data/lib/muvy/version.rb

@@ -0,0 +1,3 @@
+module Muvy
+  VERSION = "0.1.0"
+end

data/lib/muvy/video.rb

@@ -0,0 +1,60 @@
+require 'streamio-ffmpeg'
+require 'muvy/image'
+
+module Muvy
+  class Video
+    attr_reader :media, :options, :settings, :vid
+
+    def initialize(media, options = {})
+      @media = media
+      @options = options
+    end
+
+    def run
+      @vid = FFMPEG::Movie.new(media)
+      @settings = merge_settings
+
+      thumbs
+      send_thumbs
+    end
+
+    private
+
+    # Add important settings to @options hash for use by FFmpeg
+    def add_options
+      options[:fps] = vid.frame_rate
+      options[:media_length] = vid.duration
+    end
+
+    # defaults holds default values
+    # options holds command-line arguments
+    # settings merges defaults with options where appropriate
+    def merge_settings
+      add_options
+
+      defaults = {
+        vframes: (options[:fps] * options[:media_length]).floor,
+        frame_rate: options[:fps] / (options[:media_length]**(1 / 1.99)),
+        custom: %W{
+          -vf scale=1:#{options[:style] == 'stretch' ? vid.height : 1}
+          -ss #{options[:start] ? options[:start] : 0}
+          -to #{options[:end] ? options[:end] : options[:media_length]}
+        }
+      }
+
+      @settings = defaults.merge!(options.select { |k, v| defaults.key?(k) && v })
+    end
+
+    def thumbs
+      vid.screenshot(
+        "#{options[:tmp_dir]}/thumb%06d.png",
+        settings,
+        validate: false
+      )
+    end
+
+    def send_thumbs
+      Image.new(options[:tmp_dir], options).run
+    end
+  end
+end

data/muvy.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "muvy/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "muvy"
+  spec.version       = Muvy::VERSION
+  spec.authors       = ["agarun"]
+  spec.email         = ["19801205+agarun@users.noreply.github.com"]
+
+  spec.summary       = "Ruby movie barcode generator."
+  spec.homepage      = "https://github.com/agarun/ruby-muvy"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |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_runtime_dependency "youtube-dl.rb", "~> 0"
+  spec.add_runtime_dependency "streamio-ffmpeg", "~> 3.0"
+  spec.add_runtime_dependency "mini_magick", "~> 4.8"
+  spec.add_runtime_dependency "slop", "~> 4.6"
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification
+name: muvy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- agarun
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-10-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: youtube-dl.rb
+  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'
+- !ruby/object:Gem::Dependency
+  name: streamio-ffmpeg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: mini_magick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.8'
+- !ruby/object:Gem::Dependency
+  name: slop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !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:
+- 19801205+agarun@users.noreply.github.com
+executables:
+- muvy
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/muvy
+- lib/muvy.rb
+- lib/muvy/cli.rb
+- lib/muvy/download.rb
+- lib/muvy/errors.rb
+- lib/muvy/image.rb
+- lib/muvy/imagefolder.rb
+- lib/muvy/media.rb
+- lib/muvy/version.rb
+- lib/muvy/video.rb
+- muvy.gemspec
+homepage: https://github.com/agarun/ruby-muvy
+licenses:
+- MIT
+metadata: {}
+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: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Ruby movie barcode generator.
+test_files: []