royw-dvdprofiler2xbmc 0.0.6 → 0.0.8

data/Rakefile

@@ -14,7 +14,8 @@ $hoe = Hoe.new('dvdprofiler2xbmc', Dvdprofiler2xbmc::VERSION) do |p|
     ['royw-imdb','>= 0.0.16'],
     ['log4r','>= 1.0.5'],
     ['commandline','>= 0.7.10'],
-    ['mash','>= 0.0.3']
+    ['mash','>= 0.0.3'],
+    ['highline', '>= 1.5.0']
   ]
   p.extra_dev_deps = [
     ['newgem', ">= #{::Newgem::VERSION}"]

data/dvdprofiler2xbmc.gemspec

@@ -2,17 +2,17 @@
 
 Gem::Specification.new do |s|
   s.name = %q{dvdprofiler2xbmc}
-  s.version = "0.0.6"
+  s.version = "0.0.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Roy Wright"]
-  s.date = %q{2009-04-08}
+  s.date = %q{2009-04-14}
   s.default_executable = %q{dvdprofiler2xbmc}
-  s.description = %q{This script will attempt to match up media files from a set of directories to the collection.xml file exported from DVD Profiler.  For matches, the script will then create a {moviename}.nfo from the data in collections.xml and also copy the front cover image to {moviename}.tbn.  Both files will be placed in the same directory as the source media file.  Also the specific profile information for each movie will be saved into {moviename}.dvdprofiler.xml.  The script will then search IMDB for a title or also known as (AKA) match. If necessary, the script will refine the search by using the media year (year in media filename), then dvdprofiler production year, then dvdprofiler release year, then try again with each year plus or minus a year.  The IMDB profile found will be saved as {moviename}.imdb.xml.  Next the script will use the IMDB ID to query themovieDb.com.  This is primarily to retrieve any fanart but will also add any missing parameters to the .nfo file (very unlikely).  The TMDB profile found will be saved as {moviename}.tmdb.xml.  So in summary the files generated are:  {moviename}.tmdb.xml        - profile from themovieDb.com {moviename}.imdb.xml        - profile from imdb.com {moviename}.dvdprofiler.xml - profile from collection.xml {moviename}-fanart.jpg      - first fanart image from themovieDb.com {moviename}.tbn             - image from DVD Profiler {moviename}.nfo             - generated info profile for xbmc  To force regeneration, simply delete these files then run the script again.  Then on XBMC, set the source content to none to remove the meta data from the library, then set the source content back to Movies to import the media. This time, the data in the .nfo files will be used instead of scraping.}
+  s.description = %q{This script will attempt to match up media files from a set of directories to the collection.xml file exported from DVD Profiler.  For matches, the script will then create a {moviename}.nfo from the data in collections.xml and also copy the front cover image to {moviename}.tbn.  Both files will be placed in the same directory as the source media file.  Also the specific profile information for each movie will be saved into {moviename}.dvdprofiler.xml.  The script will then search IMDB for a title or also known as (AKA) match. If necessary, the script will refine the search by using the media year (year in media filename), then dvdprofiler production year, then dvdprofiler release year, then try again with each year plus or minus a year.  The IMDB profile found will be saved as {moviename}.imdb.xml.  Next the script will use the IMDB ID to query themovieDb.com.  This is primarily to retrieve any fanart but will also add any missing parameters to the .nfo file (very unlikely).  The TMDB profile found will be saved as {moviename}.tmdb.xml.  So in summary the files generated are:  {moviename}.tmdb.xml        - profile from themovieDb.com {moviename}.imdb.xml        - profile from imdb.com {moviename}.dvdprofiler.xml - profile from collection.xml {moviename}-fanart.jpg      - first fanart image from themovieDb.com {moviename}.tbn             - image from DVD Profiler {moviename}.nfo             - generated info profile for xbmc  To force regeneration, simply delete these files then run the script again.  Then on XBMC, set the source content to none to remove the meta data from the library, then set the source content back to Movies to import the media. This time, the data in the .nfo files will be used instead of scraping.  Note, XBMC pre-9.04 r19177 does not successfully scan all media.  The work-around is after the scan is complete to restart XBMC so it will scan again (if you have autoscan enabled).}
   s.email = ["roy@wright.org"]
   s.executables = ["dvdprofiler2xbmc"]
   s.extra_rdoc_files = ["History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc"]
