multimedia_paradise 1.1.344 → 1.2.2

data/lib/multimedia_paradise/toplevel_methods/encode_this_video.rb

@@ -5,10 +5,10 @@
 # require 'multimedia_paradise/toplevel_methods/encode_this_video.rb'
 # MultimediaParadise.encode_this_video('foobar.avi')
 # =========================================================================== #
-require 'multimedia_paradise/toplevel_methods/esystem.rb'
-
 module MultimediaParadise
 
+  require 'multimedia_paradise/toplevel_methods/esystem.rb'
+
   # ========================================================================= #
   # === MultimediaParadise.encode_this_video
   #
@@ -22,7 +22,8 @@ module MultimediaParadise
   #
   # ========================================================================= #
   def self.encode_this_video(
-      i = ARGV, use_this_mode = :CRF
+      i             = ARGV,
+      use_this_mode = :CRF
     )
     [i].flatten.compact.each {|this_video|
       if File.exist? this_video
@@ -31,13 +32,16 @@ module MultimediaParadise
                           sub(/#{File.extname(this_video)}$/,'')+
                           '.mkv'
         case use_this_mode
+        # =================================================================== #
+        # === :CRF
+        # =================================================================== #
         when :CRF, :default
           _ = 'ffmpeg -i '+this_video+' -c:v libx264 '\
               '-preset slow -crf 22 -c:a copy '+output_filename
           esystem _
         end
       else
-        e 'No file exists at '+this_video+'.'
+        no_file_exists_at(this_video)
       end
     }
   end

data/lib/multimedia_paradise/toplevel_methods/esystem.rb

@@ -19,23 +19,62 @@ module MultimediaParadise
   # Currently only Hashes are supported like that.
   # ========================================================================= #
   def self.esystem(
-      i, optional_colour_to_use = nil
+      i,
+      optional_colour_to_use = nil,
+      use_a_newline_before_the_system_command = false
     )
+    case use_a_newline_before_the_system_command
+    # ======================================================================= #
+    # === :use_a_newline
+    # ======================================================================= #
+    when :use_a_newline,
+         :use_newline
+      use_a_newline_before_the_system_command = true
+    end
     Signal.trap('SIGINT') { exit }
     i = i.dup if i.frozen?
     i.strip!
     display_this_string = i.dup
     if optional_colour_to_use
-      if optional_colour_to_use.is_a?(Hash) and
-         optional_colour_to_use.has_key?(:colour)
-        use_this_colour = optional_colour_to_use[:colour]
+      if (optional_colour_to_use.is_a?(Hash) and
+          optional_colour_to_use.has_key?(:colour)) or
+          optional_colour_to_use.is_a?(Symbol)
+        if optional_colour_to_use.is_a? Hash
+          use_this_colour = optional_colour_to_use[:colour]
+        else
+          use_this_colour = optional_colour_to_use
+        end
         display_this_string = COLOURS.send(use_this_colour, display_this_string) 
       end
     end
     e display_this_string
+    e if use_a_newline_before_the_system_command
     system i
   end
 
+  # ========================================================================= #  
+  # === MultimediaParadise.run_sys_command                 (sys tag, sys cmd)
+  #
+  # Echo the command before running it via ``. This is the main difference
+  # towards the other method called MultimediaParadise.esystem(). 
+  # ========================================================================= #
+  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})"
+      return nil
+    end
+  end
+
 end
 
 if __FILE__ == $PROGRAM_NAME

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

@@ -2,7 +2,11 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
+# This file will specifically include code that relates to ffmpeg. On top
+# of that, most methods (or even all methods) that are listed here will
+# start with the substring "ffmpeg_".
+# =========================================================================== #
+# require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
 # =========================================================================== #
 module MultimediaParadise
 
@@ -49,6 +53,145 @@ module MultimediaParadise
     alias return_image_from_this_video_file ffmpeg_return_image_from_this_video_file # === MultimediaParadise.return_image_from_this_video_file
   }
 
