multimedia_paradise 1.1.344 → 1.2.2

data/lib/multimedia_paradise/toplevel_methods/increase_volume_of_this_audio_file.rb

@@ -1,61 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/increase_volume_of_this_audio_file.rb'
-# =========================================================================== #
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
-module MultimediaParadise
-
-  # ========================================================================= #
-  # === MultimediaParadise.increase_volume_of_this_audio_file
-  #
-  # The method method MultimediaParadise.increase_volume_of_this_audio_file
-  # can boost the volume of an audio file, by making use of sox or ffmpeg.
-  #
-  # Sox is currently the default, whereas ffmpeg is used if the input
-  # given ends with 'db', which is short for decibel. The latter variant
-  # allows you to just input an increase or decrease in decibel.
-  #
-  # The sox command can modify the audio volume, up or down, using the -v
-  # flag, followed by a multiplier. The following example doubles (x2)
-  # the audio volume of a file.
-  #
-  #   sox -v 2.0 original-music.ogg louder-music.ogg 
-  #
-  # ========================================================================= #
-  def self.increase_volume_of_this_audio_file(
-      input_file,
-      modify_volume_by_this_value = '5.0' # or 3.0 or 4.0 and so forth.
-    )
-    unless input_file.is_a? Array
-      input_file = [input_file]
-    end
-    if modify_volume_by_this_value.to_s.downcase.end_with? 'db'
-      ffmpeg_increase_volume_of_this_audio_file(
-        input_file, modify_volume_by_this_value
-      )
-    else
-      case modify_volume_by_this_value # case tag
-      when '1/4', :one_fourth,'25%'
-        modify_volume_by_this_value = 0.25
-      end
-      # ======================================================================= #
-      # Batch-process the Array next.
-      # ======================================================================= #
-      input_file.each {|this_file|
-        value = modify_volume_by_this_value.to_s
-        output_file = "modified_file_by_v#{value}_#{this_file}"
-        _ = 'sox -v '+value+
-            ' '+this_file+' '+output_file
-        esystem _
-      }
-    end
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  MultimediaParadise.increase_volume_of_this_audio_file(ARGV, '+20dB')
-end # increase_volume_of_this_audio_file

data/lib/multimedia_paradise/toplevel_methods/is_a_multimedia_file.rb

@@ -1,27 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/is_a_multimedia_file.rb'
-# =========================================================================== #
-require 'multimedia_paradise/constants/misc.rb'
-
-module MultimediaParadise
-
-  # ========================================================================= #
-  # === MultimediaParadise.is_a_multimedia_file?
-  #
-  # Determine whether a given file is a multimedia file or whether
-  # it is not.
-  #
-  # Usage example:
-  #
-  #   MultimediaParadise.is_a_multimedia_file? 'foobar.avi'
-  #
-  # ========================================================================= #
-  def self.is_a_multimedia_file?(i)
-    i = File.extname(i).delete('.') if i
-    ARRAY_MULTIMEDIA_FILETYPES.include? i
-  end
-
-end

data/lib/multimedia_paradise/toplevel_methods/is_audio_file.rb

@@ -1,27 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/is_audio_file.rb'
-# =========================================================================== #
-module MultimediaParadise
-
-  require 'multimedia_paradise/constants/misc.rb'
-
-  # ========================================================================= #
-  # === MultimediaParadise.is_audio_file?
-  #
-  # This method will return true or false depending on whether the
-  # input is assumed to be an audio file or whether it is not.
-  # ========================================================================= #
-  def self.is_audio_file?(i)
-    _ = false
-    extname = File.extname(i).delete('.') # Will be something such as "mp3".
-    case extname
-    when *AUDIO_FORMATS
-      _ = true
-    end
-    return _
-  end; self.instance_eval { alias is_an_audio_file? is_audio_file? } # === MultimediaParadise.is_an_audio_file?
-
-end

data/lib/multimedia_paradise/toplevel_methods/is_image_file.rb

