multimedia_paradise 1.1.344 → 1.2.2

data/lib/multimedia_paradise/toplevel_methods/flip_and_rotate.rb

@@ -7,10 +7,10 @@
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/flip_and_rotate.rb'
 # =========================================================================== #
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
 module MultimediaParadise
 
+  require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+
   # ========================================================================= #
   # === MultimediaParadise.vertical_flip
   #
@@ -55,4 +55,4 @@ end
 if __FILE__ == $PROGRAM_NAME
   # MultimediaParadise.horizontal_flip(ARGV)
   MultimediaParadise.vertical_flip(ARGV)
-end # horizontal_flip
+end # horizontalflip

data/lib/multimedia_paradise/toplevel_methods/is_audio_file_is_video_file_is_image_file_is_multimedia_file.rb

@@ -0,0 +1,115 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/is_audio_file_is_video_file_is_image_file_is_multimedia_file.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+  require 'multimedia_paradise/constants/constants.rb'
+
+  # ========================================================================= #
+  # === 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?
+
+  # ========================================================================= #
+  # === 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?
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === 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; self.instance_eval { alias is_multimedia_file? is_a_multimedia_file? } # === MultimediaParadise.is_multimedia_file?
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e MultimediaParadise.is_image_file?('foobar.png')
+end

data/lib/multimedia_paradise/toplevel_methods/is_on_roebe.rb

@@ -11,7 +11,7 @@ module MultimediaParadise
   # === MultimediaParadise.is_on_roebe?
   # ========================================================================= #
   def self.is_on_roebe?
-    ENV['IS_ROEBE'] == '1'
+    ENV['IS_ROEBE'].to_s == '1'
   end
 
 end

data/lib/multimedia_paradise/toplevel_methods/{merge_multimedia_file.rb → merge.rb}

@@ -2,7 +2,7 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/merge_multimedia_file.rb'
+# require 'multimedia_paradise/toplevel_methods/merge.rb'
 # =========================================================================== #
 # MultimediaParadise.merge_mp3(:default, '*mp3')
 # MultimediaParadise.merge_avi_files
@@ -11,7 +11,97 @@ module MultimediaParadise
 
   require 'multimedia_paradise/colours/colours.rb'
   require 'multimedia_paradise/toplevel_methods/e.rb'
-  require 'multimedia_paradise/toplevel_methods/merge_these_videos.rb'
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+  require 'multimedia_paradise/toplevel_methods/directory_related_code.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
 
   # ========================================================================= #
   # === MultimediaParadise.merge_multimedia_file                  (merge tag)
@@ -36,7 +126,7 @@ module MultimediaParadise
       extname     = nil
     )
 
-    require 'multimedia_paradise/conversions/conversions.rb'
+    require 'multimedia_paradise/toplevel_methods/conversions.rb'
 
     if input_files.is_a?(String) and input_files.include? '*'
       input_files = Dir[input_files]
@@ -328,4 +418,8 @@ module MultimediaParadise
     run_sys_command _
   end
 
-end
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.merge_these_videos(ARGV)
+end # merge_these_videos foo.mp4 bar.mp4

data/lib/multimedia_paradise/toplevel_methods/opn.rb

@@ -4,19 +4,20 @@
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/opn.rb'
 # =========================================================================== #
-require 'multimedia_paradise/constants/namespace.rb'
-
 module MultimediaParadise
 
+  require 'multimedia_paradise/constants/constants.rb'
+
   begin
-    require 'opn'
+    require 'opn' # Failsafe require of opn.
   rescue LoadError; end
 
   # ========================================================================= #
   # === MultimediaParadise.opnn
   # ========================================================================= #
   def self.opnn(
-      i = { namespace: NAMESPACE }, &block
+      i = { namespace: NAMESPACE },
+      &block
     )
     Opn.opn(i, &block) if Object.const_defined? :Opn
   end; self.instance_eval { alias opn opnn } # === MultimediaParadise.opn

data/lib/multimedia_paradise/toplevel_methods/player_in_use.rb

@@ -6,6 +6,7 @@
 # =========================================================================== #
 module MultimediaParadise
 
+  require 'multimedia_paradise/constants/constants.rb'
   require 'multimedia_paradise/toplevel_methods/is_on_roebe.rb'
 
   # ========================================================================= #
@@ -22,9 +23,9 @@ module MultimediaParadise
   # This constant determines which video player to use. An environment
   # variable can overrule this, called USE_THIS_VIDEO_PLAYER.
   #
