multimedia_paradise 1.1.344 → 1.2.2

data/lib/multimedia_paradise/toplevel_methods/audio_related_code.rb

@@ -0,0 +1,138 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/audio_related_code.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+  require 'multimedia_paradise/toplevel_methods/e.rb'
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================= #
+  # === MultimediaParadise.delay_audio
+  #
+  # This method will delay the audio of a video-file, by n-seconds.
+  #
+  # The second argument to this method, `by`, handles that delay.
+  # ========================================================================= #
+  def self.delay_audio(
+      this_file = ARGV,
+      by        = '3.85 seconds' # <- Input your delay here.
+    )
+    require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+    ffmpeg_delay_audio(this_file, by)
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.has_audio?
+  #
+  # This method can determine whether a multimedia-file has audio or
+  # does not.
+  # ========================================================================= #
+  def self.has_audio?(
+      i = ARGV
+    )
+    if i.is_a? Array
+      i = i.flatten.first
+    end
+    result = `ffprobe -i #{i} -show_streams -select_streams a -loglevel error`.to_s.strip
+    !result.empty?
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.verbose_output_has_audio?
+  #
+  # This variant will show verbose output.
+  # ========================================================================= #
+  def self.verbose_output_has_audio?(i = ARGV)
+    require 'multimedia_paradise/colours/colours.rb'
+    result = has_audio?(i)
+    if result
+      e "#{rev}Yes, the file at "
+      e sfile("  #{i}")
+      e "#{rev}does contain an audio stream."
+    else
+      e "#{rev}No, the file at "
+      e sfile("  #{i}")
+      e "#{rev}does NOT contain an audio stream."
+    end
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.increase_volume_of_this_audio_file
+  #
+  # The toplevel-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
+
+  # ========================================================================= #
+  # === 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
+    )
+    require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+    ffmpeg_analyze_audio_stream(of_this_file)
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  ARGV.each {|entry|
+    e MultimediaParadise.verbose_output_has_audio?(entry)
+  }
+  # MultimediaParadise.delay_audio(ARGV)
+  MultimediaParadise.delay_audio(ARGV, 80)
+  pp MultimediaParadise.analyze_audio_stream(ARGV)
+  MultimediaParadise.increase_volume_of_this_audio_file(ARGV, '+20dB')
+end # analyze_audio $MY_SONGS/YoonDohyun_Dolgo.mp3
+    # hasaudio
+    # delayaudio foo.mp4
+    # increase_volume_of_this_audio_file

data/lib/multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb

@@ -4,10 +4,10 @@
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb'
 # =========================================================================== #
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
 module MultimediaParadise
 
+  require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+
   # ========================================================================= #
   # === MultimediaParadise.chop_into_segments_of_n_seconds_size
   #

data/lib/multimedia_paradise/{conversions → toplevel_methods}/conversions.rb

@@ -2,6 +2,8 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
+# Conversion-related methods will be stored in this file.
+#
 # Code in this .rb file has to do with converting multimedia formats, and
 # thus will contain all kind of conversion-related aspects - but it can
 # also be used for cutting, splitting etc.. of audio files, at the least
@@ -12,7 +14,6 @@
 # called image_paradise.
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/conversions.rb'
-# MultimediaParadise.video_to_images
 # =========================================================================== #
 module MultimediaParadise
 
@@ -24,13 +25,14 @@ module MultimediaParadise
     require 'cliner'
   rescue LoadError; end
 
-  require 'multimedia_paradise/constants/conversions.rb'
+  require 'multimedia_paradise/constants/constants.rb'
+  require 'multimedia_paradise/actions/actions.rb'
+  require 'multimedia_paradise/toplevel_methods/directory_related_code.rb'
   require 'multimedia_paradise/toplevel_methods/e.rb'
   require 'multimedia_paradise/toplevel_methods/esystem.rb'
-  require 'multimedia_paradise/toplevel_methods/merge_multimedia_file.rb'
-  require 'multimedia_paradise/toplevel_methods/output_directory.rb'
+  require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+  require 'multimedia_paradise/toplevel_methods/merge.rb'
   require 'multimedia_paradise/toplevel_methods/rds.rb'