@@ -1,31 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/is_image_file.rb'
-# =========================================================================== #
-require 'multimedia_paradise/constants/misc.rb'
-
-module MultimediaParadise
-
-  # ========================================================================= #
-  # === MultimediaParadise.is_image_file?
-  #
-  # This method will return true or false depending on whether the
-  # input is assumed to be an image file or whether it is not.
-  # ========================================================================= #
-  def self.is_image_file?(i)
-    _ = false
-    extname = File.extname(i).delete('.') # Will be something such as "mp3".
-    case extname
-    when *IMAGE_FORMATS
-      _ = true
-    end
-    return _
-  end; self.instance_eval { alias is_an_image_file? is_image_file? } # === MultimediaParadise.is_an_image_file?
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  puts MultimediaParadise.is_image_file?('foobar.png')
-end

data/lib/multimedia_paradise/toplevel_methods/is_video_file.rb

@@ -1,62 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/is_video_file.rb'
-# =========================================================================== #
-require 'multimedia_paradise/constants/video_filetypes.rb'
-
-module MultimediaParadise
-
-  # ========================================================================= #
-  # === MultimediaParadise.is_video_file?
-  #
-  # This method will return true or false depending on whether the
-  # input is assumed to be a video file or whether it is not.
-  # ========================================================================= #
-  def self.is_video_file?(i)
-    _ = false
-    extname = File.extname(i).delete('.')
-    case extname
-    when *ARRAY_VIDEO_FILETYPES
-      _ = true
-    end
-    return _
-  end; self.instance_eval { alias is_video?             is_video_file? } # === MultimediaParadise.is_video?
-       self.instance_eval { alias is_a_video_file?      is_video_file? } # === MultimediaParadise.is_a_video_file?
-       self.instance_eval { alias is_this_a_video_file? is_video_file? } # === MultimediaParadise.is_this_a_video_file?
-
-  # ========================================================================= #
-  # === MultimediaParadise.filter_for_video_files_from
-  #
-  # This method accepts as input an Array. That array will then
-  # be filtered to include ONLY video files.
-  # ========================================================================= #
-  def self.filter_for_video_files_from(
-      this_directory
-    )
-    if this_directory.is_a?(String) and File.directory?(this_directory)
-      this_directory = Dir["#{this_directory}/*"]
-    end
-    this_directory.select {|entry|
-      is_video_file? entry
-    }
-  end
-
-  # ========================================================================= #
-  # === MultimediaParadise.filter_for_video_files
-  #
-  # This filter will only return video files.
-  # ========================================================================= #
-  def self.filter_for_video_files(array)
-    array.select {|entry| is_video_file?(entry) }
-  end
-
-  # ========================================================================= #
-  # === filter_for_video_files
-  # ========================================================================= #
-  def filter_for_video_files(i)
-    MultimediaParadise.filter_for_video_files(i)
-  end
-
-end

data/lib/multimedia_paradise/toplevel_methods/merge_these_videos.rb