-  s.files = [".gitignore", "History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc", "Rakefile", "bin/dvdprofiler2xbmc", "dvdprofiler2xbmc.gemspec", "lib/dvdprofiler2xbmc.rb", "lib/dvdprofiler2xbmc/app_config.rb", "lib/dvdprofiler2xbmc/controllers/app.rb", "lib/dvdprofiler2xbmc/controllers/fanart_controller.rb", "lib/dvdprofiler2xbmc/controllers/nfo_controller.rb", "lib/dvdprofiler2xbmc/controllers/thumbnail_controller.rb", "lib/dvdprofiler2xbmc/extensions.rb", "lib/dvdprofiler2xbmc/models/collection.rb", "lib/dvdprofiler2xbmc/models/dvdprofiler_profile.rb", "lib/dvdprofiler2xbmc/models/imdb_profile.rb", "lib/dvdprofiler2xbmc/models/media.rb", "lib/dvdprofiler2xbmc/models/media_files.rb", "lib/dvdprofiler2xbmc/models/tmdb_movie.rb", "lib/dvdprofiler2xbmc/models/tmdb_profile.rb", "lib/dvdprofiler2xbmc/models/xbmc_info.rb", "lib/dvdprofiler2xbmc/open_cache_extension.rb", "lib/dvdprofiler2xbmc/views/cli.rb", "spec/cache_extensions.rb", "spec/dvdprofiler2xbmc_spec.rb", "spec/dvdprofiler_profile_spec.rb", "spec/imdb_profile_spec.rb", "spec/nfo_controller_spec.rb", "spec/samples/Collection.xml", "spec/samples/Collection.yaml", "spec/samples/Die Hard - 1988.nfo", "spec/samples/The Egg and I.dummy", "spec/spec.opts", "spec/spec_helper.rb", "spec/tmdb_movie_spec.rb", "spec/tmdb_profile_spec.rb", "spec/xbmc_info_spec.rb", "tasks/rspec.rake", "test/test_dvdprofiler2xbmc.rb", "test/test_dvdprofiler2xbmc_cli.rb", "test/test_helper.rb"]
+  s.files = [".gitignore", "History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc", "Rakefile", "bin/dvdprofiler2xbmc", "dvdprofiler2xbmc.gemspec", "lib/dvdprofiler2xbmc.rb", "lib/dvdprofiler2xbmc/app_config.rb", "lib/dvdprofiler2xbmc/controllers/app.rb", "lib/dvdprofiler2xbmc/controllers/fanart_controller.rb", "lib/dvdprofiler2xbmc/controllers/nfo_controller.rb", "lib/dvdprofiler2xbmc/controllers/thumbnail_controller.rb", "lib/dvdprofiler2xbmc/extensions.rb", "lib/dvdprofiler2xbmc/models/collection.rb", "lib/dvdprofiler2xbmc/models/dvdprofiler_profile.rb", "lib/dvdprofiler2xbmc/models/imdb_profile.rb", "lib/dvdprofiler2xbmc/models/media.rb", "lib/dvdprofiler2xbmc/models/media_files.rb", "lib/dvdprofiler2xbmc/models/tmdb_movie.rb", "lib/dvdprofiler2xbmc/models/tmdb_profile.rb", "lib/dvdprofiler2xbmc/models/xbmc_info.rb", "lib/dvdprofiler2xbmc/open_cache_extension.rb", "lib/dvdprofiler2xbmc/views/cli.rb", "lib/dvdprofiler2xbmc/views/config_editor.rb", "spec/app_spec.rb", "spec/cache_extensions.rb", "spec/config_editor_spec.rb", "spec/dvdprofiler2xbmc_spec.rb", "spec/dvdprofiler_profile_spec.rb", "spec/fanart_controller_spec.rb", "spec/imdb_profile_spec.rb", "spec/media_spec.rb", "spec/nfo_controller_spec.rb", "spec/samples/Collection.xml", "spec/samples/Die Hard - 1988.nfo", "spec/samples/Ma and Pa Kettle.cd1.dummy", "spec/samples/The Egg and I.dummy", "spec/spec.opts", "spec/spec_helper.rb", "spec/tmdb_movie_spec.rb", "spec/tmdb_profile_spec.rb", "spec/xbmc_info_spec.rb", "tasks/rspec.rake", "test/test_dvdprofiler2xbmc.rb", "test/test_helper.rb", "test/test_dvdprofiler2xbmc_cli.rb"]
   s.has_rdoc = true
   s.homepage = %q{http://www.github.com/royw/dvdprofiler2xbmc}
   s.post_install_message = %q{PostInstall.txt}
@@ -34,6 +34,7 @@ Gem::Specification.new do |s|
       s.add_runtime_dependency(%q<log4r>, [">= 1.0.5"])
       s.add_runtime_dependency(%q<commandline>, [">= 0.7.10"])
       s.add_runtime_dependency(%q<mash>, [">= 0.0.3"])
+      s.add_runtime_dependency(%q<highline>, [">= 1.5.0"])
       s.add_development_dependency(%q<newgem>, [">= 1.3.0"])
       s.add_development_dependency(%q<hoe>, [">= 1.8.0"])
     else
@@ -43,6 +44,7 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<log4r>, [">= 1.0.5"])
       s.add_dependency(%q<commandline>, [">= 0.7.10"])
       s.add_dependency(%q<mash>, [">= 0.0.3"])