-  require 'multimedia_paradise/toplevel_methods/run_sys_command.rb'
 
   # ========================================================================= #
   # === @use_this_binary_for_conversions
@@ -54,6 +56,110 @@ module MultimediaParadise
     Cliner.cliner
   end
 
+  # ========================================================================= #
+  # === MultimediaParadise.to_mp4
+  # ========================================================================= #
+  def self.to_mp4(*these_files)
+    File.absolute_path(
+      ffmpeg_to_mp4(these_files)
+    )
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.to_gif
+  #
+  # This method can be used to quickly turn an .avi file or a .mp4
+  # file into an animated .gif.
+  #
+  # The quality is pretty low, so this is not ideal, but if you
+  # have a use case for animated .gif files then this is one
+  # way to do so.
+  #
+  # Usage example:
+  #
+  #   MultimediaParadise.to_gif('foobar.mp4')
+  #
+  # ========================================================================= #
+  def self.to_gif(i)
+    [i].flatten.compact.each {|this_video_file|
+      _ = File.basename(this_video_file).
+               delete_suffix(
+                 File.extname(this_video_file)
+               )
+      name_of_the_output_gif_file = "output_#{_}.gif"
+      cmd = "ffmpeg -i #{this_video_file} -pix_fmt rgb8 #{name_of_the_output_gif_file}" # Or use 0rgb.
+      esystem(cmd)
+      return name_of_the_output_gif_file
+    }
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.to_ts
+  #
+  # This will batch-convert all .mp4 files into .ts files.
+  # ========================================================================= #
+  def self.to_ts
+    files = Dir['*.mp4']
+    files.each {|this_file|
+      cmd = 'ffmpeg -i '+this_file+' -c copy '\
+            '-bsf:v h264_mp4toannexb -f mpegts '+
+            this_file.sub(/#{File.extname(this_file)}$/,'')+
+            '.ts'
+
+      esystem cmd
+    }
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.to_ogg
+  #
+  # Convert e. g. a .mp3 file into an .ogg file.
+  #
+  # The first argument should be an Array.
+  #
+  # The name MultimediaParadise.codec_conversion() is a legacy name for
+  # this method.
+  #
+  # In raw ffmpeg this method would be similar to:
+  #
+  #   ffmpeg -i input.mp3 -c:a libvorbis output.ogg
+  #
+  # ========================================================================= #
+  def self.to_ogg(
+      input_files,
+      use_this_codec = :libvorbis
+    )
+    [input_files].flatten.compact.each {|this_input_file|
+      action(:to_ogg, this_input_file)
+    }
+  end; self.instance_eval { alias codec_conversion to_ogg } # === MultimediaParadise.codec_conversion
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === MultimediaParadise.to_aiff
+  # ========================================================================= #
+  def self.to_aiff(i)
+    MultimediaParadise.esystem(
+      "ffmpeg -i #{_} -f aiff -ab 128000 -ar 44100 #{_}.aif"
+    )
+  end
+
   # ========================================================================= #
   # === MultimediaParadise.general_format_conversion
   #
@@ -107,7 +213,7 @@ module MultimediaParadise
       # ===================================================================== #
       when /^to(_|-)?ogg$/i,
            /ogg$/i
-        target_file = input_file.gsub(File.extname(input_file), '')+'.ogg'
+        return MultimediaParadise.to_ogg(input_file)
       # ===================================================================== #
       # === to_aac
       # ===================================================================== #
@@ -132,7 +238,8 @@ module MultimediaParadise
       # ===================================================================== #
       when /^to(_|-)?mp3$/i,
            /mp3$/i
-        target_file = input_file.gsub(File.extname(input_file), '')+'.mp3'
+        MultimediaParadise.to_mp3(input_file)
+        return
       # ===================================================================== #
       # === to_mp3
       # ===================================================================== #
@@ -178,13 +285,13 @@ module MultimediaParadise
           please_be_patient(
             input_file, 'to '+File.extname(target_file)+' format'
           )
-          ::MultimediaParadise.display_warning(:lossy)
+          MultimediaParadise.display_warning(:lossy)
         }
         # =================================================================== #
         # By default we will use ffmpeg, but this can be changed to sox or
         # any other toolkit.
         # =================================================================== #
