Skip to content

Scanner

Jump to bottom
optyfr edited this page Jul 12, 2018 · 7 revisions

Folders


This is where folders have to be defined, at least the Roms destination folder is mandatory, other are optional
You can define many sources, they will be used in the order they are added
Each field accept drag & drop from desktop

Settings


Here you will find the scanner settings for the current loaded profile :

  • Calculate All SHA1
    Will calculate SHA1 for each file found in archives. Since decompressing file is needed, this will slow down scan process. This is not normally needed since JRomManager detects potential CRC hash collision inside the same dat and thus force automatically SHA1/MD5 calculation on those CRC files... but since you may include archives files in dirscan not related with the current loaded Dat, this may finally had not detectable collision anyway
  • Enable Multithreading
    Will use all available CPU cores when scanning and fixing, this may be slower with slow disks, gain will be really great with SSD
  • Create missing sets
    Tell scanner that missing sets, where rom are available, have to be created. If this is unchecked, no new set will be created and only already existing sets can be fixed
  • Create only complete sets
    This option is available only when "Create missing sets" is checked, if checked will create set if and only if the set can be completed (all roms and disks are available)
  • Ignore unneeded containers
    Will ignore (and so won't delete) any unneeded archives known to be a set with roms entry but not currently needed because of the current filter settings
  • Ignore unneeded entries
    Will ignore any extra entries in archive sets (useful for destination used with various emulators, or various emulator version)
  • Ignore unknown containers
    Will ignore any unknown files in destination (check this if you want to keep any readme.txt files)
  • Use implicit merge
    Will try to find identical rom in parent even if "merge" attribute as not been set for the clone rom in dat file. This is how ClrMamePro works when checked. If unchecked, will merge rom only if explicitly told in dat file definition (explicit merge)
  • Ignore merge name for roms
    When merging clones into parent, will not use the name set in merge attribute, and keep the original name used for clone rom as if it was not merged at all
  • Ignore merge name for disks
    When merging clones into parent, will not use the name set in merge attribute, and keep the original name used for clone disk as if it was not merged at all
  • Exclude games
    Will exclude games and keep only machines, bios, and devices. Used for building MESS roms dir
  • Exclude machines
    Will exclude machines. Machines compared to games are those with softwarelist related. This option is used for building Arcade (no console, no computers) only roms dir
  • Backup
    Will store first in backup folder any rom that will be delete while fixing. Backup folder is always internally used as source path while scanning
  • Compression
    • Directories
      Will create directories with uncompressed entries instead of archives
    • Zip archives
      Will use internal zip compressor, this is the fastest, whatever the compression level chosen, but may leave extra entries for folders in zip
    • Zip archives (external)
      To create Zip files, will use SevenZipJBinding if available or otherwise external compressor defined in general settings, this is usually slower even if SevenZipJBinding is using native 7z library
    • 7Zip archives (external)
      To create 7z files, will use SevenZipJBinding if available or otherwise external compressor defined in general settings, this is usually slower even if SevenZipJBinding is using native 7z library
    • TorrentZip archives
      Will first create zip files using internal compressor at compression level 1, then torrentzip the file at the end using JtrrntZip
  • Merge Mode
    • Full merge (including bios)
      Use this mode to put all clones with parent including bios
    • Merged (no bios)
      Use this mode to put all clones with parent, but bios will still be in a separate archive
    • Non Merged (including bios and devices) Will make each parent or clone in an independent archive, with all bios and devices files needed
    • Non Merged (including bios)
      Will make each parent or clone in an independent archive, with all bios files needed, but not devices
    • Non Merged (no bios)
      Will make each parent or clone in an independent archive, excluding bios and devices kept in separated archives. This is the preferred mode when building sets which bios has to be put in separate path (Recalbox for example)
    • Split (default)
      Each parent, clone, bios, device, ... will be put in separate archive, excluding from clones entries in common with parent
  • Collision Mode
    Only for Merged and Full merge
    • Single file
      If a clone entry have same name but different crc with an entry from parent, the entry will be put in a subfolder (named by clone name)
    • Single clone
      If a clone entry have same name but different crc with an entry from parent, all the clone entries will be put in a subfolder (named by clone name)
    • All clones
      If a clone entry have same name but different crc with an entry from parent, all the entries from all clones will be put in subfolders (named by clone name)
    • All clones even if no collision (but optimize between clones)
      Even if there is no collision with parent, all the entries from all clones will be put in subfolders (named by clone name), excluding entries in common between clones
    • All clones even if no collision
      Even if there is no collision with parent, all the entries from all clones will be put in subfolders (named by clone name)
    • All clones even if no collision (including disks)
      Even if there is no collision with parent, all the entries from all clones will be put in subfolders (named by clone name), and the same will be made for disks (even if collision should never happen)


There is a contextual menu for presets, selecting a preset will automatically select/deselect many options...

Filters


Here you can filter by systems, but also remove game clones, with disks, with samples, filter by cabinet type, display orientation, driver status, software support (only for software lists), or by year...
Be careful, even if the change is immediate in profile list, you will have to scan again before fixing...

System filter


Filter by systems has a context menu that permit to select/unselect all/bios/software, or invert selection

Advanced Filters


The advanced filters, specific to mame, need that you import some special files:

  • nplayers.ini

    As soon as you drop the nplayers.ini, you'll be able to filter by number of players (software list not supported)
    A context menu will permit to rapidly select/deselect all, or invert selection
  • catver.ini

    As soon as you drop the catver.ini, you'll be able to filter by games categories/subcategories (software list not supported)
    A context menu will permit to rapidly select/deselect all/mature
Clone this wiki locally