multimedia_paradise 1.1.314

data/lib/multimedia_paradise/sound_effects/README.md

@@ -0,0 +1,12 @@
+Note that this directory only contains very few samples - the idea 
+is NOT to have a full-fledged sound effect project, but merely to 
+test for such effects quickly, such as for a ruby-gtk3 widget.
+
+Users can then expand this on their own anyway.
+
+These sound files may be exchanged in the future, in particular 
+with smaller files, if possible - so really think of this directory
+just as an "examples" directory, with samples, nothing more.
+
+The ideal solution would be to have completely computer-generated
+audio effects. I lack knowledge in how to achieve this, though.

data/lib/multimedia_paradise/statistics/README.md

@@ -0,0 +1,5 @@
+This directory contains code that may be useful if the user
+wishes to obtain statistical information, such as the 
+local video collection or local audio collection. This will
+initially be tailored towards my use cases though - if 
+someone else wants to make use of it, drop me an email.

data/lib/multimedia_paradise/statistics/video.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === MultimediaParadise::Statistics::Video
+#
+# This class will show some statistical information about the
+# videos.
+#
+# Usage example:
+#
+#   MultimediaParadise::Statistics::Video.new
+#
+# =========================================================================== #
+# require 'multimedia_paradise/video/encode_video'
+# =========================================================================== #
+require 'multimedia_paradise/base/base.rb'
+
+module MultimediaParadise
+
+module Statistics
+
+class Video < ::MultimediaParadise::Base # === MultimediaParadise::Statistics::Video
+
+  require 'multimedia_paradise/video/store_available_video_files.rb'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = ARGV,
+      run_already = true
+    )
+    reset
+    set_commandline_arguments(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    opne 'Next showing some information about the local video files:'
+    all_video_files = Dir['/home/x/video/**/**'].select {|entry|
+      is_a_video_file?(entry)
+    }
+    e 'There are a total of '+steelblue(all_video_files.size)+
+      ' video files existing locally.'
+    e
+    e '  How many real videos exist? '.ljust(36)+steelblue(
+        all_video_files.select {|inner_entry|
+          inner_entry.include?('/Realvids')
+        }.size.to_s.rjust(3)
+      )
+    e '  How many real life videos exist? '.ljust(36)+steelblue(
+        all_video_files.select {|inner_entry|
+          inner_entry.include?('/Reallife')
+        }.size.to_s.rjust(3)
+      )
+    e '  How many MMA videos exist? '.ljust(36)+steelblue(
+        all_video_files.select {|inner_entry|
+          inner_entry.include?('/MMA')
+        }.size.to_s.rjust(3)
+      )
+    # ======================================================================= #
+    # Delegate to class MultimediaParadise::StoreAvailableVideoFiles next.
+    # ======================================================================= #
+    MultimediaParadise::StoreAvailableVideoFiles.new
+    e
+  end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::Statistics::Video.new(ARGV)
+end # videostatistics

data/lib/multimedia_paradise/toplevel_cut_audio.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_cut_audio'
+# =========================================================================== #
+# This will also register CutAudio into the toplevel constant. Users are
+# encouraged to NOT use this .rb file if they do NOT want this to happen.
+# =========================================================================== #
+require 'multimedia_paradise/requires/require_cut_multimedia.rb'
+
+# =========================================================================== #
+# Make the CutAudio namespace known, as alias to the namespace called
+# MultimediaParadise::CutMultimedia.
+# =========================================================================== #
+Object.const_set 'CutAudio', MultimediaParadise::CutMultimedia

data/lib/multimedia_paradise/toplevel_methods/analyze_audio_stream.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/analyze_audio_stream.rb'
+# =========================================================================== #
+require 'multimedia_paradise/toplevel_methods/e.rb'
+require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
+
+module MultimediaParadise
+
+  # ========================================================================= #
+  # === MultimediaParadise.analyze_audio_stream
+  #
+  # This method will use ffmpeg in order to analyze the audio stream. A
+  # Hash will be returned, which will keep the decibel-score value.
+  #
+  # For more documentation see the method
+  # MultimediaParadise.ffmpeg_analyze_audio_stream().
+  # ========================================================================= #
+  def self.analyze_audio_stream(
+      of_this_file
+    )
+    ffmpeg_analyze_audio_stream(of_this_file)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  pp MultimediaParadise.analyze_audio_stream(ARGV)
+end # analyze_audio $MY_SONGS/YoonDohyun_Dolgo.mp3

data/lib/multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb'
+# =========================================================================== #
+require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
+
+module MultimediaParadise
+
+  # ========================================================================= #
+  # === MultimediaParadise.chop_into_segments_of_n_seconds_size
+  #
+  # Use this (audio) method to chop up an audio file into segments
+  # of n size. You could also use this on a video file, but the
+  # primary use of it is to chop up a large audio file into
+  # smaller audio files.
+  #
+  # The first argument is the name (path) of the file that you wish
+  # to modify.
+  #
+  # If only one argument is provided (the filename), then we will default
+  # to a duration of 60 seconds.
+  # ========================================================================= #
+  def self.chop_into_segments_of_n_seconds_size(
+      this_file, # <- Your target file that will be chopped up.
+      n_seconds = 60
+    )
+    ffmpeg_chop_into_segments_of_n_seconds_size(this_file, n_seconds)
+  end
+
+end

data/lib/multimedia_paradise/toplevel_methods/chop_off_first_five_minutes.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'multimedia_paradise/toplevel_methods/chop_off_first_n_seconds.rb'
+
+module MultimediaParadise
+
+  # ========================================================================= #
+  # === MultimediaParadise.chop_off_first_five_minutes
+  # ========================================================================= #
+  def self.chop_off_first_five_minutes(of_this_file)
+    MultimediaParadise.chop_off_first_n_seconds(
+      '5 minutes', of_this_file, :do_create_complementary_file
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.chop_off_first_five_minutes(ARGV.first)
+end # chop_off_first_five_minutes

data/lib/multimedia_paradise/toplevel_methods/chop_off_first_n_seconds.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/chop_off_first_n_seconds.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+  require 'multimedia_paradise/toplevel_methods/return_duration_of_this_multimedia_file.rb'
+  require 'multimedia_paradise/toplevel_methods/e.rb'
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+  require 'multimedia_paradise/colours/colours.rb'
+
+  # ========================================================================= #
+  # === FIVE_MINUTES
+  # ========================================================================= #
+  FIVE_MINUTES = 60 * 5
+
+  # ========================================================================= #
+  # === TEN_MINUTES
+  # ========================================================================= #
+  TEN_MINUTES = 60 * 10
+
+  # ========================================================================= #
+  # === MultimediaParadise.chop_off_first_n_seconds
+  #
+  # Use this method to chop off the first n seconds from a multimedia file.
+  #
+  # By default, we will chop off the first 10 minutes.
+  #
+  # This just wraps ffmpeg, such as:
+  #
+  #   ffmpeg -ss 0 -t 30 -i file.mp3 file.wav
+  #
+  # Options explained:
+  #   -ss 0 - Start at 0 seconds
+  #   -t 30 - Capture 30 seconds (from 0, so 0:00 - 0:30). If you want 1 minute of audio, use -t 60.
+  #   file.mp3 - Input file
+  #   file.wav - output file
+  #
+  # Specific usage example:
+  #   MultimediaParadise.chop_off_first_n_seconds(:default, '/Users/x/STUDIUM/UNI_WIEN/321015_Pathophysiologie/audio/01-Pathophysiologie-30.05.2016_Vormittag_Überlebenszeit_Apoptose.mp3')
+  # ========================================================================= #
+  def self.chop_off_first_n_seconds(
+      n_seconds                         = TEN_MINUTES, # 10 minutes.
+      of_this_multimedia_file           = ARGV,
+      also_do_create_complementary_file = false
+    )
+    if of_this_multimedia_file.is_a? Array
+      of_this_multimedia_file.each {|entry|
+        chop_off_first_n_seconds(n_seconds, entry, also_do_create_complementary_file)
+      }
+    else
+      case n_seconds
+      when '10 minutes'
+        n_seconds = TEN_MINUTES
+      when '5 minutes'
+        n_seconds = FIVE_MINUTES
+      when :default
+        n_seconds = TEN_MINUTES
+      end
+      case also_do_create_complementary_file
+      when :do_create_complementary_file
+        also_do_create_complementary_file = true
+      end
+      ffmpeg_command = 'ffmpeg -ss 0 -t '+n_seconds.to_s+' -i '+of_this_multimedia_file
+      extname        = File.extname(of_this_multimedia_file)
+      output_file    = of_this_multimedia_file.sub(/(#{extname})/, '_CHOPPED_AT_THE_START\\1')
+      ffmpeg_command << ' '+output_file
+      esystem ffmpeg_command
+      # ===================================================================== #
+      # Also create the "missing" part of the multimedia file, so that
+      # we will end up with two files as a result.
+      # ===================================================================== #
+      if also_do_create_complementary_file
+        e 'Now also creating the complementary file.'
+        duration       = ::MultimediaParadise.return_duration_of_this_multimedia_file(of_this_multimedia_file) - n_seconds.to_f
+        ffmpeg_command = 'ffmpeg -ss '+n_seconds.to_s+' -t '+duration.to_s+' -i '+of_this_multimedia_file
+        extname        = File.extname(of_this_multimedia_file)
+        output_file    = of_this_multimedia_file.sub(/(#{extname})/, '_CHOPPED_AT_THE_END\\1')
+        ffmpeg_command << ' '+output_file
+        e orange(ffmpeg_command)
+        system ffmpeg_command
+      end
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.chop_off_first_n_seconds(:default, ARGV, :do_create_complementary_file)
+end # chop_off_first_n_seconds 01-Pathophysiologie-30.05.2016_Vormittag_Überlebenszeit_Apoptose.mp3

data/lib/multimedia_paradise/toplevel_methods/chop_off_first_ten_minutes.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'multimedia_paradise/toplevel_methods/chop_off_first_n_seconds.rb'
+
+module MultimediaParadise
+
+  # ========================================================================= #
+  # === MultimediaParadise.chop_off_first_ten_minutes
+  # ========================================================================= #
+  def self.chop_off_first_ten_minutes(of_this_file)
+    MultimediaParadise.chop_off_first_n_seconds(
+      '10 minutes', of_this_file, :do_create_complementary_file
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.chop_off_first_ten_minutes(ARGV.first)
+end # chop_off_first_ten_minutes

data/lib/multimedia_paradise/toplevel_methods/chop_off_first_two_minutes.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/chop_off_first_two_minutes.rb'
+# =========================================================================== #
+require 'multimedia_paradise/toplevel_methods/chop_off_first_n_seconds.rb'
+
+module MultimediaParadise
+
+  # ========================================================================= #
+  # === MultimediaParadise.chop_off_first_two_minutes
+  # ========================================================================= #
+  def self.chop_off_first_two_minutes(of_this_file)
+    MultimediaParadise.chop_off_first_n_seconds(
+      '2 minutes', of_this_file, :do_create_complementary_file
+    )
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.chop_off_first_two_minutes(ARGV.first)
+end # chop_off_first_two_minutes

data/lib/multimedia_paradise/toplevel_methods/codecs.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# The idea for this file is to collect codec-related code. 
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/codecs.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================= #
+  # === MultimediaParadise.codec_conversion
+  #
+  # This method can be used to convert, e. g. from a .mp3 file to a
+  # .ogg file. Note that this does not work right now (November 2020).
+  #
+  # In raw ffmpeg this would be like so:
+  #
+  #   ffmpeg -i input.mp3 -c:a libvorbis output.ogg
+  #
+  # Usage example:
+  #
+  #   MultimediaParadise.codec_conversion
+  #
+  # ========================================================================= #
+  def self.codec_conversion(
+      of_this_input_file,
+      use_this_codec = :libvorbis
+    )
+    if of_this_input_file.is_a? Array
+      of_this_input_file = of_this_input_file.join(' ').strip
+    end
+    output_file = of_this_input_file.
+                  sub(/#{File.extname(of_this_input_file)}/,'')+
+                  '.ogg'
+    _ = 'ffmpeg -i '+of_this_input_file+' -c:a '+
+         use_this_codec.to_s+
+         output_file
+    e
+    esystem _
+    e
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.codec_conversion(ARGV)
+end

data/lib/multimedia_paradise/toplevel_methods/copy_and_merge_this_video_n_times.rb

@@ -0,0 +1,51 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/copy_and_merge_this_video_n_times.rb'
+# =========================================================================== #
+require 'multimedia_paradise/toplevel_methods/esystem.rb'
+require 'multimedia_paradise/toplevel_methods/copy_file.rb'
+require 'multimedia_paradise/toplevel_methods/merge_these_videos.rb'
+require 'multimedia_paradise/colours/colours.rb'
+
+module MultimediaParadise
+
+  # =========================================================================== #
+  # === MultimediaParadise.copy_and_merge_this_video_n_times
+  #
+  # This method will copy the given video; and then merge these copies.
+  # =========================================================================== #
+  def self.copy_and_merge_this_video_n_times(
+      this_video, n_times = 3
+    )
+    if this_video.is_a? Array
+      this_video = this_video.join(' ').strip
+    end
+    n_times = 3 if n_times.nil? # <- Set the default here.
+    array = []
+    extname = File.extname(this_video)
+    # ========================================================================= #
+    # Create intermediate files next.
+    # ========================================================================= #
+    n_times.to_i.times {|number|
+      this_new_video_file = 'foobar_'+this_video.sub(/#{extname}$/,'').to_s+
+                            '_'+number.to_s+extname
+      array << this_new_video_file
+      copy_file(this_video, this_new_video_file)
+    }
+    # ========================================================================= #
+    # Past this point we assume that the files were copied successfully.
+    # We will next proceed to merge these files.
+    # ========================================================================= #
+    result = ::MultimediaParadise.merge_these_videos(
+      array
+    )
+    return result
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.copy_and_merge_this_video_n_times(ARGV[0], ARGV[1])
+end # copy_and_merge_this_video_n_times

data/lib/multimedia_paradise/toplevel_methods/copy_file.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/copy_file.rb'
+# =========================================================================== #
+require 'fileutils'
+
+module MultimediaParadise
+
+  # ========================================================================= #
+  # === MultimediaParadise.copy_file
+  # ========================================================================= #
+  def self.copy_file(from, to)
+    FileUtils.cp(from, to)
+  end
+
+end

data/lib/multimedia_paradise/toplevel_methods/create_video_from_this_audio.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/create_video_from_this_audio.rb'
+# =========================================================================== #
+require 'multimedia_paradise/toplevel_methods/e.rb'
+require 'multimedia_paradise/toplevel_methods/esystem.rb'
+require 'multimedia_paradise/toplevel_methods/is_image_file.rb'
+
+module MultimediaParadise
+
+  # ========================================================================= #
+  # === MultimediaParadise.create_video_from_this_audio
+  #
+  # This method can turn a, for example, .mp3 file into a video with
+  # a static image.
+  #
+  # The second argument should be the image that you wish to show for
+  # the video. If this image can NOT be found then the method will
+  # try to find any other image file in the current directory - this
+  # is the behaviour I needed, so it was added. Ideally provide the
+  # image, though. 
+  # ========================================================================= #
+  def self.create_video_from_this_audio(
+      this_audio_file = ARGV,
+      use_this_image  = 'CAT.png'
+    )
+    if this_audio_file.is_a? Array
+      this_audio_file.each {|entry|
+        MultimediaParadise.create_video_from_this_audio(entry)
+      }
+    else
+      unless File.exist? use_this_image
+        e "No file called `#{use_this_image}` exists."
+        e 'Trying to find any other image in this directory next.'
+        all_image_files = Dir['*'].select {|entry| is_an_image_file?(entry) }
+        # =================================================================== #
+        # Must check whether it is empty or not.
+        # =================================================================== #
+        if all_image_files.empty?
+          e 'No image could be found, thus no image was supplied. This is'
+          e 'not allowed, so we exit here.'
+          return
+        else
+          # ================================================================= #
+          # Ok, use that image in this case - the first one.
+          # ================================================================= #
+          use_this_image = all_image_files.first.to_s
+        end
+      end
+      output_file = this_audio_file.sub(/#{File.extname(this_audio_file)}/,'')+'.mp4'
+      _ = 'ffmpeg -loop 1 '\
+          '-i '+use_this_image.to_s+' '\
+          '-i '+this_audio_file+' -c:a copy -c:v libx264 '\
+          '-shortest '+output_file
+      esystem(_)
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.create_video_from_this_audio(ARGV)
+end # create_video_from_this_audio