-        _ = "#{::MultimediaParadise.use_this_binary_for_conversions?} -y ".dup
+        _ = "#{use_this_binary_for_conversions?} -y ".dup
         _ << " -i #{input_file} "
         # =================================================================== #
         # Do some ad-hoc clean up next.
@@ -222,27 +329,11 @@ module MultimediaParadise
   end; self.instance_eval { alias convert          general_format_conversion } # === MultimediaParadise.convert
        self.instance_eval { alias basic_conversion general_format_conversion } # === MultimediaParadise.basic_conversion
 
-  # ========================================================================= #
-  # === MultimediaParadise.mp4_to_mp3
-  # ========================================================================= #
-  def self.mp4_to_mp3(a, b = '.mp3')
-    ::MultimediaParadise.general_format_conversion(a, b)
-  end
-
-  # ========================================================================= #
-  # === MultimediaParadise.ogg_to_mp3
-  #
-  # Convert .ogg files into .mp3 files.
-  # ========================================================================= #
-  def self.ogg_to_mp3(this_file, to = '.mp3')
-    ::MultimediaParadise.general_format_conversion(this_file, to)
-  end
-
   # ========================================================================= #
   # === MultimediaParadise.mp3_to_opus
   # ========================================================================= #
   def self.mp3_to_opus(this_file, to = '.opus')
-    ::MultimediaParadise.general_format_conversion(this_file, to)
+    MultimediaParadise.general_format_conversion(this_file, to)
   end
 
   # ========================================================================= #
@@ -281,7 +372,7 @@ module MultimediaParadise
   # From .m4a audio to a .mp3 file.
   # ========================================================================= #
   def self.m4a_to_mp3(this_file, to = '.mp3')
-    ::MultimediaParadise.general_format_conversion(this_file, to)
+    MultimediaParadise.general_format_conversion(this_file, to)
   end
 
   # ========================================================================= #
@@ -291,22 +382,17 @@ module MultimediaParadise
   # ffmpeg for this. This may be superior to the other variants actually.
   # ========================================================================= #
   def self.any_to_mp3(this_file, to = '.mp3')
-    ::MultimediaParadise.general_format_conversion(this_file, to)
+    MultimediaParadise.general_format_conversion(this_file, to)
   end
 
   # ========================================================================= #
-  # === MultimediaParadise.decrease_volume
+  # === MultimediaParadise.convert_these_images_into_a_video
   #
-  # This should decrease audio volume, by using sox.
-  #
-  # We do this by using the command --volume FACTOR.
+  # This method can be used to "assemble" images into a video.
   # ========================================================================= #
-  def self.decrease_volume(
-      of_this_file,
-      by_how_much = '0.5'
-    )
-    run_sys_command 'sox --volume '+
-                     by_how_much+' '+of_this_file+' AUDIO_REDUCED_'+of_this_file 
+  def self.convert_these_images_into_a_video(*images)
+    _ = 'ffmpeg -f image2 -i '+images.join(' ').strip+' video.mpg'
+    esystem _
   end
 
   # ========================================================================= #
@@ -317,7 +403,7 @@ module MultimediaParadise
   # We will use ffmpeg for this conversion.
   # ========================================================================= #
   def self.wav_to_opus(this_file, to = '.opus')
-    ::MultimediaParadise.general_format_conversion(this_file, to)
+    MultimediaParadise.general_format_conversion(this_file, to)
   end
   
   # ========================================================================= #
@@ -346,7 +432,7 @@ module MultimediaParadise
   def self.wav_to_mp3(
       this_file, bitrate_to_use = 192, to = '.mp3'
     )