-  # Since as of December 2018 this should no longer be the primary
-  # means to set the multimedia-player in use for the project -
-  # instead, make use of MultimediaParadise.set_player_in_use().
+  # Since as of December 2018 this should no longer be the primary means
+  # to set the multimedia-player in use for the project - instead, make
+  # use of MultimediaParadise.set_player_in_use().
   # ========================================================================= #
   if ENV.has_key? 'USE_THIS_VIDEO_PLAYER'
     WHICH_VIDEO_PLAYER_TO_USE = "#{ENV['USE_THIS_VIDEO_PLAYER']}"
@@ -55,12 +56,13 @@ module MultimediaParadise
     )
     i = i.to_s.dup.strip # Make sure we have a String past this point.
     case i
-    when 'default',''
+    when 'default','' # This is the default entry point.
       # ====================================================================== #
       # Determine the default video-player in use for the MultimediaParadise
       # project. A constant keeps track of this value. Since as of June
       # 2020 a .yml file exists, and it will be used if it is available
-      # AND if we are on a roebe system..
+      # AND if we are on a roebe system - and it can be found too, hence
+      # the File.exist?() check.
       # ====================================================================== #
       if File.exist?(FILE_USE_THIS_VIDEO_PLAYER) and is_on_roebe?
         i = YAML.load_file(FILE_USE_THIS_VIDEO_PLAYER)
@@ -68,13 +70,18 @@ module MultimediaParadise
         i = WHICH_VIDEO_PLAYER_TO_USE
       end
     end
-    @player_in_use = i
+    @player_in_use = i # Assign it here.
   end; self.instance_eval { alias set_use_this_multimedia_player set_player_in_use } # === MultimediaParadise.set_use_this_multimedia_player
 
   # ========================================================================= #
   # And call it at once with the default, to have a proper state for the
   # variable.
   # ========================================================================= #
-  set_player_in_use
+  set_player_in_use(:default)
 
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e MultimediaParadise.player_in_use?
 end

data/lib/multimedia_paradise/toplevel_methods/query_the_audio_codec_of_this_file.rb

@@ -2,10 +2,10 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
 module MultimediaParadise
 
+  require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+
   # ========================================================================= #
   # === MultimediaParadise.query_the_audio_codec_of_this_file
   #
@@ -20,5 +20,6 @@ module MultimediaParadise
 end
 
 if __FILE__ == $PROGRAM_NAME
-  puts MultimediaParadise.query_the_audio_codec_of_this_file(ARGV)
+  alias e puts
+  e MultimediaParadise.query_the_audio_codec_of_this_file(ARGV)
 end # query_the_audio_codec_of_this_file /Depot/j/foobar.mp3

data/lib/multimedia_paradise/toplevel_methods/radio.rb

@@ -11,8 +11,6 @@
 module MultimediaParadise
 
   require 'multimedia_paradise/constants/constants.rb'
-  require 'multimedia_paradise/constants/encodings.rb'
-  require 'multimedia_paradise/constants/file_constants.rb'
   require 'multimedia_paradise/colours/colours.rb'
   require 'multimedia_paradise/toplevel_methods/e.rb'
   require 'multimedia_paradise/toplevel_methods/esystem.rb'
@@ -378,4 +376,4 @@ if __FILE__ == $PROGRAM_NAME
   e
   MultimediaParadise.play_radio(use_this_radio_station)
   # MultimediaParadise.play_radio_from_this_url 'https://stream.laut.fm/magicfm'
-end # display_radio_stations http://listen.radionomy.com:80/YourTranceRadio
+end # displayradiostations http://listen.radionomy.com:80/YourTranceRadio

data/lib/multimedia_paradise/toplevel_methods/return_all_video_files.rb

@@ -8,8 +8,8 @@
 module MultimediaParadise
 
   require 'yaml'
-  require 'multimedia_paradise/constants/file_constants.rb'
-  require 'multimedia_paradise/toplevel_methods/is_video_file.rb'
+  require 'multimedia_paradise/constants/constants.rb'
+  require 'multimedia_paradise/toplevel_methods/is_audio_file_is_video_file_is_image_file_is_multimedia_file.rb'
 
   # ========================================================================= #
   # === MultimediaParadise.available_video_files
@@ -24,8 +24,8 @@ module MultimediaParadise
   # ========================================================================= #
   # === MultimediaParadise.return_all_video_files
   #
-  # Use this method if you wish to return all video files registered
-  # in the main video_collection yaml file.
+  # This method can be used for returning (obtaining) all video files
+  # registered in the main video_collection yaml file.
   #
   # This will return a Hash that has entries similar to this one here:
   #