@@ -1,106 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/merge_these_videos.rb'
-# =========================================================================== #
-module MultimediaParadise
-
-  require 'multimedia_paradise/colours/colours.rb'
-  require 'multimedia_paradise/toplevel_methods/esystem.rb'
-  require 'multimedia_paradise/toplevel_methods/output_directory.rb'
-
-  # ========================================================================= #
-  # === MultimediaParadise.merge_these_videos
-  #
-  # This method can be used to merge multiple videos together. The
-  # "concat" option of ffmpeg will be used for this merge-action.
-  #
-  # Ideally the video-files that are given as input to this method
-  # should all use the same resolution and the same frame rate.
-  #
-  # There are several ways how to go about this. A simple one is to
-  # simply create a text-file that can then tell ffmpeg which files
-  # are to be merged together. This is the strategy that this
-  # method will presently (2018) pursue.
-  #
-  # The ffmpeg-concact options are explained in more detail 
-  # here:
-  #
-  #   https://trac.ffmpeg.org/wiki/Concatenate
-  #
-  # Specific invocation examples for this method:
-  #
-  #   MultimediaParadise.merge_these_videos('foo.mp4','bar.mp4')
-  #   MultimediaParadise.merge('foo.mp4','bar.mp4')
-  #
-  # ========================================================================= #
-  def self.merge_these_videos(
-      *i
-    )
-    i = [i].flatten.map(&:strip)
-    e ::Colours.rev+
-      ::Colours.steelblue(i.size.to_s)+
-      ' video files will be merged next.'
-    new_file_extension = nil
-    # ======================================================================= #
-    # We will store into the following text-file:
-    # ======================================================================= #
-    text_file = "#{log_directory?}file_that_keeps_track_of_the_videos.md"
-    # ======================================================================= #
-    # Make sure that the base directory exists:
-    # ======================================================================= #
-    unless File.directory?(File.dirname(text_file))
-      mkdir(File.dirname(text_file))
-    end
-    File.delete(text_file) if File.exist? text_file
-    name_of_the_output_file = 'merged_files_'.dup
-    e 'The video files will be analyzed. A log file will be stored at:'
-    e
-    e "  #{sfile(text_file)}"
-    e
-    i.each {|this_video_file|
-      # ===================================================================== #
-      # We have to obtain the absolute file path:
-      # ===================================================================== #
-      this_video_file = File.absolute_path(this_video_file)
-      File.open(text_file, 'a+') { |file|
-        file.write("file #{this_video_file}\n")
-      }
-      raw_name = this_video_file.sub(/#{File.extname(this_video_file)}$/,'').dup
-      name_of_the_output_file << File.basename(raw_name).delete('/')
-      new_file_extension = File.extname(this_video_file).delete('.')
-    }
-    # ======================================================================= #
-    # Ensure that the file name is not too long, thus truncating.
-    # ======================================================================= #
-    if name_of_the_output_file.size > 200
-      name_of_the_output_file = name_of_the_output_file[0 .. 200]
-    end
-    name_of_the_output_file << '.'+new_file_extension
-    name_of_the_output_file = '"'+name_of_the_output_file.
-                              delete("'")+'"'
-    # ======================================================================= #
-    # Build up the string for ffmpeg next. The option -y is used to
-    # overwrite automatically.
-    # ======================================================================= #
-    _ = 'ffmpeg '\
-        '-y '\
-        '-safe 0 '\
-        '-f concat '\
-        '-i '+text_file+
-        ' -c copy '+name_of_the_output_file
-    esystem _
-    e
-    e 'Ouput stored at:'
-    e
-    e "  #{sfile(name_of_the_output_file)}"
-    e
-    return name_of_the_output_file # <- And also return it here.
-  end; self.instance_eval { alias merge merge_these_videos } # === MultimediaParadise.merge
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  MultimediaParadise.merge_these_videos(ARGV)
-end # merge_these_videos foo.mp4 bar.mp4

data/lib/multimedia_paradise/toplevel_methods/run_sys_command.rb

@@ -1,30 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/run_sys_command.rb'
-# =========================================================================== #
-module MultimediaParadise
-
-  # ========================================================================= #  
-  # === MultimediaParadise.run_sys_command                 (sys tag, sys cmd)
-  #
-  # Echo the command before running it via ``.
-  # ========================================================================= #
-  def self.run_sys_command(
-      cmd, pad_the_output = true
-    )
-    cmd = cmd.strip
-    e if pad_the_output
-    e cmd
-    e if pad_the_output
-    begin
-      result = `#{cmd}` # Sigint event can happen here.
-      return result
-    rescue Errno::ENOENT => error
-      e 'No such file exists. ('+error.to_s+')'
-      return nil
-    end
-  end
-
-end

data/lib/multimedia_paradise/toplevel_methods/to_flac.rb

@@ -1,30 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-module MultimediaParadise
-
-  require 'multimedia_paradise/toplevel_methods/esystem.rb'
-
-  # ========================================================================= #
-  # === MultimediaParadise.to_flac
-  #
-  # Convert e. g. a .mp3 file into a .flac file.
-  # ========================================================================= #
-  def self.to_flac(input_files)
-    [input_files].flatten.compact.each {|this_input_file|
-      output_name = File.absolute_path(
-        'output_'+File.basename(this_input_file).
-        delete_suffix(File.extname(this_input_file))+'.flac'
-      )
-      e
-      esystem "ffmpeg -i #{this_input_file} #{output_name}"
-      e
-    }
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  MultimediaParadise.to_flac(ARGV)
-end

data/lib/multimedia_paradise/toplevel_methods/to_mp4.rb

@@ -1,24 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/to_mp4.rb'
-# =========================================================================== #
-module MultimediaParadise
-
-  require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
-  # ========================================================================= #
-  # === MultimediaParadise.to_mp4
-  # ========================================================================= #
-  def self.to_mp4(*these_files)
-    File.absolute_path(
-      ffmpeg_to_mp4(these_files)
-    )
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
- MultimediaParadise.to_mp4(ARGV)
-end