multimedia_paradise 1.1.344 → 1.2.2

data/lib/multimedia_paradise/base/base.rb

@@ -7,26 +7,865 @@
 # All .rb files that are part of the MultimediaParadise project can
 # subclass from this file here. This is the preferred way, too.
 # =========================================================================== #
-# require 'multimedia_paradise/base/base.rb'; class Foo < ::MultimediaParadise::Base
+# require 'multimedia_paradise/base/base.rb'
+# class Foo < ::MultimediaParadise::Base
 # =========================================================================== #
-require 'multimedia_paradise/toplevel_methods/misc.rb'
-require 'multimedia_paradise/base/constants.rb'
-require 'multimedia_paradise/base/colours.rb'
-require 'multimedia_paradise/base/encoding.rb'
-require 'multimedia_paradise/base/misc.rb'
-require 'multimedia_paradise/base/namespace.rb'
-require 'multimedia_paradise/toplevel_methods/e.rb'
-require 'multimedia_paradise/toplevel_methods/files_and_directories.rb'
-require 'multimedia_paradise/toplevel_methods/is_audio_file.rb'
-require 'multimedia_paradise/toplevel_methods/is_video_file.rb'
-require 'multimedia_paradise/toplevel_methods/output_directory.rb'
-require 'multimedia_paradise/toplevel_methods/return_all_video_files.rb'
-require 'multimedia_paradise/toplevel_methods/player_in_use.rb'
-
 module MultimediaParadise
 
 class Base # === MultimediaParadise::Base
 
