Go to file
2009-05-09 21:30:53 +00:00
GNU-FDL.txt Initial creation. 2009-03-21 18:55:50 +00:00
GNU-GPL.txt Initial creation. 2009-03-21 18:55:50 +00:00
nds2rm - Add support for non sorted dsrom.xml file.. 2009-05-09 21:30:53 +00:00
ReadMe.txt - Update RRFNFS to 1.1 version. 2009-04-26 00:14:32 +00:00
ReleaseNotes.txt - Add support for non sorted dsrom.xml file.. 2009-05-09 21:30:53 +00:00
ToDo.txt - Update doc files for 1.0.0-1 release. 2009-04-12 01:20:14 +00:00

# $RCSfile: ReadMe.txt,v $
# $Revision: 1.4 $
# $Name:  $
# $Date: 2009/04/26 00:14:32 $
# $Author: agibert $





Welcome to NDS2RM:Nintendo DS Simple ROM Manger !

This little shell script (BASH) is designed for automatize simple Nintendo DS ROM Management.



There is three modes available
------------------------------
    - Test Mode (-T | --test):
      In this mode, nds2rm will load rom data from dsrom.xml, scan the roms repository and finally report info and statistics about what would be done in correct mode. No file are modified.
    - Correct Mode (-C | --correct):
      In this mode, nds2rm will load rom data from dsrom.xml, scan the roms repository, perform action on rom files (extract / rename / compress) and finally report info and statistics about what have been done.
    - dsrom.lst dump Mode (-D | --dsrom):
      In this mode, nds2rm will load rom data from dsrom.xml, scan the roms repository and finally dump on stdout the dsrom.lst file.
      This file is used by NinjaPass cards (http://www.ninjapass.com).



Repository structure
--------------------
    The repository is minimally composed by two directory: roms and misc.
    The rom directory is full of rom files. These file can be uncompressed (.nds) or compressed. Three compressors are supported: zip, rar and 7zip. Next to a nds2rm run, the rom file names and rom archive file names follow the RRFNFS 1.1 format. Before a nds2rn run, the rom file names must start with a number followed by a space.

    In the misc directory, nds2rm is looking for the dat file: dsrom.xml. This file is comming from http://www.advanscene.com/offline/datas/ADVANsCEne_NDS.zip
    


RRFNFS 1.1: Rx3 Rom File Name Format Standard version 1.1
---------------------------------------------------------
      nds2rm stores ROMs in a .nds file with a  standardized file name format:
	     XXXX - NNNNNNNNNN (R=L1-...-Ln) [SS].nds
      with
	     XXXX:      id
	     NNNNNNNNN: name
	     R:         Region
             L1-...-Ln: Language list
	     SS:        Status (OK,KO)

      nds2rm compresses each ROM file in an archive file with a standardized file name format:
	     XXXX - NNNNNNNNNN (R=L1-...-Ln) [SS] {CCCCCCCC} <FFFF>.ccc
     with:
	     XXXX:      id
	     NNNNNNNNN: name
	     R:         Region
	     L1-...-Ln: Language list
	     SS:        Status (OK,KO)
	     CCCCCCCC:  CheckSum
	     FFFF:	FingerPrint
	     ccc:	Archive suffix (zip, rar, 7z)



Statistics explanations
-----------------------
Example:

run statistics:
   1 roms set     to OK
   0 roms changed to OK
3560 roms kept    to OK

   0 roms set     to KO
   0 roms changed to KO
  61 roms kept    to KO

   0 roms are renumbered

This details in term of status and renumbering what has been (or would be) done.


global statistics:
3600 roms are in dsrom.dat		Number of entry in the XML dat file
3622 roms are found                     Number of ROMs found in the input repository
   0 roms are ignored                   Number of ROMs ignored by the "max idx" option
3622 roms are proceeded                 Number of ROMs proceed (found - ignored)
  22 roms are duplicated                Number of ROMs with the same id and the same status

3561 total roms are  OK                 Total number of ROMs which have the OK status
   6 roms are dup    OK                 Number of duplacted OK ROMs
3555 roms are        OK                 Number of unique ROMs which have the OK status (total - duplicated)

  61 total roms are  KO                 Total number of ROMs which have the KO status
  16 roms are dup    KO                 Number of duplacted KO ROMs
  45 roms are        KO                 Number of unique ROMs which have the OK status (total - duplicated)
  39 roms are KO not OK                 Number of unique ROMs which have the OK and not the OK status

   6 roms are missing                   Number of missing ROMs (ROMs found in the dat file and not found in the repository)

The four more important numbers are:
3600 roms are in dsrom.dat
3555 roms are        OK
  39 roms are KO not OK
   6 roms are missing

This means that on 3600 ROMs found in the dat file, 6 are missing in the repository, 3555 are found OK and 39 are found KO.



Command line help
-----------------
Path options:
-i | --repo_in  <path>:   input  repository path                  (default: /opt/public/nds)
-o | --repo_out <path>:   output repository path                  (default: /opt/public/nds)

Mode selection
-C | --correct:           corect output repository
-T | --test:              test input repository                   (default mode)
-D | --dsrom:             dsrom.lst will be dumped
-h | --help:              print this help and exit
-V | --version:           print the version and exit

Global options
-m | --max <id>:          maximum rom id to load from dat file    (default: 9999)
-v | --verbose:           switch on verbosity
-c | --compressor <c>:    set archive compressor (zip, rar or 7z) (default: 7z)

Test and Correct Mode options:
-j | --jobs <jobs>:       nuber of parallel jobs to run           (default: 1)
-r | --rebuild:           don't trust archive file name           (test & correct mode)
                          rebuild archives                        (correct mode)
-n | --renum:             try to renumber archives
     --list_ok:           list roms with ok status
     --list_ko:           list roms with ko status
     --list_miss:         list missing roms



Examples
--------
	- nds2rm -T -i /opt/public/nds.new -o /opt/public/nds.new -m 3600 -n
	  it will ask nds2rm to tests the repository (/opt/public/nds.new) with renum option. Only the 3600 first roms will be used.

	- nds2rm -C -i /opt/public/nds.old -o /opt/public/nds.new -m 3600 -n
	  it will ask nds2rm to create a new repository in /opt/public/nds.new by reading an existing one from /opt/public/nds.old. Only the 3600 first roms will be processed. The roms archive with the right name format (RRNF) will not be extracted / recompressed. If needed roms will be renumbered.

	- nds2rm -C -i /opt/public/nds.old -o /opt/public/nds.new -m 3600 -r -n
	  it will ask nds2rm to create a new repository in /opt/public/nds.new by reading an existing one from /opt/public/nds.old. Only the 3600 first roms will be processed. The roms archive name format (RRNF) will not be trusted and systematically extracted / recompressed. If needed roms will be renumbered.



License
-------
NDS2RM is licensed under the GPL GNU Licenses.
For more information, please read the corresponding source file headers.
The license details can be found in the GNU-GPL.txt and GNU-FDL.txt files.



Enjoy it!

Your NDS2RM Team.

arnaud@rx3.net
http://www.rx3.org/dvp/?dvp=nds2rm