+      s.add_dependency(%q<highline>, [">= 1.5.0"])
       s.add_dependency(%q<newgem>, [">= 1.3.0"])
       s.add_dependency(%q<hoe>, [">= 1.8.0"])
     end
@@ -53,6 +55,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<log4r>, [">= 1.0.5"])
     s.add_dependency(%q<commandline>, [">= 0.7.10"])
     s.add_dependency(%q<mash>, [">= 0.0.3"])
+    s.add_dependency(%q<highline>, [">= 1.5.0"])
     s.add_dependency(%q<newgem>, [">= 1.3.0"])
     s.add_dependency(%q<hoe>, [">= 1.8.0"])
   end

data/lib/dvdprofiler2xbmc.rb

@@ -27,5 +27,5 @@ require 'dvdprofiler2xbmc/models/xbmc_info'
 
 
 module Dvdprofiler2xbmc
-  VERSION = '0.0.6'
+  VERSION = '0.0.8'
 end

data/lib/dvdprofiler2xbmc/app_config.rb

@@ -9,17 +9,86 @@
 # a Hash and does cause a limitation where the key must be either
 # a symbol or a string.
 module AppConfig
-  @config = Mash.new
+
+  # @config, @help, @initial, @data_type, @validate, and @validate_item
+  # are mashes that share the same keys.  For example @help.foo would be
+  # the help text for @config.foo
+
+  # the current config values
+  @config    = Mash.new
+
+  # help about the config item
+  @help      = Mash.new
+
+  # initial (default) config values
+  @initial   = Mash.new
+
+  # data type constants used in the editor
+  @data_type = Mash.new
+
+  # validate the config item
+  @validate  = Mash.new
+
+  # validate an entry for a config item, note usually need to allow
+  # empty string for either array entry termination or to accept
+  # a default value
+  @validate_item = Mash.new
+
+  # the @navigation array contains hashes where each hash is a "page"
+  # that contains an array of @config keys.  This provides a natural
+  # organization for UIs.
+  @navigation = []
+
+  class << self
+    attr_reader :help, :initial, :navigation, :config, :data_type, :validate, :validate_item
+  end
+
   @yaml_filespec = File.join(ENV['HOME'], '.dvdprofiler2xbmcrc')
 