-    ::MultimediaParadise.general_format_conversion(this_file, to) {{
+    MultimediaParadise.general_format_conversion(this_file, to) {{
       bitrate_to_use: bitrate_to_use
     }}
   end
@@ -529,7 +615,7 @@ module MultimediaParadise
   def self.au_to_wav(
       this_file, to = 'wav'
     )
-    ::MultimediaParadise.general_format_conversion(this_file, to: ot)
+    MultimediaParadise.general_format_conversion(this_file, to: ot)
   end
 
   # ========================================================================= #
@@ -681,7 +767,7 @@ module MultimediaParadise
     )
     optional_target_format = optional_target_format.to_s
     optional_target_format << ' ' if optional_target_format.empty?
-    opn; e 'Converting `'+::MultimediaParadise.sfile(file)+'` '+
+    opn; e 'Converting `'+sfile(file)+'` '+
             optional_target_format.strip+
            ' next, please be patient.'
   end
@@ -842,7 +928,7 @@ module MultimediaParadise
       this_file,
       to = '.aac'
     )
-    ::MultimediaParadise.general_format_conversion(this_file, to)
+    MultimediaParadise.general_format_conversion(this_file, to)
   end; self.instance_eval { alias to_aac mp3_to_aac } # === MultimediaParadise.to_aac
 
   # ========================================================================= #
@@ -861,7 +947,7 @@ module MultimediaParadise
       this_file,
       to = '.ogg'
     )
-    ::MultimediaParadise.general_format_conversion(this_file, to)
+    MultimediaParadise.general_format_conversion(this_file, to)
   end; self.instance_eval { alias mp3toogg mp3_to_ogg } # === MultimediaParadise.mp3toogg
        self.instance_eval { alias mp32ogg  mp3_to_ogg } # === MultimediaParadise.mp32ogg
        self.instance_eval { alias to_ogg   mp3_to_ogg } # === MultimediaParadise.to_ogg
@@ -875,7 +961,7 @@ module MultimediaParadise
   #
   # ========================================================================= #
   def self.webm_to_mp3(a, b = '.mp3')
-    ::MultimediaParadise.general_format_conversion(a, b)
+    MultimediaParadise.general_format_conversion(a, b)
   end
 
   # ========================================================================= #
@@ -887,7 +973,7 @@ module MultimediaParadise
   #
   # ========================================================================= #
   def self.to_webm(a, b = '.webm')
-    ::MultimediaParadise.general_format_conversion(a, b)
+    MultimediaParadise.general_format_conversion(a, b)
   end
 
   # ========================================================================= #
@@ -899,7 +985,7 @@ module MultimediaParadise
   #
   # ========================================================================= #
   def self.to_mkv(a, b = '.mkv')
-    ::MultimediaParadise.general_format_conversion(a, b)
+    MultimediaParadise.general_format_conversion(a, b)
   end
 
   # ========================================================================= #
@@ -913,12 +999,18 @@ module MultimediaParadise
   #
   # ========================================================================= #
   def self.to_dv(a, b = '.dv')
-    ::MultimediaParadise.general_format_conversion(a, b)
+    MultimediaParadise.general_format_conversion(a, b)
   end
 
 end
 
 if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  # ========================================================================= #
+  # The next variants should be conversions in individual bin/ files:
+  # ========================================================================= #
+  MultimediaParadise.to_mp4(ARGV)
+  MultimediaParadise.to_flac(ARGV)
   # MultimediaParadise.extract_audio_from_until('/Depot/j/foobar.mp4')
   # MultimediaParadise.increase_volume '/Depot/j/CLIPPED_foobar.mp4', '3'
   # MultimediaParadise.increase_volume '/Depot/j/ack.mp3', '1.5'

data/lib/multimedia_paradise/toplevel_methods/copy_and_merge_this_video_n_times.rb

@@ -4,13 +4,13 @@
 # =========================================================================== #
 # 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
 
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+  require 'multimedia_paradise/toplevel_methods/files_related_code.rb'
+  require 'multimedia_paradise/toplevel_methods/merge.rb'
+  require 'multimedia_paradise/colours/colours.rb'
+
   # =========================================================================== #
   # === MultimediaParadise.copy_and_merge_this_video_n_times
   #

data/lib/multimedia_paradise/toplevel_methods/create_video_from_this_audio.rb

@@ -4,12 +4,12 @@
 # =========================================================================== #
 # 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
 
+  require 'multimedia_paradise/toplevel_methods/e.rb'
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+  require 'multimedia_paradise/toplevel_methods/is_audio_file_is_video_file_is_image_file_is_multimedia_file.rb'
+
   # ========================================================================= #
   # === MultimediaParadise.create_video_from_this_audio
   #