data/lib/multimedia_paradise/toplevel_methods/return_path_to_random_simpsons_video_file.rb

@@ -7,7 +7,7 @@
 # =========================================================================== #
 module MultimediaParadise
 
-  require 'multimedia_paradise/constants/directory_constants.rb'
+  require 'multimedia_paradise/constants/constants.rb'
   require 'multimedia_paradise/toplevel_methods/esystem.rb'
   require 'multimedia_paradise/toplevel_methods/player_in_use.rb'
 

data/lib/multimedia_paradise/toplevel_methods/return_random_video_file_from_the_video_collection.rb

@@ -5,12 +5,11 @@
 # require 'multimedia_paradise/toplevel_methods/return_random_video_file_from_the_video_collection.rb'
 # MultimediaParadise.return_random_video
 # =========================================================================== #
-
 module MultimediaParadise
 
-  require 'multimedia_paradise/constants/file_constants.rb'
+  require 'multimedia_paradise/constants/constants.rb'
   require 'multimedia_paradise/toplevel_methods/e.rb'
-  require 'multimedia_paradise/toplevel_methods/is_video_file.rb'
+  require 'multimedia_paradise/toplevel_methods/is_audio_file_is_video_file_is_image_file_is_multimedia_file.rb'
   require 'multimedia_paradise/toplevel_methods/return_all_video_files.rb'
 
   # ========================================================================= #
@@ -27,6 +26,9 @@ module MultimediaParadise
       shall_we_notify_the_user_if_the_video_file_is_missing = false
     )
     case shall_we_notify_the_user_if_the_video_file_is_missing
+    # ======================================================================= #
+    # === :notify_when_missing
+    # ======================================================================= #
     when :notify_when_missing
       shall_we_notify_the_user_if_the_video_file_is_missing = true
     end
@@ -38,7 +40,7 @@ module MultimediaParadise
     keys = video_collection.keys
     sample_key = keys.sample
     target = video_collection[sample_key]['title'] # This is the sample.
-    path = ::MultimediaParadise.realvids_directory?+'*'+target.tr(' ','*')+'*'
+    path = realvids_directory?+'*'+target.tr(' ','*')+'*'
     result = Dir[path]
     if result.is_a?(Array) and (result.size > 1)
       # ===================================================================== #
@@ -48,7 +50,7 @@ module MultimediaParadise
       result = is_video_file?(result)
     end
     if result.empty? and shall_we_notify_the_user_if_the_video_file_is_missing
-      e 'No file could be found at '+path+'.'
+      e "No file could be found at `#{path}`."
     end
     if result.is_a? Array
       result = result.first
@@ -60,7 +62,7 @@ module MultimediaParadise
   # === MultimediaParadise.return_random_video_that_exists
   # ========================================================================= #
   def self.return_random_video_that_exists