+  # ========================================================================= #
+  # === MultimediaParadise.ffmpeg_slow_down_this_video_file
+  #
+  # This method can be used to slow down a video file.
+  #
+  # FFmpeg will be doing this slow down action.
+  #
+  # This uses the "setpts" video filter of ffmpeg, for the video stream
+  # at hand. The video stream can be changed without tampering with
+  # the audio stream. This is also the default modus operandi for this
+  # method here.
+  # ========================================================================= #
+  def self.ffmpeg_slow_down_this_video_file(
+      this_video_file  = ARGV,
+      pts_value_to_use = 2.0
+    )
+    if this_video_file.is_a? Array
+      this_video_file.each {|entry|
+        ffmpeg_slow_down_this_video_file(entry, pts_value_to_use)
+      }
+    else
+      # ===================================================================== #
+      # To slow down a video, a  multiplier greater than 1 has to be used: 
+      # ===================================================================== #
+      _ = "ffmpeg -i #{this_video_file} -filter:v \"setpts=#{pts_value_to_use}*PTS\" "\
+          "OUTPUT_SLOWED_DOWN_VIDEO_#{this_video_file}"
+      esystem _
+    end
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.ffmpeg_flip_video_to_the_right
+  #
+  # This toplevel-method can be used to flip a video to the right,
+  # that is, to rotate it by +90 degrees.
+  # ========================================================================= #
+  def self.ffmpeg_flip_video_to_the_right(i)
+    _ = "ffmpeg -i #{i} -vf transpose=1 flipped_to_the_right_#{i}"
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.ffmpeg_flip_video_to_the_left
+  #
+  # This toplevel-method can be used to flip a video to the left,
+  # that is, to rotate it by -90 degrees.
+  #
+  # Strangely enough the number 2 denotes left-hand flipping (or,
+  # to remain in ffmpeg-parlance, this means "90°CounterClockwise"
+  # rotation).
+  # ========================================================================= #
+  def self.ffmpeg_flip_video_to_the_left(i)
+    _ = "ffmpeg -i #{i} -vf transpose=2 flipped_to_the_left_#{i}"
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.ffmpeg_extract_audio
+  #
+  # This method will specifically use ffmpeg in order to extract the
+  # audio from a video or audio file.
+  # ========================================================================= # 
+  def self.ffmpeg_extract_audio(
+      i = input.mkv, # The input filename.
+      o = :ogg       # The output filename.
+    )
+    extname = File.extname(i)
+    case o
+    # ======================================================================= #
+    # === :ogg
+    # ======================================================================= #
+    when :ogg
+      use_this_name = i.
+                      sub(/#{extname}$/,'')
+      o = use_this_name+'.ogg'
+    end
+    esystem 'ffmpeg -i '+i+' -vn '+o
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise.ffmpeg_convert_this_multimedia_file
+  #
+  # This method can be used to convert a file from A to B, through
+  # ffmpeg.
+  #
+  # Remember that the command ffmpeg -codecs will print every codec
+  # FFmpeg knows about.
+  # ========================================================================= #
+  def self.ffmpeg_convert_this_multimedia_file(
+      input_file  = 'input.mp3',
+      output_file = :mkv #'output.ogg'
+    )
+    yielded = nil
+    if block_given?
+      yielded = yield
+    end
+    if File.exist? input_file
+      case output_file
+      when :mkv
+        extname = File.extname(input_file)
+        use_this_name = input_file.
+                        sub(/#{extname}$/,'')
+        output_file = use_this_name+'.mkv'
+      end
+      _ = "ffmpeg -i #{input_file}"
+      case yielded
+      # ===================================================================== #
+      # === :copy_audio
+      # ===================================================================== #
+      when :copy_audio
+        _ << ' -c:a copy' 
+      # ===================================================================== #
+      # === :libvorbis_audiostream
+      # ===================================================================== #
+      when :libvorbis_audiostream
+        _ << ' -c:a libvorbis'
+      # ===================================================================== #
+      # === :vp9_codec
+      # ===================================================================== #
+      when :vp9_codec
+        _ << ' -c:v vp9' 
+      else
+        if yielded.is_a? Hash
+          # ================================================================= #
+          # === :framerate
+          # ================================================================= #
+          if yielded.has_key? :framerate
+            _ << " -r #{yielded.delete(:framerate)}"
+          end
+        end
+      end
+      _ << " #{output_file}"
+      e _
+      system _
+    else
+      e 'No file exists at '+input_file+'.'
+    end
+  end
+
   # ========================================================================= #
   # === MultimediaParadise.ffmpeg_chroma_subsampling
   #
@@ -72,7 +215,7 @@ module MultimediaParadise
   # effect.
   #
   # Yadif ("yet another deinterlacing filter") is the name of the
-  # filter used by ffmpeg. 
+  # filter used by ffmpeg.
   # ========================================================================= #
   def self.ffmpeg_deinterlace_this_video(this_video)
     esystem 'ffmpeg -i '+this_video+' -vf yadif output.mp4'
@@ -181,88 +324,6 @@ module MultimediaParadise
   end; self.instance_eval { alias ffmpeg_audio_codec?          ffmpeg_query_the_audio_codec_of_this_file } # === MultimediaParadise.ffmpeg_audio_codec?
        self.instance_eval { alias ffmpeg_query_the_audio_codec ffmpeg_query_the_audio_codec_of_this_file } # === MultimediaParadise.ffmpeg_query_the_audio_codec
 
-  # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_vertical_flip
-  #
-  # This method will make use of the video-filter called "vflip". A
-  # vertical flip will flip the video from head-to-bottom, so people
-  # will suddenly appear as if they are hanging from the ceiling. :)
-  #
-  # Invocation example:
-  #
-  #   MultimediaParadise.ffmpeg_vertical_flip '/Depot/Video/Reallife/O.J.Simpson_TV_News_etwa_1995.avi'
-  #
-  # ========================================================================= #
-  def self.ffmpeg_vertical_flip(this_video_file)
-    if this_video_file.is_a? Array
-      this_video_file.each {|entry| ffmpeg_vertical_flip(entry) }
-    else
-      extname = File.extname(this_video_file)
-      base_dir = File.dirname(this_video_file)
-      filename = File.basename(this_video_file)
-      output_name = base_dir+'/vertical_flip_'+filename.sub(/#{extname}/,'')+extname
-      _ = 'ffmpeg -i '+this_video_file+' -vf "vflip" '+output_name
-      esystem _
-      output_name # <- Also return the output name here.
-    end
-  end; self.instance_eval { alias ffmpeg_flip_upside_down ffmpeg_vertical_flip } # === MultimediaParadise.flip_upside_down
-
-  # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_horizontal_flip
-  #
-  # This method will make use of the video-filter called "hflip".
-  # ========================================================================= #
-  def self.ffmpeg_horizontal_flip(this_video_file)
-    if this_video_file.is_a? Array
-      this_video_file.each {|entry| horizontal_flip(entry) }
-    else
-      extname = File.extname(this_video_file)
-      output_name = 'horizontal_flip_'+this_video_file.sub(/#{extname}/,'')+extname
-      _ = 'ffmpeg -i '+this_video_file+' -vf "hflip" '+output_name
-      esystem _
-      output_name # <- Also return the output filename here.
-    end
-  end
-
-  # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_rotate_this_video_file_by_90_degrees
-  #
-  # This method can be used to rotate a video file by 90°. Sometimes
-  # smartphones create tilted videos, so this method can correct
-  # this distortion.
-  #
-  # This can be fixed by using FFMPEG's transpose filter. The
-  # transpose value will work in multiples of 90, so "1"
-  # means 90°.
-  #
-  # Invocation example:
-  #
-  #   MultimediaParadise.ffmpeg_rotate_this_video_file_by_90_degrees('foo.mpg')
-  #
-  # ========================================================================= #
-  def self.ffmpeg_rotate_this_video_file_by_90_degrees(
-      this_video_file
-    )
-    output_file = 'output_'+this_video_file+'.mp4' 
-    _ = 'ffmpeg -i '+this_video_file+' -vf transpose=1 '+output_file
-    esystem _
-    output_file # <- And return the output file too.
-  end
-
-  # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_increase_volume_of_this_audio_file
-  # ========================================================================= #
-  def self.ffmpeg_increase_volume_of_this_audio_file(
-      input_file,
-      modify_volume_by_this_value = '5.0' # or 3.0 or 4.0 and so forth.
-    )
-    [input_file].flatten.compact.each {|this_file|
-      _ = 'ffmpeg -i '+this_file+' -vcodec copy -af "volume='+modify_volume_by_this_value.to_s+
-         '" output_'+this_file
-      esystem _
-    }
-  end
-
   # ========================================================================= #
   # === MultimediaParadise.ffmpeg_start_screencast
   #
@@ -478,139 +539,85 @@ module MultimediaParadise
   end
 
   # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_slow_down_this_video_file
+  # === MultimediaParadise.ffmpeg_vertical_flip
   #
-  # This method can be used to slow down a video file.
+  # This method will make use of the video-filter called "vflip". A
+  # vertical flip will flip the video from head-to-bottom, so people
+  # will suddenly appear as if they are hanging from the ceiling. :)
   #
-  # FFmpeg will be doing this slow down action.
+  # Invocation example:
+  #
+  #   MultimediaParadise.ffmpeg_vertical_flip '/Depot/Video/Reallife/O.J.Simpson_TV_News_etwa_1995.avi'
   #
-  # This uses the "setpts" video filter of ffmpeg, for the video stream
-  # at hand. The video stream can be changed without tampering with
-  # the audio stream. This is also the default modus operandi for this
-  # method here.
   # ========================================================================= #
-  def self.ffmpeg_slow_down_this_video_file(
-      this_video_file  = ARGV,
-      pts_value_to_use = 2.0
-    )
+  def self.ffmpeg_vertical_flip(this_video_file)
     if this_video_file.is_a? Array
-      this_video_file.each {|entry|
-        ffmpeg_slow_down_this_video_file(entry, pts_value_to_use)
-      }
+      this_video_file.each {|entry| ffmpeg_vertical_flip(entry) }
     else
-      # ===================================================================== #
-      # To slow down a video, a  multiplier greater than 1 has to be used: 
-      # ===================================================================== #
-      _ = "ffmpeg -i #{this_video_file} -filter:v \"setpts=#{pts_value_to_use}*PTS\" "\
-          "OUTPUT_SLOWED_DOWN_VIDEO_#{this_video_file}"
+      extname = File.extname(this_video_file)
+      base_dir = File.dirname(this_video_file)
+      filename = File.basename(this_video_file)
+      output_name = base_dir+'/vertical_flip_'+filename.sub(/#{extname}/,'')+extname
+      _ = 'ffmpeg -i '+this_video_file+' -vf "vflip" '+output_name
       esystem _
+      output_name # <- Also return the output name here.
     end
-  end
+  end; self.instance_eval { alias ffmpeg_flip_upside_down ffmpeg_vertical_flip } # === MultimediaParadise.flip_upside_down
 
   # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_flip_video_to_the_right
+  # === MultimediaParadise.ffmpeg_horizontal_flip
   #
-  # This toplevel-method can be used to flip a video to the right,
-  # that is, to rotate it by +90 degrees.
+  # This method will make use of the video-filter called "hflip".
   # ========================================================================= #
-  def self.ffmpeg_flip_video_to_the_right(i)
-    _ = "ffmpeg -i #{i} -vf transpose=1 flipped_to_the_right_#{i}"
-    esystem _
+  def self.ffmpeg_horizontal_flip(this_video_file)
+    if this_video_file.is_a? Array
+      this_video_file.each {|entry| horizontal_flip(entry) }
+    else
+      extname = File.extname(this_video_file)
+      output_name = 'horizontal_flip_'+this_video_file.sub(/#{extname}/,'')+extname
+      _ = 'ffmpeg -i '+this_video_file+' -vf "hflip" '+output_name
+      esystem _
+      output_name # <- Also return the output filename here.
+    end
   end
 
   # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_flip_video_to_the_left
+  # === MultimediaParadise.ffmpeg_rotate_this_video_file_by_90_degrees
   #
-  # This toplevel-method can be used to flip a video to the left,
-  # that is, to rotate it by -90 degrees.
+  # This method can be used to rotate a video file by 90°. Sometimes
+  # smartphones create tilted videos, so this method can correct
+  # this distortion.
   #
-  # Strangely enough the number 2 denotes left-hand flipping (or,
-  # to remain in ffmpeg-parlance, this means "90°CounterClockwise"
-  # rotation).
-  # ========================================================================= #
-  def self.ffmpeg_flip_video_to_the_left(i)
-    _ = "ffmpeg -i #{i} -vf transpose=2 flipped_to_the_left_#{i}"
-    esystem _
-  end
-
-  # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_extract_audio
+  # This can be fixed by using FFMPEG's transpose filter. The
+  # transpose value will work in multiples of 90, so "1"
+  # means 90°.
   #
-  # This method will specifically use ffmpeg in order to extract the
-  # audio from a video or audio file.
-  # ========================================================================= # 
-  def self.ffmpeg_extract_audio(
-      i = input.mkv, # The input filename.
-      o = :ogg       # The output filename.
+  # Invocation example:
+  #
+  #   MultimediaParadise.ffmpeg_rotate_this_video_file_by_90_degrees('foo.mpg')
+  #
+  # ========================================================================= #
+  def self.ffmpeg_rotate_this_video_file_by_90_degrees(
+      this_video_file
     )
-    extname = File.extname(i)
-    case o
-    when :ogg
-      use_this_name = i.
-                      sub(/#{extname}$/,'')
-      o = use_this_name+'.ogg'
-    end
-    esystem 'ffmpeg -i '+i+' -vn '+o
+    output_file = 'output_'+this_video_file+'.mp4' 
+    _ = 'ffmpeg -i '+this_video_file+' -vf transpose=1 '+output_file
+    esystem _
+    output_file # <- And return the output file too.
   end
 
   # ========================================================================= #
-  # === MultimediaParadise.ffmpeg_convert_this_multimedia_file
-  #
-  # This method can be used to convert a file from A to B, through
-  # ffmpeg.
-  #
-  # Remember that the command ffmpeg -codecs will print every codec
-  # FFmpeg knows about.
+  # === MultimediaParadise.ffmpeg_increase_volume_of_this_audio_file
   # ========================================================================= #
-  def self.ffmpeg_convert_this_multimedia_file(
-      input_file  = 'input.mp3',
-      output_file = :mkv #'output.ogg'
+  def self.ffmpeg_increase_volume_of_this_audio_file(
+      input_file,
+      modify_volume_by_this_value = '5.0' # or 3.0 or 4.0 and so forth.
     )
-    yielded = nil
-    if block_given?
-      yielded = yield
-    end
-    if File.exist? input_file
-      case output_file
-      when :mkv
-        extname = File.extname(input_file)
-        use_this_name = input_file.
-                        sub(/#{extname}$/,'')
-        output_file = use_this_name+'.mkv'
-      end
-      _ = "ffmpeg -i #{input_file}"
-      case yielded
-      # ===================================================================== #
-      # === :copy_audio
-      # ===================================================================== #
-      when :copy_audio
-        _ << ' -c:a copy' 
-      # ===================================================================== #
-      # === :libvorbis_audiostream
-      # ===================================================================== #
-      when :libvorbis_audiostream
-        _ << ' -c:a libvorbis'
-      # ===================================================================== #
-      # === :vp9_codec
-      # ===================================================================== #
-      when :vp9_codec
-        _ << ' -c:v vp9' 
-      else
-        if yielded.is_a? Hash
-          # ================================================================= #
-          # === :framerate
-          # ================================================================= #
-          if yielded.has_key? :framerate
-            _ << " -r #{yielded.delete(:framerate)}"
-          end
-        end
-      end
-      _ << " #{output_file}"
-      e _
-      system _
-    else
-      e 'No file exists at '+input_file+'.'
-    end
+    [input_file].flatten.compact.each {|this_file|
+      _ = 'ffmpeg -i '+this_file+' -vcodec copy -af "volume='+modify_volume_by_this_value.to_s+
+         '" output_'+this_file
+      esystem _
+    }
   end
 
 end

data/lib/multimedia_paradise/toplevel_methods/{files_and_directories.rb → files_related_code.rb}

@@ -2,69 +2,30 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# Code in this file will deal with files and directories in general, including
-# cd-related actions, removal of files, creation of files and so forth.
-# =========================================================================== #
-# require 'multimedia_paradise/toplevel_methods/files_and_directories.rb'
-# MultimediaParadise.chdir
+# require 'multimedia_paradise/toplevel_methods/files_related_code.rb'
 # =========================================================================== #
 module MultimediaParadise
 
   require 'fileutils'
   require 'multimedia_paradise/toplevel_methods/e.rb'
+  require 'multimedia_paradise/toplevel_methods/is_on_roebe.rb'
   require 'multimedia_paradise/colours/colours.rb'
 
   # ========================================================================= #
-  # === MultimediaParadise.move_file
-  #
-  # This method can be used to move a file - in other words, to rename it.
+  # === MultimediaParadise.copy_file
   # ========================================================================= #
-  def self.move_file(old, new)
-    FileUtils.mv(old, new)
-  end; self.instance_eval { alias mv          move_file } # === MultimediaParadise.mv
-       self.instance_eval { alias rename_file move_file } # === MultimediaParadise.rename_file
-
-  # ========================================================================= #
-  # === MultimediaParadise.remove_file
-  #
-  # Remove a given file, without any further checks.
-  # ========================================================================= #
-  def self.remove_file(i)
-    File.delete(i) if File.exist?(i)
-  end; self.instance_eval { alias delete_file remove_file } # === MultimediaParadise.delete_file
-
-  # ========================================================================= #
-  # === remove_file
-  # ========================================================================= #
-  def remove_file(i)
-    MultimediaParadise.remove_file(i)
-  end
-
-  # ========================================================================= #
-  # === 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
-
-  # ========================================================================= #
-  # === mkdir
-  # ========================================================================= #
-  def mkdir(i)
-    MultimediaParadise.mkdir(i)
+  def self.copy_file(from, to)
+    FileUtils.cp(from, to)
   end
 
   # ========================================================================= #
   # === MultimediaParadise.rename
   #
-  # This perform a rename-action, using mv.
+  # This method will perform a rename-action, using mv.
   # ========================================================================= #
   def self.rename(from, to)
     if File.exist? from
-      e rev+'Now renaming `'+sfile(from.to_s)+rev+'` to `'+sfile(to.to_s)+rev+'`.'
+      e "#{rev}Now renaming `"+sfile(from.to_s)+rev+'` to `'+sfile(to.to_s)+rev+'`.'
       FileUtils.mv(from, to)
     else
       e "#{rev}Can not rename `#{sfancy(from)}` as it does not exist."
@@ -73,20 +34,22 @@ module MultimediaParadise
        self.instance_eval { alias rename_file rename } # === MultimediaParadise.rename_file
 
   # ========================================================================= #
-  # === chdir                                                        (cd tag)
+  # === MultimediaParadise.move_file
+  #
+  # This method can be used to move a file - in other words, to rename it.
   # ========================================================================= #
-  def chdir(i)
-    MultimediaParadise.chdir(i)
-  end; alias cd chdir # === cd
+  def self.move_file(old, new)
+    FileUtils.mv(old, new)
+  end; self.instance_eval { alias mv          move_file } # === MultimediaParadise.mv
+       self.instance_eval { alias rename_file move_file } # === MultimediaParadise.rename_file
 
   # ========================================================================= #
-  # === MultimediaParadise.chdir
+  # === MultimediaParadise.remove_file
   #
-  # Use this method if you wish to change directory to another target
-  # directory.
+  # Remove a given file, without any further checks.
   # ========================================================================= #
-  def self.chdir(i)
-    Dir.chdir(i) if File.directory? i
-  end; self.instance_eval { alias cd chdir } # === MultimediaParadise.cd
+  def self.remove_file(i)
+    File.delete(i) if File.exist?(i)
+  end; self.instance_eval { alias delete_file remove_file } # === MultimediaParadise.delete_file
 
 end