@@ -61,5 +61,6 @@ module MultimediaParadise
 end
 
 if __FILE__ == $PROGRAM_NAME
-  MultimediaParadise.create_video_from_this_audio(ARGV)
-end # create_video_from_this_audio
+  MultimediaParadise.create_video_from_this_audio(ARGV[0], ARGV[1])
+end # createvideofromthisaudio foobar.mp3 /home/x/data/images/NJOY/Susanne_03.jpg
+    # createvideofromthisaudio foobar.mp3 foobar.jpg

data/lib/multimedia_paradise/toplevel_methods/cut_from_to.rb

@@ -124,11 +124,11 @@ module MultimediaParadise
         _ << " #{output_file}"
         esystem _
         if File.exist? output_file
-          e "Created file at `#{sfile(output_file)}`."
+          e "Created file at `#{sfile(output_file)}#{rev}`."
           return File.absolute_path(output_file) # And return it here, just to make this method more useful.
         end
       else
-        e "No file exists at #{use_this_file}."
+        no_file_exists_at(use_this_file)
       end
     else
       e 'Please provide a valid file, via a key called '\

data/lib/multimedia_paradise/toplevel_methods/denoise.rb

@@ -4,10 +4,10 @@
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/denoise.rb'
 # =========================================================================== #
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-
 module MultimediaParadise
 
+  require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+
   # ========================================================================= #
   # === MultimediaParadise.denoise
   #

data/lib/multimedia_paradise/toplevel_methods/deshake.rb

@@ -4,10 +4,10 @@
 # =========================================================================== #
 # require 'multimedia_paradise/toplevel_methods/deshake.rb'
 # =========================================================================== #
-require 'multimedia_paradise/toplevel_methods/esystem.rb'
-
 module MultimediaParadise
 
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+
   # ========================================================================= #
   # === MultimediaParadise.deshake
   #
@@ -29,11 +29,8 @@ module MultimediaParadise
       output_file = "output_#{input_file}"
       use_this_command = "ffmpeg -i #{input_file} -vf deshake #{output_file}"
       e
-      e use_this_command
-      e
-      system use_this_command
+      esystem use_this_command, :steelblue, :use_newline
     end
-    
   end
 
 end

data/lib/multimedia_paradise/toplevel_methods/{output_directory.rb → directory_related_code.rb}

@@ -2,12 +2,39 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/output_directory.rb'
+# require 'multimedia_paradise/toplevel_methods/directory_related_code.rb'
 # =========================================================================== #
 module MultimediaParadise
 
+  require 'fileutils'
   require 'multimedia_paradise/toplevel_methods/is_on_roebe.rb'
 
+  # ========================================================================= #
+  # === MultimediaParadise.mkdir
+  #
+  # This method can be used to create a directory on the local computer
+  # system.
+  # ========================================================================= #
+  def self.mkdir(i)
+    FileUtils.mkdir_p(i)
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.ensure_that_the_output_directory_exists
+  #
+  # We must make sure that the output directory exists, hence the
+  # check belove and the call to FileUtils.mkdir_p().
+  # ========================================================================= #
+  def self.ensure_that_the_output_directory_exists(
+      output_directory = MultimediaParadise.output_directory?
+    )
+    unless File.exist? output_directory
+      FileUtils.mkdir_p(
+        output_directory
+      )
+    end
+  end
+
   # ========================================================================= #
   # === @output_directory
   # ========================================================================= #
@@ -58,4 +85,14 @@ module MultimediaParadise
        self.instance_eval { alias log_directory?          output_directory? } # === MultimediaParadise.log_directory?
        self.instance_eval { alias log_dir?                output_directory? } # === MultimediaParadise.log_dir?
 
+  # ========================================================================= #
+  # === MultimediaParadise.chdir
+  #
+  # Use this method if you wish to change directory to another target
+  # directory.
+  # ========================================================================= #
+  def self.chdir(i)
+    Dir.chdir(i) if File.directory? i
+  end; self.instance_eval { alias cd chdir } # === MultimediaParadise.cd
+
 end