+  # shortcut accessor for @config items
   def self.[](k)
     @config[k]
   end
 
+  # shortcut accessor for @config items
   def self.[]=(k,v)
     @config[k] = v
   end
 
+  # does the config file exist?
+  def self.exist?
+    File.exist?(@yaml_filespec)
+  end
+
+  # load the config file, overwriting current values
+  def self.load
+    begin
+      if File.exist?(@yaml_filespec)
+        cfg = YAML.load_file(@yaml_filespec)
+        cfg.delete('logger')
+        if cfg.version != @config.version
+          AppConfig[:logger].info {"config file (#{@yaml_filespec}) version mismatch"}
+          AppConfig[:logger].info {"file version => #{cfg.version}"}
+          AppConfig[:logger].info {"config version => #{@config.version}"}
+          # remove from @config any keys that are not in cfg
+          file_keys = cfg.keys.sort
+          current_keys = @config.keys.sort
+          intersection_keys = file_keys & current_keys
+          obsolete_keys = file_keys - intersection_keys
+          obsolete_keys.each do |key|
+            AppConfig[:logger].info { "removing obsolete key #{key}"}
+            cfg.delete(key)
+          end
+          cfg.delete('version')
+        end
+        @config.merge! cfg
+      end
+    rescue Exception => e
+      AppConfig[:logger].error { "Error loading config file \"#{@yaml_filespec} - " + e.to_s + "\n" + e.backtrace.join("\n") }
+    end
+  end
+
+  # save the config file
   def self.save
     begin
       unless @config.blank?
@@ -36,80 +105,341 @@ module AppConfig
     end
   end
 
-  def self.load
-    begin
-      if File.exist?(@yaml_filespec)
-        cfg = YAML.load_file(@yaml_filespec)
-        cfg.delete('logger')
-        @config.merge! cfg
+  # generate a string for displaying the current config
+  def self.to_s
+    buf = []
+    @navigation.each do |page|
+      page.each do |heading, keys|
+        buf << heading
+        buf << ''
+        keys.each do |key|
+          buf << key
+          buf << @help[key].split("\n").collect{|line| "  " + line}.join("\n") unless @help[key].blank?
+          buf << "Initial:"
+          buf << @initial[key].pretty_inspect.collect{|line| "  " + line.rstrip}
+          buf << "Current:"
+          buf << @config[key].pretty_inspect.collect{|line| "  " + line.rstrip}
+          buf << ''
+        end
+        buf << ''
       end
-    rescue Exception => e
-      AppConfig[:logger].error { "Error loading config file \"#{@yaml_filespec} - " + e.to_s }
     end
+    buf.join("\n")
   end
 
+  # is the current config valid?
+  def self.valid?
+    valid = true
+    @validate.each do |field, value|
+      unless @validate[field].call(@config[field])
+        valid = false
+      end
+    end
+    valid
+  end
+
+  # set the config to the default values
   def self.default
     # Note, all paths and extensions are case sensitive
 