+  require 'fileutils'
+  require 'multimedia_paradise/constants/constants.rb'
+  require 'multimedia_paradise/base/colours.rb'
+  require 'multimedia_paradise/toplevel_methods/directory_related_code.rb'
+  require 'multimedia_paradise/toplevel_methods/files_related_code.rb'
+  require 'multimedia_paradise/toplevel_methods/is_on_roebe.rb'
+  require 'multimedia_paradise/toplevel_methods/is_audio_file_is_video_file_is_image_file_is_multimedia_file.rb'
+  require 'multimedia_paradise/toplevel_methods/opn.rb'
+  require 'multimedia_paradise/toplevel_methods/player_in_use.rb'
+  require 'multimedia_paradise/toplevel_methods/rds.rb'
+  require 'multimedia_paradise/toplevel_methods/return_random_video_file_from_the_video_collection.rb'
+  require 'multimedia_paradise/toplevel_methods/return_screen_resolution.rb'
+  require 'multimedia_paradise/toplevel_methods/toplevel_methods.rb'
+
+  # ========================================================================= #
+  # Add support for commandline-arguments next:
+  # ========================================================================= #
+  require 'multimedia_paradise/base/commandline_arguments_module/commandline_arguments_module.rb'
+  include MultimediaParadise::CommandlineArgumentsModule
+
+  begin
+    require 'save_file'
+  rescue LoadError; end
+
+  begin
+    require 'cliner'
+  rescue LoadError; end
+
+  begin
+    require 'roebe/classes/twentyfour_hours_notation.rb'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === ERROR_LINE
+  # ========================================================================= #
+  ERROR_LINE = '2>&1'
+    ERROR = ERROR_LINE # === ERROR
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    reset
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  #
+  # Since as of March 2024 this method depends on @internal_hash being
+  # defined.
+  # ========================================================================= #
+  def reset
+    unless defined? @internal_hash
+      reset_the_internal_hash # Make @internal_hash known here.
+    end
+    # ======================================================================= #
+    # === :be_verbose
+    # ======================================================================= #
+    set_be_verbose
+    # ======================================================================= #
+    # === :use_colours
+    # ======================================================================= #
+    @internal_hash[:use_colours] = true
+    # ======================================================================= #
+    # === :debug
+    #
+    # By default, debugging is disabled.
+    # ======================================================================= #
+    @internal_hash[:debug] = false
+    # ======================================================================= #
+    # === :use_opn
+    # ======================================================================= #
+    @internal_hash[:use_opn] = true  
+  end
+
+  # ========================================================================= #
+  # === use_opn?
+  # ========================================================================= #
+  def use_opn?
+    @internal_hash[:use_opn]
+  end
+
+  # ========================================================================= #
+  # === do_not_use_opn
+  # ========================================================================= #
+  def do_not_use_opn
+    @internal_hash[:use_opn] = false
+  end
+
+  # ========================================================================= #
+  # === infer_the_namespace
+  #
+  # This will assume the true namespace from the inspectable name.
+  # ========================================================================= #
+  def infer_the_namespace
+    _ = inspect
+    if _.include?(':0x')
+      _ = _.split(':0x').first.to_s.strip
+    end
+    _ = _.to_s.delete('<')
+    if _.include? ' '
+      _ = _.split(' ').first.delete('#')
+      if _.include? ':'
+        _ = _.split(':')[0 .. -2].reject {|entry| entry.empty? }.join('::')
+      end
+    end
+    @namespace = _.delete('#') # And assign it here.
+  end
+
+  # ========================================================================= #
+  # === verbose_truth
+  # ========================================================================= #
+  def verbose_truth(i)
+    case i.to_s
+    when 't','true'
+      true
+    when 'f','false',''
+      false
+    end
+  end
+
+  # ========================================================================= #
+  # === select_only_video_files_from
+  # ========================================================================= #
+  def select_only_video_files_from(array)
+    array.select {|entry| is_video_file?(entry) }
+  end
+
+  # ========================================================================= #
+  # === does_the_video_player_support_this_commandline?
+  #
+  # The following method checks whether the chosen video player at hand
+  # supports a particular commandline. The check is necessary because
+  # on some systems 'mpv' may be an alias to 'mplayer.
+  # ========================================================================= #
+  def does_the_video_player_support_this_commandline?(
+      this_commandline = '--msg-color'
+    )
+    cmd = "#{use_which_video_player?} #{this_commandline.strip} 2>&1"
+    result = `#{cmd}`
+    !result.include?('Unknown option on the command line: ')
+  end
+
+  # ========================================================================= #
+  # === namespace?
+  # ========================================================================= #
+  def namespace?
+    @namespace
+  end
+
+  # ========================================================================= #
+  # === opnn
+  # ========================================================================= #
+  def opnn(
+      namespace = { namespace: @namespace },
+      &block
+    )
+    if use_opn?
+      # ===================================================================== #
+      # Turn a String into a Hash next.
+      # ===================================================================== #
+      if namespace.is_a? String
+        namespace = { namespace: namespace } # Use the input to the method in this case.
+      end
+      Opn.opn(namespace, &block)
+    end
+  end
+
+  # ========================================================================= #
+  # === is_video_file?
+  # ========================================================================= #
+  def is_video_file?(i)
+    MultimediaParadise.is_video_file?(i) # Delegate to the module-method here.
+  end; alias is_this_a_video_file? is_video_file? # === is_this_a_video_file?
+       alias is_a_video_file?      is_video_file? # === is_a_video_file?
+
+  # ========================================================================= #
+  # === dd_mm_yyyy
+  #
+  # Get the time in dd.mm.yyyy format. We have to use '_' underscores for
+  # the method name, as ruby does not allow '.' to be part of a method
+  # name itself, as this is the dot-operator for method calls.
+  # ========================================================================= #
+  def dd_mm_yyyy
+    return ::Time.now.strftime('%d.%m.%Y')
+  end; alias dd_mm_yyyy? dd_mm_yyyy # === dd_mm_yyyy?
+
+  # ========================================================================= #
+  # === hh_mm_ss
+  # ========================================================================= #
+  def hh_mm_ss
+    return ::Time.now.strftime('%H:%M:%S')
+  end; alias hh_mm_ss? hh_mm_ss # === hh_mm_ss?
+
+  # ========================================================================= #
+  # === ensure_main_encoding
+  #
+  # This method can ensure that a String has the proper encoding that
+  # we will use for the MultimediaParadise project.
+  # ========================================================================= #
+  def ensure_main_encoding(
+      i, use_this_encoding = USE_THIS_ENCODING
+    )
+    if i.is_a? String
+      unless i.encoding.to_s.include? use_this_encoding
+        i = i.dup if i.frozen?
+        i = i.force_encoding(use_this_encoding)
+      end
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === map_symbol_to_locally_existing_file
+  #
+  # This entry point is a shortcut to local videos.
+  #
+  # The method will ensure that it will work on a Symbol, as given input.
+  # This will work on the downcased variant, so :Beauty or 'Beauty' would
+  # become :beauty.
+  # ========================================================================= #
+  def map_symbol_to_locally_existing_file(i)
+    case i.to_s.downcase.to_sym # case tag
+    # ======================================================================= #
+    # === wrap :beauty
+    # ======================================================================= #
+    when :beauty,
+         :american_beauty
+      i = "#{realvids_directory?}017_American_Beauty.mp4"
+    # ======================================================================= #
+    # === wrap :halloween
+    # ======================================================================= #
+    when :halloween
+      i = "#{realvids_directory?}215_Halloween.mp4"
+    # ======================================================================= #
+    # === wrap :predator
+    # ======================================================================= #
+    when :predator
+      i = "#{realvids_directory?}245_Predator.avi"
+    # ======================================================================= #
+    # === wrap :lolita
+    # ======================================================================= #
+    when :lolita
+      i = "#{realvids_directory?}233_Lolita.mkv"
+    else
+      e "#{rev}Unhandled symbol: #{i.to_s}"
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === is_multimedia_file?
+  #
+  # This method will return true if the given directory is either an
+  # audio file or a video file.
+  # ========================================================================= #
+  def is_multimedia_file?(i)
+    is_audio_file?(i) or is_video_file?(i)
+  end; alias is_a_multimedia_file?      is_multimedia_file? # === is_a_multimedia_file?
+       alias is_this_a_multimedia_file? is_multimedia_file? # === is_this_a_multimedia_file?
+
+  # ========================================================================= #
+  # === beautiful_url
+  #
+  # Wrapper-method over the beautiful_url gem.
+  # ========================================================================= #
+  def beautiful_url(i)
+    unless Object.const_defined? :BeautifulUrl
+      begin
+        require 'beautiful_url'
+      rescue LoadError; end
+    end
+    i = ::BeautifulUrl.new(i) if Object.const_defined? :BeautifulUrl
+    i = i.first if i.is_a? Array
+    return i
+  end
+
+  # ========================================================================= #
+  # === register_sigint
+  #
+  # If an argument is passed to this method then it will be displayed.
+  # ========================================================================= #
+  def register_sigint(
+      use_this_as_exit_message = 'Exiting now as requested.',
+      &block
+    )
+    clear_kde_konsole_tab_on_exit = false
+    # ======================================================================= #
+    # === Handle blocks given to this method next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :clear_kde_konsole_tab_on_exit_if_is_on_roebe
+      # ===================================================================== #
+      when :clear_kde_konsole_tab_on_exit_if_is_on_roebe,
+           :pretty
+        if is_on_roebe?
+          clear_kde_konsole_tab_on_exit = true
+        end
+      end
+    end
+    Signal.trap('SIGINT') {
+      e use_this_as_exit_message if use_this_as_exit_message
+      if clear_kde_konsole_tab_on_exit
+        begin
+          require 'roebe/classes/kde/kde_konsole/kde_konsole.rb'
+          e Roebe.konsole_tab_title('.') # Rename the tab again.
+        rescue LoadError; end
+      end
+      exit
+    }
+  end
+
+  # ========================================================================= #
+  # === time_right_now
+  #
+  # This method will return a String such as:
+  #
+  #   "11:14:27-04.03.2024"
+  #
+  # ========================================================================= #
+  def time_right_now
+    Time.now.strftime('%H:%M:%S-%d.%m.%Y')
+  end
+
+  # ========================================================================= #
+  # === is_on_roebe?
+  #
+  # Determine whether we are on a roebe-system or whether we are not.
+  # ========================================================================= #
+  def is_on_roebe?
+    MultimediaParadise.is_on_roebe?
+  end
+
+  # ========================================================================= #
+  # === internal_hash?
+  # ========================================================================= #
+  def internal_hash?
+    @internal_hash
+  end
+
+  # ========================================================================= #
+  # === reset_the_internal_hash
+  #
+  # The method name is a misnomer, but nonetheless it is retained, since I
+  # like to use such an API.
+  # ========================================================================= #
+  def reset_the_internal_hash
+    @internal_hash = {}
+  end
+
+  # ========================================================================= #
+  # === use_which_video_player?
+  # ========================================================================= #
+  def use_which_video_player?
+    MultimediaParadise.use_which_video_player?
+  end; alias video_player_in_use?         use_which_video_player? # === video_player_in_use?
+       alias use_which_multimedia_player? use_which_video_player? # === use_which_multimedia_player?
+       alias use_which_audio_player?      use_which_video_player? # === use_which_audio_player?
+       alias use_which_player?            use_which_video_player? # === use_which_player?
+
+  # ========================================================================= #
+  # === cd                                                           (cd tag)
+  # ========================================================================= #
+  def cd(i)
+    MultimediaParadise.chdir(i)
+  end; alias chdir cd # === chdir
+
+  # ========================================================================= #
+  # === return_pwd
+  #
+  # This method will always return a String with a trailing '/' character.
+  # ========================================================================= #
+  def return_pwd
+    ("#{Dir.pwd}/").squeeze('/')
+  end
+
+  # ========================================================================= #
+  # === dataset_from_file_video_collection
+  # ========================================================================= #
+  def dataset_from_file_video_collection(
+      i = MultimediaParadise.file_video_collection
+    )
+    YAML.load_file(i)
+  end
+
+  # ========================================================================= #
+  # === return_all_video_files
+  #
+  # This method will return a Hash, containing all local video files.
+  #
+  # The entries that can be found in that Hash may look like this:
+  #
+  #   228=> {"title"=>"Apocalypto"
+  #
+  # ========================================================================= #
+  def return_all_video_files
+    MultimediaParadise.return_all_video_files
+  end
+
+  # ========================================================================= #
+  # === return_random_video
+  # ========================================================================= #
+  def return_random_video
+    MultimediaParadise.return_random_video
+  end
+
+  # ========================================================================= #
+  # === local_audio_directory?
+  # ========================================================================= #
+  def local_audio_directory?
+    MultimediaParadise.local_audio_directory?
+  end; alias directory_containing_the_local_songs? local_audio_directory? # === directory_containing_the_local_songs?
+
+  # ========================================================================= #
+  # === file_video_collection?
+  # ========================================================================= #
+  def file_video_collection?
+    MultimediaParadise.file_video_collection?
+  end
+
+  # ========================================================================= #
+  # === cartoons_directory?
+  # ========================================================================= #
+  def cartoons_directory?
+    MultimediaParadise.cartoons_directory?
+  end; alias cartoon_directory? cartoons_directory? # === cartoon_directory
+
+  # ========================================================================= #
+  # === remove_file                                              (remove tag)
+  #
+  # Use this method if you need to delete/remove a file.
+  # ========================================================================= #
+  def remove_file(i)
+    MultimediaParadise.remove_file(i)
+  end; alias remove           remove_file # === remove_file
+       alias delete           remove_file # === delete
+       alias remove_this_file remove_file # === remove_this_file
+
+  # ========================================================================= #
+  # === is_audio_file?
+  #
+  # This method can be used in order to determine whether we are working
+  # with an audio file here or whether we are not.
+  # ========================================================================= #
+  def is_audio_file?(i)
+    MultimediaParadise.is_audio_file?(i)
+  end; alias is_audio_song?    is_audio_file? # === is_audio_song?
+       alias is_an_audio_file? is_audio_file? # === is_audio_file?
+
+  # ========================================================================= #
+  # === directory_to_realvids?
+  #
+  # This method will return the absolute path to my local realvid
+  # directory.
+  #
+  # It is only used in code of classes that deal with my local multimedia
+  # files really.
+  # ========================================================================= #
+  def directory_to_realvids?
+    MultimediaParadise.realvids_directory?
+  end; alias realvids_directory? directory_to_realvids? # === realvids_directory?
+
+  # ========================================================================= #
+  # === no_file_exists_at
+  #
+  # This method can be consistently used to notify the user that a
+  # specific file is missing.
+  # ========================================================================= #
+  def no_file_exists_at(this_file)
+    e "#{rev}No file exists at `#{sfile(this_file)}#{rev}`."
+  end
+
+  # ========================================================================= #
+  # === no_file_exists
+  # ========================================================================= #
+  def no_file_exists
+    e "#{rev}No file exists - may be a nil value."
+  end
+
+  # ========================================================================= #
+  # === debug?
+  # ========================================================================= #
+  def debug?
+    @internal_hash[:debug]
+  end
+
+  # ========================================================================= #
+  # === enable_debug
+  # ========================================================================= #
+  def enable_debug
+    @internal_hash[:debug] = true
+  end
+
+  # ========================================================================= #
+  # === chdir                                                        (cd tag)
+  # ========================================================================= #
+  def chdir(i)
+    MultimediaParadise.chdir(i)
+  end; alias cd chdir # === cd
+
+  # ========================================================================= #
+  # === mkdir                                                     (mkdir tag)
+  # ========================================================================= #
+  def mkdir(i)
+    MultimediaParadise.mkdir(i)
+  end
+
+  # ========================================================================= #
+  # === esystem
+  #
+  # The second argument should be a Symbol such as :steelblue.
+  # ========================================================================= #
+  def esystem(
+      i,
+      optional_colour_to_use                  = nil,
+      use_a_newline_before_the_system_command = false
+    )
+    MultimediaParadise.esystem(
+      i,
+      optional_colour_to_use,
+      use_a_newline_before_the_system_command
+    )
+  end
+
+  # ========================================================================= #
+  # === load_yaml
+  # ========================================================================= #
+  def load_yaml(i)
+    MultimediaParadise.load_yaml(i)
+  end
+
+  # ========================================================================= #
+  # === project_base_directory?
+  # ========================================================================= #
+  def project_base_directory?
+    MultimediaParadise.project_base_directory?
+  end
+
+  # ========================================================================= #
+  # === yaml_directory?
+  # ========================================================================= #
+  def yaml_directory?
+    "#{project_base_directory?}yaml/"
+  end
+
+  # ========================================================================= #
+  # === cliner_with_time_stamp
+  # ========================================================================= #
+  def cliner_with_time_stamp
+    _ = Cliner.cliner :return_time
+    if use_colours?
+      _.sub!(/(\d{2}:\d{2}:\d{2})/, slateblue("\\1"))
+    end
+    e _
+  end
+
+  # ========================================================================= #
+  # === e
+  # ========================================================================= #
+  def e(i = '')
+    MultimediaParadise.e(i)
+  end
+
+  # ========================================================================= #
+  # === efancy
+  # ========================================================================= #
+  def efancy(i)
+    e sfancy(i)
+  end
+
+  # ========================================================================= #
+  # === rds
+  # ========================================================================= #
+  def rds(i)
+    MultimediaParadise.rds(i)
+  end
+
+  # ========================================================================= #
+  # === is_mp3?
+  # ========================================================================= #
+  def is_mp3?(i)
+    File.extname(i).downcase == '.mp3'
+  end
+
+  # ========================================================================= #
+  # === is_mp4?
+  # ========================================================================= #
+  def is_mp4?(i)
+    File.extname(i).downcase == '.mp4'
+  end
+
+  # ========================================================================= #
+  # === is_mkv?
+  # ========================================================================= #
+  def is_mkv?(i)
+    File.extname(i).downcase == '.mkv'
+  end
+
+  # ========================================================================= #
+  # === filter_for_video_files
+  # ========================================================================= #
+  def filter_for_video_files(i)
+    MultimediaParadise.filter_for_video_files(i)
+  end
+
+  # ========================================================================= #
+  # === move_file                              (mv tag, move tag, rename tag)
+  # ========================================================================= #
+  def move_file(old, new)
+    if File.exist? old
+      MultimediaParadise.mv(old, new) # Delegate towards FileUtils in this cae.
+    else
+      e "#{rev}Can not move `#{sfile(old)}#{rev}` as no such file exists."
+    end
+  end; alias mv          move_file # === mv
+       alias rename_file move_file # === rename_file
+
+  require 'multimedia_paradise/actions/actions.rb'
+  # ========================================================================= #
+  # === actions
+  # ========================================================================= #
+  def actions(
+      this_action,
+      optional_arguments = nil,
+      &block
+    )
+    MultimediaParadise.action(
+      this_action,
+      optional_arguments,
+      &block
+    )
+  end; alias action actions # === action
+
+  # ========================================================================= #
+  # === cliner                                                   (cliner tag)
+  # ========================================================================= #
+  def cliner(
+      i = nil,
+      &block
+    )
+    "#{rev}#{Cliner.cliner(i, &block)}#{rev}"
+  end
+
+  # ========================================================================= #
+  # === ucliner
+  # ========================================================================= #
+  def ucliner(
+      n_times         = 80,
+      gold_embed_this = nil
+    )
+    case n_times
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      n_times = 80
+    end
+    if gold_embed_this
+      n_times -= (gold_embed_this.to_s.size + 1)
+    end
+    result = lightgreen('―' * n_times)
+    if gold_embed_this
+      result = result.dup
+      result << " #{gold(gold_embed_this)}#{rev}"
+    end
+    e result
+  end
+
+  # ========================================================================= #
+  # === default_readlines
+  # ========================================================================= #
+  def default_readlines(
+      this_file
+    )
+    File.readlines(this_file, encoding: 'utf-8')
+  end
+
+  # ========================================================================= #
+  # === seconds_to_time_format
+  # ========================================================================= #
+  def seconds_to_time_format(i)
+    if Object.const_defined? :Roebe
+      return Roebe::TwentyfourHoursNotation[i] # => "00:05:00.000"
+    else # else return the given input in an unformatted manner.
+      return i
+    end
+  end; alias to_twentyfour_notation seconds_to_time_format # === to_twentyfour_notation
+
+  # ========================================================================= #
+  # === opne
+  # ========================================================================= #
+  def opne(i = '')
+    opnn; e i
+  end
+
+  # ========================================================================= #
+  # === opnecomment
+  # ========================================================================= #
+  def opnecomment(i = '')
+    opnn; ecomment i
+  end
+
+  # ========================================================================= #
+  # === be_verbose?
+  # ========================================================================= #
+  def be_verbose?
+    @internal_hash[:be_verbose]
+  end; alias verbose? be_verbose? # === verbose?
+
+  # ========================================================================= #
+  # === be_silent
+  # ========================================================================= #
+  def be_silent
+    @internal_hash[:be_verbose] = false
+  end; alias be_quiet      be_silent # == be_quiet
+       alias set_be_quiet  be_silent # === set_be_quiet
+       alias set_be_silent be_silent # === set_be_silent
+
+  # ========================================================================= #
+  # === set_be_verbose
+  # ========================================================================= #
+  def set_be_verbose
+    @internal_hash[:be_verbose] = true
+  end
+
+  # ========================================================================= #
+  # === save_what_into
+  #
+  # A simple wrapper over SaveFile.
+  # ========================================================================= #
+  def save_what_into(what, into)
+    if Object.const_defined? :SaveFile
+      SaveFile.write_what_into(what, into)
+    end
+  end; alias save_file       save_what_into # === save_file
+       alias write_what_into save_what_into # === write_what_into
+
+  # ========================================================================= #
+  # === append_what_into
+  # ========================================================================= #
+  def append_what_into(what, into)
+    if Object.const_defined? :SaveFile
+      SaveFile.append_what_into(what, into)
+    end
+  end
+
+  # ========================================================================= #
+  # === copy_file
+  # ========================================================================= #
+  def copy_file(from, to = return_pwd)
+    FileUtils.cp(from, to)
+  end
+
+  # ========================================================================= #
+  # === report_pwd
+  # ========================================================================= #
+  def report_pwd
+    e rds("#{Dir.pwd}/")
+  end
+
+  # ========================================================================= #
+  # === try_to_rename_kde_konsole_tab
+  # ========================================================================= #
+  def try_to_rename_kde_konsole_tab(
+      new_title                         = '_',
+      try_to_rename_the_kde_konsole_tab = TRY_TO_RENAME_THE_KDE_KONSOLE_TAB
+    )
+    MultimediaParadise.try_to_rename_kde_konsole_tab(
+      new_title, try_to_rename_the_kde_konsole_tab
+    )
+  end; alias rename_kde_konsole try_to_rename_kde_konsole_tab # === rename_kde_konsole
+       alias do_rename_konsole  try_to_rename_kde_konsole_tab # === do_rename_konsole
+
+  # ========================================================================= #
+  # === log_dir?
+  # ========================================================================= #
+  def log_dir?
+    MultimediaParadise.log_dir?
+  end; alias log_directory? log_dir? # === log_directory?
+
+  # ========================================================================= #
+  # === ensure_that_the_output_directory_exists
+  # ========================================================================= #
+  def ensure_that_the_output_directory_exists(
+      this_directory = log_directory?
+    )
+    this_directory = File.dirname(this_directory) unless this_directory.end_with? '/'
+    MultimediaParadise.ensure_that_the_output_directory_exists
+  end
+
+  require 'multimedia_paradise/time/milliseconds_to_long_format_converter.rb'
+  # ========================================================================= #
+  # === to_hh_mm_ss
+  # ========================================================================= #
+  def to_hh_mm_ss(i)
+    MultimediaParadise.milliseconds_to_long_format(i * 1000)
+  end
+
+  # ========================================================================= #
+  # === home_x_video?
+  # ========================================================================= #
+  def home_x_video?
+    MultimediaParadise.home_x_video?
+  end
+
+  # ========================================================================= #
+  # === filter_for_audio_files
+  #
+  # We will filter for audio files - so we will keep only files that
+  # are audio files.
+  # ========================================================================= #
+  def filter_for_audio_files(i)
+    i.select {|file| is_audio_file?(file) }
+  end
+
+  # ========================================================================= #
+  # === video_collection?
+  # ========================================================================= #
+  def video_collection?
+    MultimediaParadise.file_video_collection
+  end
+
+  # ========================================================================= #
+  # === clear_the_internal_hash
+  # ========================================================================= #
+  def clear_the_internal_hash
+    @internal_hash.clear
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  #
+  # Stub-method.
+  # ========================================================================= #
+  def run
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise::Base[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+
 end; end
 
 if __FILE__ == $PROGRAM_NAME