-    return Dir[::MultimediaParadise.realvids_directory?+'*'].select {|entry|
+    return Dir[realvids_directory?+'*'].select {|entry|
       MultimediaParadise.is_this_a_video_file?(entry)
     }.sample
   end
@@ -69,5 +71,5 @@ end
 
 if __FILE__ == $PROGRAM_NAME
   _ = MultimediaParadise.return_random_video_file_from_the_video_collection(:notify_when_missing)
-  puts _ if _  
+  puts _ if _
 end # return_random_video_file_from_the_video_collection

data/lib/multimedia_paradise/toplevel_methods/scale_video.rb

@@ -4,19 +4,18 @@
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/scale_video.rb'
 # =========================================================================== #
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
 module MultimediaParadise
 
   # ========================================================================= #
   # === MultimediaParadise.scale_this_video
   #
   # For the documentation of this method, please look at the method called
-  # MultimediaParadise.scale_this_video().
+  # MultimediaParadise.ffmpeg_scale_this_video().
   # ========================================================================= #
   def self.scale_this_video(
       this_video, optional_hash = {}
     )
+    require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
     ffmpeg_scale_this_video(this_video, optional_hash)
   end; self.instance_eval { alias resize_this_video scale_this_video } # === MultimediaParadise.resize_this_video
 
@@ -24,4 +23,4 @@ end
 
 if __FILE__ == $PROGRAM_NAME
   MultimediaParadise.scale_this_video(ARGV)
-end # scale_this_video ack.avi
+end # scalethisvideo ack.avi

data/lib/multimedia_paradise/toplevel_methods/set_title_of.rb

@@ -25,7 +25,7 @@ module MultimediaParadise
   # ========================================================================= #
   def self.set_title_of(
       these_audio_files = ARGV,
-      use_this_title    = nil
+      use_this_title    = nil # Pass the title of the video or audio file here.
     )
     [these_audio_files].flatten.compact.each {|this_audio_file|
       if use_this_title
@@ -41,13 +41,13 @@ module MultimediaParadise
         # =================================================================== #
         # Build up our main command next, via ffmpeg:
         # =================================================================== #
-        _ = 'ffmpeg -i '+
-            this_audio_file+
-            ' -metadata title="'+use_this_title+'" '\
-            '-codec copy '+new_filename
+        _ = "ffmpeg -i "+
+            "#{this_audio_file}"+
+            ' -metadata title="'+use_this_title+'" '+
+            "-codec copy #{new_filename}"
         esystem _
         if File.exist? new_filename
-          e "#{rev}Stored at `#{sfile(new_filename)}`."
+          e "#{rev}Stored at `#{sfile(new_filename)}#{rev}`."
         end
       end
     }

data/lib/multimedia_paradise/{help/help.rb → toplevel_methods/show_help.rb}

@@ -2,7 +2,7 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'multimedia_paradise/help/help.rb'
+# require 'multimedia_paradise/toplevel_methods/show_help.rb'
 # =========================================================================== #
 module MultimediaParadise
 
@@ -19,14 +19,16 @@ module MultimediaParadise
   #   mpa --help
   #
   # ========================================================================= #
-  def self.show_help
-    e "#{rev}You can use the MultimediaParadise project in this manner:"
+  def self.show_help(
+      i = $PROGRAM_NAME
+    )
+    e "#{rev}The MultimediaParadise project can be used as follows:"
     e
-    e '  '+simp($PROGRAM_NAME.to_s)+' foo.mp3 foo.wav'
+    e "  #{simp(i.to_s)} foo.mp3 foo.wav"
     e
-    e 'This would convert '+orange('foo.mp3')+' into '+orange('foo.wav')
+    e "#{rev}This would convert #{orange('foo.mp3')}#{rev} into #{orange('foo.wav')}"
     e
-    e '  --formats              # Will list all available format-conversions.'
+    e "#{rev}  --formats              # Will list all available format-conversions."
     e
     e '  --increase_volume file # Use this to increase the volume of an '\
       'audio file'
@@ -43,8 +45,8 @@ module MultimediaParadise
     e
     e '  --radio?               # Show URLs to radio-stations for '\
       'use in e. g. '+orange('rhythmbox')
-    e '  --cut-audio            # Start the libui-wrapper for '\
-      'cutting multimedia files (such as a .mp3 file)'
+    e "#{rev}  --cut-audio            # Start the libui-wrapper for "\
+      "cutting multimedia files (such as a .mp3 file)"
     e
   end
 
@@ -72,4 +74,8 @@ EOF
     e intro # Output the intro.
   end
 
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise.show_intro
 end

data/lib/multimedia_paradise/toplevel_methods/slow_down_this_video_file.rb

@@ -4,8 +4,6 @@
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/slow_down_this_video_file.rb'
 # =========================================================================== #
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
 module MultimediaParadise
 
   # ========================================================================= #
@@ -23,6 +21,7 @@ module MultimediaParadise
   def self.slow_down_this_video_file(
       this_video_file = ARGV
     )
+    require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
     ffmpeg_slow_down_this_video_file(this_video_file)
   end
 
@@ -30,4 +29,4 @@ end
 
 if __FILE__ == $PROGRAM_NAME
   MultimediaParadise.slow_down_this_video_file(ARGV)
-end # slow_down_this_video_file foobar.mp4
+end # slowdownthisvideofile foobar.mp4

data/lib/multimedia_paradise/toplevel_methods/start_screencast.rb

@@ -9,8 +9,6 @@
 # =========================================================================== #
 module MultimediaParadise
 
-  require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
   # ========================================================================= #
   # === MultimediaParadise.start_screencast
   #
@@ -46,6 +44,7 @@ module MultimediaParadise
       use_this_framerate         = '25',     # ← This is the option -r to ffmpeg.
       use_this_video_codec       = 'huffyuv' # ← or libx264, for instance.
     )
+    require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
     ffmpeg_start_screencast(
       use_this_screen_resolution,
       output_filename,
@@ -60,7 +59,9 @@ module MultimediaParadise
   # This is mostly an ad-hoc method.
   # ========================================================================= #
   def self.record_my_desktop
+    e
     esystem 'ffmpeg -video_size 1920x1080 -framerate 30 -f x11grab -i :0.0 -c:v libx264 -qp 0 -preset ultrafast capture.mkv'
+    e
   end
 
 end