-    # Array of paths to scan for media
-    # Note, directories underneath these will be added as genres to
-    # each .nfo file.  For example:
-    # /media/royw-gentoo/public/data/movies/Action/Bond/Goldeneye.m4v
-    # will add 'Action' and 'Bond' genres to Goldeneye.nfo
-    # Also note, that duplicate genres will be collapsed into single
-    # genres in the .nfo file.
+    # this is the version of the rc file and is used to trigger
+    # removal of no longer existing keys
+    @config.version = '0.1.0'
+
+    @config.color_enabled = true
+
+    @navigation = [
+        {'Application Options' => %w(color_enabled)},
+        {'Setup Paths' => %w(directories subdirs_as_genres collection_filespec images_dir)},
+        {'Setup Permissions'=> %w(file_permissions dir_permissions)},
+        {'Setup Genre Mapping' => %w(genre_maps)},
+        {'File Naming' => %w(media_extensions image_extensions naming)},
+        {'Parsing' => %w(part_regex media_parsers)}
+      ]
+
+    @help.directories = [
+        'Array of paths to scan for media.  Replace with your paths.'
+      ].join("\n")
+    @initial.directories = []
+    # My directories are:
     @config.directories = [
-        '/media/dad-kubuntu/public/data/videos_iso',
-        '/media/dcerouter/public/data/videos_iso',
-        '/media/royw-gentoo/public/data/videos_iso',
-        '/media/royw-gentoo/public/data/movies'
+#         '/media/dad-kubuntu/public/data/videos_iso',
+#         '/media/dcerouter/public/data/videos_iso',
+#         '/media/royw-gentoo/public/data/videos_iso',
+#         '/media/royw-gentoo/public/data/movies'
       ]
+    @data_type.directories = :ARRAY_OF_PATHSPECS
+    @validate.directories = lambda do |directories|
+      valid = false
+      unless directories.empty?
+        valid = true
+        directories.each do |dir|
+          unless File.exist?(dir) && File.directory?(dir)
+            valid = false
+          end
+        end
+      end
+      valid
+    end
+    @validate_item.directories = lambda do |dir|
+      dir.empty? || (File.exist?(dir) && File.directory?(dir))
+    end
+
+    @help.subdirs_as_genres = [
+        'Directories underneath these will be added as genres to each .nfo file.',
+        'For example:',
+        '  /media/movies/Action/Bond/Goldeneye.m4v',
+        'will add "Action" and "Bond" genres to Goldeneye.nfo',
+        'Also note, that duplicate genres will be collapsed into single genres in the .nfo file.'
+      ].join("\n")
+    @initial.subdirs_as_genres = true
+    @config.subdirs_as_genres = @initial.subdirs_as_genres
+    @data_type.subdirs_as_genres = :BOOLEAN
 
     # Typical locations are:
     # @config.collection_filespec = File.join(ENV['HOME'], 'DVD Profiler/Databases/Exports/Collection.xml')
     # @config.images_dir = File.join(ENV['HOME'], 'DVD Profiler/Databases/Default/Images')
     #
-    # My locations are:
-    @config.collection_filespec = '/home/royw/DVD Profiler/Shared/Collection.xml'
-    @config.images_dir = '/home/royw/DVD Profiler/Shared/Images'
+    @help.collection_filespec = [
+        'The location of DVD Profiler\'s exported Collection.xml'
+      ].join("\n")
+    @initial.collection_filespec = '~/DVD Profiler/Databases/Exports/Collection.xml'
+    # My location is:
+    @config.collection_filespec = @initial.collection_filespec
+#     @config.collection_filespec = '/home/royw/DVD Profiler/Shared/Collection.xml'
+    @data_type.collection_filespec = :FILESPEC
+    @validate.collection_filespec = lambda do |filespec|
+      File.exist?(filespec) && File.file?(filespec)
+    end
+    @validate_item.collection_filespec = lambda do |filespec|
+      filespec.empty? || (File.exist?(filespec) && File.file?(filespec))
+    end
+
+    @help.images_dir = [
+        'The location of DVD Profiler\'s cover scan images.'
+      ].join("\n")
+    @initial.images_dir = '~/DVD Profiler/Databases/Exports/Images'
+    # My location is:
+    @config.images_dir = @initial.images_dir
+#     @config.images_dir = '/home/royw/DVD Profiler/Shared/Images'
+    @data_type.images_dir = :PATHSPEC
+    @validate.images_dir = lambda do |directory|
+      File.exist?(directory) && File.directory?(directory)
+    end
+    @validate_item.images_dir = lambda do |directory|
+      directory.empty? || (File.exist?(directory) && File.directory?(directory))
+    end
 
     # You will probably need to edit the MEDIA_EXTENSIONS to specify
     # the containers used in your library
-    @config.media_extensions = [ 'iso', 'm4v' ]
+    @help.media_extensions = [
+        'The supported file extensions for movie media.',
+        'You probably will not need to edit this list.'
+      ].join("\n")
+    @initial.media_extensions = %w(iso m4v mp4 mpeg wmv asf flv mkv mov aac nut ogg ogm ram rm rv ra rmvb 3gp vivo pva nuv nsv nsa fli flc)
+    @config.media_extensions = @initial.media_extensions
+    @data_type.media_extensions = :ARRAY_OF_STRINGS
+    @validate.media_extensions = lambda do |extensions|
+      !extensions.collect{|ext| ext.blank? ? nil : ext}.compact.empty?
+    end
+    @validate_item.media_extensions = lambda do |extension|
+      true
+    end
 
     # You probably will not need to change these
     # Source file extensions.
-    @config.image_extensions    = [ 'jpg', 'jpeg', 'png', 'gif' ]
-    @config.nfo_extensions      = [ 'nfo' ]
-    # Destination file extensions
-    @config.thumbnail_extension        = 'tbn'
-    @config.nfo_extension              = 'nfo'
-    @config.no_imdb_extension          = 'no_imdb_lookup'
-    @config.no_tmdb_extension          = 'no_tmdb_lookup'
-    @config.no_isbn_extension          = 'no_isbn'
-    @config.dvdprofiler_xml_extension  = 'dvdprofiler.xml'
-    @config.dvdprofiler_yaml_extension = 'dvdprofiler.yaml'
-    @config.imdb_xml_extension         = 'imdb.xml'
-    @config.imdb_yaml_extension        = 'imdb.yaml'
-    @config.tmdb_xml_extension         = 'tmdb.xml'
-    @config.tmdb_yaml_extension        = 'tmdb.yaml'
-    @config.fanart_extension           = '-fanart'
-    @config.new_extension              = '.new'
-    @config.backup_extension           = '~'
+    @help.image_extensions = [
+        'The file extensions for image files such as cover art, fan art, and thumbnails.',
+        'You probably will not need to edit this list.'
+      ].join("\n")
+    @initial.image_extensions = %w(jpg jpeg png gif bmp tbn)
+    @config.image_extensions  = @initial.image_extensions
+    @data_type.image_extensions = :ARRAY_OF_STRINGS
+    @validate.image_extensions = lambda do |extensions|
+      !extensions.collect{|ext| ext.blank? ? nil : ext}.compact.empty?
+    end
+    @validate_item.media_extensions = lambda do |extension|
+      true
+    end
 
     # map some genre names
-    @config.genre_maps = {
-        'SciFi'           => 'Science Fiction',
-        'Science-Fiction' => 'Science Fiction',
-        'Anime'           => 'Animation',
-        'Musical'         => 'Musicals',
-        'Music'           => 'Musicals'
+    @help.genre_maps = [
+        'Change the name of genres.',
+        'For example, "SciFi" can be mapped to "Science Fiction"'
+      ].join("\n")
+    @initial.genre_maps = {
+      'SciFi'           => 'Science Fiction',
+      'Science-Fiction' => 'Science Fiction',
+      'Anime'           => 'Animation',
+      'Musical'         => 'Musicals',
+      'Music'           => 'Musicals',
+      'War Film'        => 'War'
     }
+    @config.genre_maps = @initial.genre_maps
+    @data_type.genre_maps = :HASH_STRING_KEYS_STRING_VALUES
+
+    @help.file_permissions = [
+        'Set the file permissions of all files in the scanned directories to this value.',
+        'This is useful to maintain consistancy of file permissions'
+      ].join("\n")
+    @initial.file_permissions = 0664.to_s(8)
+    @config.file_permissions = @initial.file_permissions
+    @data_type.file_permissions = :PERMISSIONS
+    @validate.file_permissions = lambda do |permissions|
+      (permissions.to_i(8) >= 0) && (permissions.to_i(8) <= 07777)
+    end
+    @validate_item.file_permissions = lambda do |permissions|
+      permissions.empty? || ((permissions.to_i(8) >= 0) && (permissions.to_i(8) <= 07777))
+    end
+
+    @help.dir_permissions = [
+        'Set the directory permissions of all sub-directories in the scanned directories to this value.',
+        'This is useful to maintain consistancy of directory permissions'
+      ].join("\n")
+    @initial.dir_permissions = 0777.to_s(8)
+    @config.dir_permissions = @initial.dir_permissions
+    @data_type.dir_permissions = :PERMISSIONS
+    @validate.dir_permissions = lambda do |permissions|
+      permissions.empty? || ((permissions.to_i(8) >= 0) && (permissions.to_i(8) <= 07777))
+    end
+
+    # This maps the file type to extension.
+    # The one unusual case in the list is for :fanart where
+    # the actually media extension will be appended to this
+    # extension (see FanartController)
+    @help.extensions = [
+        'Internally used to map types to file extensions.',
+        'You may change the values if you need different file extensions.',
+        'Do not change the keys unless you really know what you are doing!'
+      ].join("\n")
+    @initial.extensions  = {
+        :fanart           => '-fanart',
+        :thumbnail        => 'tbn',
+        :nfo              => 'nfo',
+        :dvdprofiler_xml  => 'dvdprofiler.xml',
+        :imdb_xml         => 'imdb.xml',
+        :tmdb_xml         => 'tmdb.xml',
+        :new              => 'new',
+        :backup           => '~',
+        :no_isbn          => 'no_isbn',
+        :no_imdb_lookup   => 'no_imdb_lookup',
+        :no_tmdb_lookup   => 'no_tmdb_lookup',
+      }
+    @config.extensions  = @initial.extensions
+#     @data_type.extensions = :HASH_FIXED_SYMBOL_KEYS_STRING_VALUES
+
+    # substitutions:
+    #  %t  => movie title
+    #  %e  => extension from @config.extensions
+    #  %p  => part
+    @help.naming = [
+        'Defines the various formatting of generated file names.',
+        'Do not change the naming keys (ex: :fanart, :thumbnail,...).',
+        'The :part key/value defines the format for a multi-part media while :no_part defines the format for single part media.',
+        'The substutions are:',
+        '  %t => movie title',
+        '  %e => appropriate file extension',
+        '  %p => the part substring from the media file (ex: \'cd1\', \'disc3\')',
+        '  %r => video resolution',
+        '  %y => year'
+      ].join("\n")
+    @initial.naming = {
+        :fanart          => {:part => '%t%e',  :no_part => '%t%e'},
+        :thumbnail       => {:part => '%t.%e', :no_part => '%t.%e'},
+        :nfo             => {:part => '%t.%e', :no_part => '%t.%e'},
+        :dvdprofiler_xml => {:part => '%t.%e', :no_part => '%t.%e'},
+        :imdb_xml        => {:part => '%t.%e', :no_part => '%t.%e'},
+        :tmdb_xml        => {:part => '%t.%e', :no_part => '%t.%e'}
+      }
+    @config.naming = @initial.naming
+
+    # recognized multi-part tokens where N is an integer:
+    #  *.cdN.*
+    #  *.ptN.*
+    #  *.diskN.*
+    #  *.discN.*
+    @help.part_regex = [
+        'The regular expression for parsing the part sub-string from the media file.',
+        'For example to find "cd2" in "movie.cd2.avi"'
+      ].join("\n")
+    @initial.part_regex = /\.(cd|pt|disk|disc)\d+/i
+    @config.part_regex = @initial.part_regex
+
+    # media filename parsers.
+    # The :tokens array refers to the matches in the regex, ex:
+    #  {:regex => /^\s*(.*\S)\s*\.([^.]+)\s*$/, :tokens => [:title, :extension]}
+    # :title will be assigned the first match (.*\S) and
+    # :extension will be assigned the second match ([^.]+)
+    # See (Media.parse)
+    @help.media_parsers = [
+        'Media filename parsers.',
+        'The :tokens array refers to the matches in the regex, ex:',
+        '  {:regex => /^\s*(.*\S)\s*\.([^.]+)\s*$/, :tokens => [:title, :extension]}',
+        ':title will be assigned the first match (.*\S) and',
+        ':extension will be assigned the second match ([^.]+).',
+        'Valid tokens are:  :title, :year, :resolution, :part, :extension'
+      ].join("\n")
+    @initial.media_parsers = [
+      # "movie title - yyyy[res].partN.ext"
+      {:regex => /^\s*(.*\S)\s*\-\s*(\d{4})\s*\[(\S*)\]\s*\.(cd\d+|pt\d+|disk\d+|disc\d+)\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :resolution, :part, :extension]
+      },
+      # "movie title (yyyy)[res].partN.ext"
+      {:regex => /^\s*(.*\S)\s*\(\s*(\d{4})\s*\)\s*\[(\S*)\]\s*\.(cd\d+|pt\d+|disk\d+|disc\d+)\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :resolution, :part, :extension]
+      },
+      # "movie title[res].partN.ext"
+      {:regex => /^\s*(.*\S)\s*\[(\S*)\]\s*\.(cd\d+|pt\d+|disk\d+|disc\d+)\.([^.]+)\s*$/,
+      :tokens => [:title, :resolution, :part, :extension]
+      },
+      # "movie title - yyyy[res].ext"
+      {:regex => /^\s*(.*\S)\s*\-\s*(\d{4})\s*\[(\S*)\]\s*\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :resolution, :extension]
+      },
+      # "movie title (yyyy)[res].ext"
+      {:regex => /^\s*(.*\S)\s*\(\s*(\d{4})\s*\)\s*\[(\S*)\]\s*\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :resolution, :extension]
+      },
+      # "movie title[res].ext"
+      {:regex => /^\s*(.*\S)\s*\[(\S*)\]\s*\.([^.]+)\s*$/,
+      :tokens => [:title, :resolution, :extension]
+      },
+      # "movie title - yyyy.partN.ext"
+      {:regex => /^\s*(.*\S)\s*\-\s*(\d{4})\s*\.(cd\d+|pt\d+|disk\d+|disc\d+)\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :part, :extension]
+      },
+      # "movie title (yyyy).partN.ext"
+      {:regex => /^\s*(.*\S)\s*\(\s*(\d{4})\s*\)\s*\.(cd\d+|pt\d+|disk\d+|disc\d+)\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :part, :extension]
+      },
+      # "movie title.partN.ext"
+      {:regex => /^\s*(.*\S)\s*\.(cd\d+|pt\d+|disk\d+|disc\d+)\.([^.]+)\s*$/,
+      :tokens => [:title, :part, :extension]
+      },
+      # "movie title - yyyy.ext"
+      {:regex => /^\s*(.*\S)\s*\-\s*(\d{4})\s*\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :extension]
+      },
+      # "movie title (yyyy).ext"
+      {:regex => /^\s*(.*\S)\s*\(\s*(\d{4})\s*\)\s*\.([^.]+)\s*$/,
+      :tokens => [:title, :year, :extension]
+      },
+      # "movie title.ext"
+      {:regex => /^\s*(.*\S)\s*\.([^.]+)\s*$/,
+      :tokens => [:title, :extension]
+      }
+    ]
+    @config.media_parsers = @initial.media_parsers
+
+    @help.do_update = [
+        'Perform update.'
+      ].join("\n")
+    @initial.do_update = true
+    @config.do_update = @initial.do_update
+  end
 
-    @config.file_permissions = 0664
-    @config.dir_permissions = 0777
-    @config.imdb_query = true
-    @config.tmdb_query = true
-    @config.do_update = true
+  private
+  def initialize
+    AppConfig[:logger].error {"Should never be instantiated"}
   end
 end