
ListTool v3.4 (20.04.2003)


 2001-2003, Chrisbee



Please scroll down for English instructions.



DEUTSCH



Was ist ListTool?

ListTool ist ein Konvertierungswerkzeug fr ROM-Informationslisten. Es knnen folgende Dateitypen gelesen werden:

   ClrMamePro "*.dat"
   ClrMamePro "*.log"
   RomCenter "*.dat"
   GoodTools "*Have.txt"
   GoodTools "*Miss.txt"
   GoodTools "*Log.txt"
   MESS "*.crc"
   Einige ausfhrbare Dateien "*.exe" (
   Ordner/Verzeichnisse

Geladene Dateien lassen sich in folgenden Formaten abspeichern:

   ClrMamePro "*.dat"
   RomCenter "*.dat"
   Batch-Dateien "*.bat"
   Get-Listen "*.txt"
   Link-Listen "*.htm"

Weitere Merkmale:

   Laden/Erstellen von Listen durch einfaches Ziehen der Quelldatei 
    oder des Quellordners auf das Hauptfenster
   Multi-Datei-Verarbeitung
    (Einfach die gewnschten Quelldateien im WindowsExplorer markieren
    und auf das ListTool-Fenster ziehen)
   CRC32-/MD5-Untersttzung



 ) mame.exe         mess.exe
    mamepp.exe       sname.exe
    mame32.exe       good*.exe
    pinmamew.exe
    raine32.exe



Wie verwendet man ListTool?

Ein Doppelklick auf die Datei "ListTool.exe" startet die Applikation. Das erscheinende Dialogfenster enthlt einige Eingabefelder, in denen die Kopfdaten der geladenen Liste angezeigt und verndert werden knnen, und einige Schaltflchen, welche im Folgenden nher beschrieben werden:

[Laden]
Ein Klick auf diese Schaltflche ffnet einen Datei-Auswahl-Dialog. Der Benutzer whlt die zu ffnende Datei aus und besttigt mit [ffnen]. Daraufhin werden die Daten in den Speicher geladen und angezeigt.
Tipp: Alternativ zum Laden der Dateien ber die Schaltflche [Laden] lassen sich die Dateien auch bequem mit der Maus aus einem Explorer-Fenster auf die Applikation ziehen.

[Speichern]
Mit dem Bettigen der Schaltflche [Speichern] gelangt der Benutzer in ein kleines Men in welchem er den gewnschten Dateityp fr die Ausgabe whlt. Ein Klick auf die Entsprechende Schaltflche lsst ein Datei-Auswahl-Dialog erscheinen ber den der Ort und der Name der Zieldatei gewhlt wird. Durch Bettigen der Schaltflche [Speichern] wird der Vorgang abgeschlossen.

[Scannen]
Mit der Funktion "Scannen" kann ein beliebiger Ordner ausgewhlt werden. Sein Inhalt wird daraufhin gescant und aus den Daten wird eine neue Liste zusammengestellt. Es empfiehlt sich die Kopfdaten nach dem Scannen anzupassen bzw. zu ergnzen.
Tipp: Alternativ zum Scannen des Ordners ber die Schaltflche [Scannen] lassen sich die Ordner auch bequem mit der Maus aus einem Explorer-Fenster auf die Applikation ziehen.

[Mischen]
ber diese Schaltflche wird dem Benutzer die Mglichkeit gegeben eine weitere Liste zu ffnen und deren Inhalt mit der aktuellen Liste im Speicher zu mischen. Dabei geht das Programm wie folgt vor: Die Namen aller Spiele der neuen Datei werden mit den Namen der Spiele im Speicher verglichen. Gibt es keine bereinstimmung, so wird das neue Spiel der Datei im Speicher komplett hinzugefgt (inkl. aller ROMs und Samples). Bei einer bereinstimmung werden statt dessen die ROMs des aktuellen Spiels der neuen Datei mit den ROMs des gefundenen Spiels verglichen. Dieser Vergleich findet aber nicht anhand der Namen statt, wie bei den Spielen, sondern anhand der CRC-Prsumme und der Gre. Es werden nur nicht vorhandene ROMs hinzugefgt, bereits vorhandene werden ignoriert.

[Entfernen]
Mithilfe der Schaltflche [Entfernen] kann eine weitere Liste geffnet werden. Diese wird mit der aktuell im Speicher befindlichen Liste verglichen. bereinstimmende Spiele und ROMs werden daraufhin aus der aktuellen Liste entfernt. brig bleibt nur der Teil der ursprnglich geladenen Liste, welcher nicht in der Vergleichsliste enthalten ist.
Enthalten beide Listen Informationen zur Gre und Prfsumme (CRC) der ROMs, so wird der Vergleich ausschlielich ber diese Angaben gemacht. Der Name der ROMs ist in diesem Fall irrelevant.
Enthlt eine der beiden Listen diese Informationen nicht (z.B. GoodMiss.txt), so wird nur der Name der ROMs verglichen.

[Filter]
Die Filterfunktion gibt dem Benutzer die Mglichkeit Spiele- und Resourcennamen oder Beschreibungen nach bestimmten Texten zu durchsuchen und entweder die gefundenen Eintrge, oder alle Eintrge auer den gefundenen, zu lschen. Dabei kann angegeben werden, ob die Gro-/Kleinschreibung beachtet werden soll. Ein Anwendungsbeispiel wre das Entfernen aller "Bad Dumps" aus der Liste. Es stehen schon einige hufig benutzte Suchmasken zur Verfgung. Es knnen jedoch auch beliebige Texte eingegeben werden. Diese Texte knnen den Platzhalter "?", welcher fr ein beliebiges Zeichen, und "*", welcher fr eine beliebige Anzahl beliebiger Zeichen steht, enthalten.

[Einstellungen]
Im Dialog "Einstellungen" lassen sich allgemeine Informationen eingeben bzw. Programmspezifische Daten ndern. Im Abschnitt "Allgemein" befindet sich ein Eingabefeld um den Namen zu definieren. Dieser wird beim Laden von GoodTool-TXTs und ClrMamePro-LOGs dazu benutzt den Namen und die Beschreibung zu verndern. Beim Speichern einer solchen Liste wird ebenfalls der Name vor dem vorgeschlagenen Dateinamen eingefgt. Dies soll beim Laden der erstellten DATs in ClrMamePro oder RomCenter dafr sorgen, dass sich die Datei besser von den anderen Dateien abhebt. Falls erstellte Dateien versendet werden kann der Empfnger sofort erkennen von wem die Datei kommt. Bei neu erstellten Listen wird der Name im Feld "Autor" eingetragen.
Der Abschnitt "Registry" enthlt eine Schaltflche um alle von ListTool erzeugte Eintrge aus der Registry zu entfernen. Wird beschlossen ListTool vom System eines Benutzers zu entfernen, wird empfohlen vor dem Lschen der Dateien diese Schaltflche zu bettigen. Achtung! Nach Entfernen der Eintrge wird das Programm sofort beendet. Nicht gespeicherte Daten gehen verloren. Scannen: Ein Haken bei "Pfadangaben mit speichern" bewirkt die Angabe der Unterverzeichnisse beim Einlesen von Ordnern. Es lt sich auch angeben, ob in der erstellten Liste die Namen der Spiele und ROMs in Gro- oder Kleinbuchstaben geschrieben werden sollen. Die Funktion "Flood-Schutz" soll verhindern, dass der Benutzer beim Senden an mIRC aus dem Channel geschmissen wird. Man kann hier die Anzahl der Zeilen, welche auf einmal gesendet werden und die Lnge der Pause (in Millisekunden) zwischen den Paketen angeben.

[Info]
ber die Schaltflche [Info] bekommt der Benutzer Informationen zur Version der Applikation.

[Beenden]
Ein Klick auf die Taste [Beenden] schliet das Programm.



Kommandozeilenparameter

ListTool lt sich auch ber Kommandozeilenparameter steuern.
Enthlt die Befehlszeile mit der ListTool gestartet wurde Parameter, so wird kein Dialog angezeigt, sondern lediglich die angegebene Funktion ausgefhrt.

Mgliche Parameter sind:

  /l=<Dateiname>   Dateiname der Quelldatei
  /s=<Dateiname>   Dateiname der Zieldatei (nicht erforderlich)
  /cmdat           Dateityp fr die Ausgabe ist ein ClrMamePro DAT
  /rcdat           Dateityp fr die Ausgabe ist ein RomCenter DAT
  /bat             Dateityp fr die Ausgabe ist eine Batch-Datei
  /get             Dateityp fr die Ausgabe ist eine Get-Liste
  


Was bedeuten die verschiedenen Dateitypen?

Die Erklrung fr die Dateitypen der Programme "ClrMamePro", "RomCenter" und "GoodTools" sind auf der jeweiligen Homepage zu finden (siehe Abschnitt "Hinweise").

Batch-Datei
Mit ListTool erstellte Batch-Dateien enthalten Anweisungen ein neues Verzeichnis anzulegen und smtliche Dateien der geladenen Liste in dieses Verzeichnis zu kopieren.
Auf diese Weise lassen sich die Dateien der Liste schnell bereitstellen und z.b. ber das Internet versenden.
Beim Ausfhren der Batch-Datei mu sich diese im gleichen Verzeichnis befinden wie die zu kopierenden Dateien.

Get-Liste
Es handelt sich um eine Liste der geladenen Dateien im Text-Format. Dem Dateinamen wurde die Zeichenfolge "get " vorangestellt und die Endung ".zip" angehngt.
Diese Listen sind fr die Benutzung mit fserves wie man sie in der IRC-Welt findet gedacht. So lt sich der Inhalt leicht kopieren und in das Fenster des gewnschten Servers einfgen. Daraufhin werden die Dateien heruntergeladen, falls sie auf dem Server verfgbar sind.

Link-Liste
Eine Link-Liste ist eine HTML-Seite mit einem Hyper-Link fr jede einzelne Datei. Dieser Link kann auf einen FTP-Server oder eine Web-Seite zeigen. Bentigte Daten fr die Verbindung werden beim Speichern abgefragt. Die HTML-Seite lt sich mit jedem beliebigen Internet-Browser ffnen.
Mit dieser Funktion lassen sich die Dateien der Liste leicht mit einem Download-Manager von einem FTP oder einer Web-Seite herunterladen.



Hinweise

Eine fehlerfreie Funktion des Programms wird nicht garantiert. Der Autor haftet nicht fr Schden, die durch das Programm entstehen. Die Benutzung von ListTool erfolgt auf EIGENE GEFAHR!

Das Programm in der vorliegenden Version ist Freeware und darf nur unentgeltlich weitergegeben werden.
Alle Rechte liegen beim Autor.

ClrMamePro ist ein ROM-Manager von Roman Scherzer (http://www.clrmame.com/).

RomCenter ist ein ROM-Manager von Eric Bole-Feysot (http://www.romcenter.com/).

Die GoodTools sind ROM-Manager von Cowering (NEWNet #rareroms).

ListTool benutzt folgenden Code:
   zlib Bibliothek von Jean-loup Gailly & Mark Adler (http://www.gzip.org/zlib/)
   MD5 Berechnungsfunktionen von Langfine Ltd. (http://www.langfine.com/)

Das Programm wurde mit UPX komprimiert.
UPX ist ein Exe-Komprimierer von Markus Oberhumer und Laszlo Molnar (http://upx.sourceforge.net/).



Versionen

v3.4 (20.04.2003):
   MESS CRC Dateien werden gelesen
   GoodTools Exe-Dateien werden untersttzt
   Besseres Verhalten bei Verknpfungen zwischen ROMs mit und ohne Dateierweiterung
   Bei der Ausgabe als ClrMamePro DAT werden alle Daten in Anfhrunszeichen gesetzt
   Fehler behoben: Umwandlung von ANSI-Namen in OEM-Namen beim Lesen von ZIP-Dateien (Alle Zeichen sind korrekt)
   Fehler beim Erkennen von ClrMamePro-LOGs behoben
   "rebuildto"-Eintrge in ClrMamePro DATs werden untersttzt
   Fehler behoben: Beim Speichern als ClrMamePro DAT werden CHD-Abbilder als "Disk" eingetragen
   Neues GoodLog-Format wird untersttzt ("New:" & "Old:" statt "N:" & "O:")
   Neues GoodHave/Miss-Format wird untersttzt (Version am Ende des Kopfes)
   Fehler behoben: Laden einer leeren Liste wird nicht mehr unterbunden (wegen Extrainfo)
   Einfache Liste zu Ausgabeformaten hinzugefgt (an einem Formateditor wird gearbeitet)

v3.3 (10.01.2003):
   Sname.exe wird untersttzt
   Seltener Fehler beim Laden von ClrMamePro DATs behoben
    (Spiel-/ROM-Name besteht aus nur einem Wort, hat keine Anfhrungszeichen, aber enthlt Klammern)
   Bessere Kompatibilitt beim lesen von Listen (kein Fehler bei fehlendem CR vor LF)
   MD5 wird bei ClrMamePro DATs, LOGs und MAME gelesen/geschrieben
   Fehler bei der Dateigrenanzeige behoben
   MD5 wird vom Scanner untersttzt
   Neue Entfernen-Funktion (MD5 Untersttzung damit komplett)
   Anzahl der Klnge wird angezeigt

v3.2 (08.01.2003):
   Falsche CRCs und Gren werden bei ClrMame LOGs in der ExtraInfo angezeigt
   Falsche CRCs und Gren in ClrMame LOGs werden wie fehlende ROMs behandelt
   Fehler beim Erkennen von ClrMame LOGs behoben
   Fehler beim Verarbeiten von leeren Spielen (ohne ROMs oder Samples) behoben
   Neue Bereinigungsfunktion beim Laden (doppelte ROMs/Samples in einem Clone werden entfernt)
   Mess.exe und PinMame.exe werden untersttzt
   Mischen vieler Listen: Alle Quelldateien im WindowsExplorer markieren und auf das ListTool-Fenster ziehen
   Mischen von Listen berarbeitet
   Dateigrenanzeige nicht mehr auf 4,2 GB beschrnkt

v3.1 (27.08.2002):
   Problem mit Dateiendungen gelst: bei Verzeichnissen wird die Endung behalten; bei Dateien abgeschnitten
   Neue Option beim Scannen: "Dateiendungen nicht abschneiden"
    (falls Dateien ohne Endung aber mit "Punkt" im Namen gescannt werden)
   Beim Laden von einem ClrMame LOG wird die Kategorie "FIXDATFILE"
   Leere Listen knnen nicht mehr gespeichert werden
   Multi-Datei-Verarbeitung: Alle Quelldateien im WindowsExplorer markieren und auf das ListTool-Fenster ziehen
   GoodTools Log-Dateien werden untersttzt

v3.0 (23.08.2002):
   Fehler beim Scannen behoben: Unterverzeichnissen werden nicht die Dateiendungen abgeschnitten
   Neue Optionen fr den Scanner: Gro-/Kleinschreibung der Spiele- und ROM-Namen
   Scanner-Einstellungen werden vor dem Scannen abgefragt
   ndern des Autorenfelds ndert ggf. automatisch die Felder "Name" und "Beschreibung"
   Laden einer leeren Liste wird erkannt
   Extrainfo/Statistik gendert
   Senden an mIRC mit neuem Format
   Filterfunktion neu geschrieben (Platzhalter '*'/'?' und Wahl zwischen "Name" und "Beschreibung" mglich)
   Englische Texte in erzeugten .bat-Dateien
   Raine32.exe wird erkannt

v2.9 (09.08.2002):
   Fehler behoben: Name wurde beim Scannen nicht in Autorenfeld geschrieben
   Fehler behoben: Horizontales Scrolling des Combo Box Felds im Link-Listen-Dialog aktiviert (keine feste Lnge mehr)
   Extra Info und Senden an mIRC implementiert
   Fehler behoben: ClrMamePro miss.txt-Dateien werden erkannt
   Fehler beim Erkennen von ClrMamePro-LOGs behoben
   Fehler behoben: Absturz bei Entfernen-Funktion
   Fehler behoben: Speichern von Listen, deren Description ungltige Zeichen fr Dateinamen enthlt
   's wird bei Autoren deren Name auf s endet zu '
   Neue Optionen: Pfadangaben mit speichern und Flood-Schutz fr mIRC

v2.8 (18.05.2002):
   Dezimal-Trennzeichen wird automatisch in der eingestellten Benutzersprache dargestellt
   Datumsformat in der Info wird automatisch in der eingestellten Benutzersprache dargestellt
   Englische MFC-Meldungen in der externen englischen Sprachdatei
   Laden von Fremdsprachen optimiert
   Prfix durch Name ersetzt (GoodHave und GoodMiss werden unterschieden, Autor wird ggf. eingefgt)
   Eingestellter Name wird auch vor den Namen der Liste eingefgt (wie bei der Beschreibung)
   Combo-Box beim Speichern als Link-Liste merkt sich die letzten 20 Eintrge
   Dateien die mit "mame.exe -listinfo" erstellt wurden lassen sich laden (Escape-Sequenzen werden gewandelt)
   "mame.exe" kann direkt geladen werden (auch drag & drop)
   ClrMamePro-DAT-Parser verbessert
   Beim Scannen von Verzeichnissen wird dem Verzeichnisnamen nicht die Endung abgeschnitten
   Header-Daten beim Speichern geprft
   Beschreibung wird als Vorgabe fr den Dateinamen beim Speichern verwendet

v2.7 (10.05.2002):
   Zustzliche Sprache untersttzt: Englisch
   Info-Fenster automatisiert

v2.6 (07.05.2002):
   Dialog "Einstellungen" implementiert
   Prfix kann eingegeben werden und wird automatisch der Beschreibung vorangestellt (s. "Einstellungen")
   Bisherige Prfixe beim Speichern von Listen im Dateinamen entfernt
   Dialogfenstereinstellungen, Pfade und Optionen werden in der Registry gespeichert
   Fehler beim Speichern von Link-Listen behoben (Leere Beschreibung)

v2.5 (03.05.2002):
   Positionen von OK- und Abbrechen-Schaltflche im Link-Listen-Dialog getauscht
   Spiele, Resourcen, ROMs und Samples ohne Namen werden nicht geladen
   Filterfunktion wie bei der .CFG-Datei der GoodTools (z.B. [b*] um Bad Dumps auszufiltern) implementiert
   Verzeichnis-Scanner, um Listen automatisch anhand der Dateien im Verzeichnis zu generieren, implementiert
   ListTool.exe mit UPX v1.20 komprimiert

v2.4 (30.04.2002):
   Fehler beim Laden von RomCenter DATs behoben (Zugriff auf das erste Zeichen in einem leeren String)
   Fehler beim Speichern von ClrMamePro-DATs behoben (Alle Resources wurden in nur einem Block gespeichert)
   Fehler beim Speichern von Link-Listen behoben und Korrekturalghorithmus verbessert
   Konvertieren von GoodTools-Dateien in DATs implementiert (CRC & Gre bleiben leer)
   Verbinden von Clones mit Parents optimiert
   Suchen und Zusammenfassen von doppelten Eintrgen beim Laden
   Mischen-Funktion neugeschrieben (schneller, genauer)
   Entfernen-Funktion neugeschrieben (schneller, genauer)
   Ausgabe alphabetisch sortiert
   Ausgabe von Batch-Dateien, Get- und Link-Listen erweitert

v2.3 (17.04.2002):
   Dateinamefeld vor Vernderung durch den Benutzer geschtzt
   Link-Listen als Ausgabemglichkeit hinzugefgt
   Ladevorgang beschleunigt (besonders bei ClrMamePro-DATs)
   Statusanzeige optimiert (Eigenes Fenster mit Abbruch-Taste)
   Kompletten Quellcode berarbeitet

v2.2 (14.04.2002):
   Fehler beim Laden von ClrMamePro-LOGs behoben
   Fehler bei der automatischen Dateityperkennung behoben
   Mischen von Listen implementiert
   Entfernen durch Vergleich mit anderen Listen implementiert
   Anzeige der Gesamtgre (unkomprimiert) aller ROMs implementiert

v2.1 (11.04.2002):
   Fehler mit Zeichen bei Batch-Dateien behoben (ANSI -> OEM)
   Lade- und Speicherfunktionen optimiert
   Fehler beim Laden einzelner GoodHave/Miss-Listen behoben
   Fehler beim Laden von ClrMamePro-LOGs mit Samples behoben
   Merken des Zielverzeichnisses whrend einer Sitzung (Beim Speichern)
   Verbindung zwischen Parents und Clones wird geprft und ggf. korrigiert

v2.0 (06.04.2002):
   Neuer Programmaufbau
   Komplett neuer Quellcode

vor v2.0 (13.08.2001 - 27.08.2001):
   Programm fr DOS (wird nicht weiterentwickelt)



ENGLISH



What is ListTool?

ListTool is a tool for converting ROM-lists. It is capable of reading the following file types:

   ClrMamePro "*.dat"
   ClrMamePro "*.log"
   RomCenter "*.dat"
   GoodTools "*Have.txt"
   GoodTools "*Miss.txt"
   GoodTools "*Log.txt"
   MESS "*.crc"
   Some executables "*.exe" (
   Folders/Directories

The data can be saved in the following formats:

   ClrMamePro "*.dat"
   RomCenter "*.dat"
   Batch-files "*.bat"
   Get-lists "*.txt"
   Link-lists "*.htm"

Features:

   Load/create lists by dragging the source file or a directory on the
    main window
   Multi file processing
    (Just select the files in the WindowsExplorer and drag them on the
    ListTool window)
   CRC32/MD5 support



 ) mame.exe         mess.exe
    mamepp.exe       sname.exe
    mame32.exe       good*.exe
    pinmamew.exe
    raine32.exe



How to use ListTool

Run the application by double clicking the file "ListTool.exe". The appearing dialog window contains some edit boxes where the header data of the loaded list is shown and can be changed. There are also several buttons which will be explained in the following sections:

[Load]
Clicking on this button brings up a file dialog. The user has to choose a file and confirm with [Open]. After that the data will be transferred to the memory and they will be displayed.
Tip: Instead of using the button [Load] it's possible to drag the file easily from any explorer window on the application.

[Save]
Pressing [Save] will reveal a small menu for choosing the file type. A simple click on the appropriate button takes the user to the file dialog where it's possible to determine the place and name of the destination file. The [Save] button completes the operation.

[Scan]
Use the scan function to choose any folder. It's contents will be scanned for building a new list. It's recommended to add missing header data after scanning.
Tip: Instead of using the button [Scan] it's possible to drag the folder easily from any explorer window on the application.

[Merge]
The button [Merge] lets the user determine another list which will be merged with the memory data. Merging is done in the following way: The names of all games of the new file will be compared to the names of the games in the memory. If no correspondence is found, the new game will be added completely to the memory (all ROMs and samples inclusive). If there was a correspondence, each ROM of the new game will be compared to the ROMs of the found game. This comparison is not done by name but by CRC and size this time. Only unavailable ROMs are added.

[Remove]
The button [Remove] lets the user determine another list which will be compared to the current list. Corresponding games and ROMs will be removed from the current list. It keeps only the part of the original list which is not corresponding to entries found in the new one. If both lists contain information about CRC and size of the ROMs they will be compared by these. In this case the name of the ROMs is ignored.
If one of those lists doesn't contain this information (e.g. GoodMiss.txt) only the name of the ROMs will be compared.

[Filter]
The filter function enables the user to search the names of games and resources or descriptions by special expressions. It is possible to erase the found entries or to keep them and remove all other entries from the list. There is a check box for determine if the search should be case-sensitive. An example would be to remove all "bad dumps" from the list. Frequently used expressions are already available in the combo box. Search strings can contain the wildcard character "?" which stands for one unspecified character or "*" which means any number of unspecified characters.

[Options]
In the "Options" dialog it is possible to enter general data and alter program specific information. The section "General" contains an edit box for defining the name. It will be used to alter the name and the description when loading GoodTool-TXTs and ClrMamePro-LOGs. When saving such a list the name is also placed at the beginning of the filename. It should make it easier to recognize missing DATs between others in ClrMamePro and RomCenter. If those files are sent to someone else the name indicates the origin of the file. At newly created lists the name will be entered into the edit box "Author".
The section "Registry" contains a button for removing all registry entries created by ListTool. If removing ListTool from the system, it is recommended to press this button before deleting the program files. Attention! After removing the registry entries the application will be shut down. Unsaved data will be lost. Scan: The activation of "Include subfolder data" causes the scanner to save also file paths while reading directories. It is also possible to specify if the names of the games and ROMs should be in upper or lower case. "flood protection" is used to prevent the user to be kicked off a channel while sending data to mIRC. It is possible to enter the number of lines which will be sent and the length of the delay (in milliseconds) between the packages.

[About]
The [About] button brings up the version information of the application.

[Exit]
Press [Exit] to close the application.



Command line parameters

ListTool can also be controlled by command line parameters.
If the command line which has been used to run ListTool contains any parameters no dialog will be shown. Only the chosen commands will be executed.

Possible parameters are:

  /l=<filename>   Source file
  /s=<filename>   Destination file (not required)
  /cmdat          Output file will be ClrMamePro DAT
  /rcdat          Output file will be RomCenter DAT
  /bat            Output file will be batch-file
  /get            Output file will be get-list
  


Explanation of the file types

Description of the file types of "ClrMamePro", "RomCenter" and "GoodTools" are found on the corresponding homepages (see section "Notice").

Batch file
Batch files created by ListTool contain commands to create a new directory and copy all files of the list to it. In this way it is very easy to pick out the needed files and e.g. send them using the internet.
While executing the batch file it must be in the same directory as the files to copy.

Get-lists
These are lists of all the games. Every entry consists of the string "get " and the name of the game followed by the string ".zip".
These lists are thought to be used with fserves like they are found in the world of IRC. It makes it easy to copy the contents and paste it into the window of the chosen server. The files will then be transferred if available on the server.

Link-lists
A link-list is a HTML page with a hyperlink for each file. This link can point to a FTP server or a web site. Needed data will be asked for while saving. The created HTML page can be watched with any internet browser.
With this function it is easy to download the files of the list with a download manager from a web site or FTP server.



Notice

There is no warranty that the application is without any errors. The author is not liable for any damage which is caused by using the program. Use ListTool at your OWN RISK!

The current version of the application is freeware and only allowed to be distributed without taking money for it. All rights are reserved by the author.

ClrMamePro is a ROM-manager by Roman Scherzer (http://www.clrmame.com/).

RomCenter is a ROM-manager by Eric Bole-Feysot (http://www.romcenter.com/).

GoodTools are ROM-managers by Cowering (NEWNet #rareroms).

ListTool uses following code:
   zlib library by Jean-loup Gailly & Mark Adler (http://www.gzip.org/zlib/)
   MD5 calculation routines by Langfine Ltd. (http://www.langfine.com/)

UPX is used to compress the execution file.
It is written by Markus Oberhumer and Laszlo Molnar (http://upx.sourceforge.net/).



History

v3.4 (04/20/2003):
   MESS CRC files supported for reading
   GoodTools exe files supported
   Better handling of operations between ROMs with and without file extension
   For the output as ClrMamePro DAT all data is put between quotation marks
   Bug fixed: converting ANSI-string to OEM-string when reading from ZIP file (all characters are correct)
   Bug fixed with recognizing ClrMamePro-LOGs
   "rebuildto" entries in ClrMamePro DATs supported
   Bug fixed: When saving as ClrMamePro DAT CHD images will be saved as "disk" now
   Support for the new GoodLog format ("New:" & "Old:" instead of "N:" & "O:")
   Support for the new GoodHave/Miss format (version at the end of the header)
   Bug fixed: Loading an empty list is no longer prevented (because of extra info)
   Added simple list to output formats (work on a custom editor is in progress)

v3.3 (01/10/2003):
   Sname.exe supported
   Rare bug with loading ClrMamePro DATs fixed
    (Game/ROM name consists of only one word, has no quotation marks, but contains brackets)
   Better compatibility at reading lists (no error when CR is missing before of LF)
   MD5 is read/written when loading/saving ClrMamePro DATs, LOGs or MAME
   Bug with filesize display fixed
   MD5 supported by the scanner
   New remove function (MD5 support complete)
   Number of samples is displayed

v3.2 (01/08/2003):
   Wrong CRCs and sizes are shown in extra information at ClrMame LOGs
   ROMs in ClrMame LOGs with wrong CRCs or size are treated like missing ROMs
   Fixed an error with recognizing ClrMame LOGs
   Fixed an error with empty games (without any ROMs or samples)
   New cleaning function at loading list (eliminating dupe ROMs/samples in the same clone)
   Mess.exe and PinMame.exe supported
   Multifile Merging: select all files in WindowsExplorer and drag them on the ListTool window
   Merging of lists revised
   Filesize display not restricted to 4.2 GB anymore

v3.1 (08/27/2002):
   Problem with file extensions solved: keep extension if directory; truncate it if file
   New option for scanning: "Don't cut file extensions"
    (if files without extension but with a "point" in the name are scanned)
   When loading a ClrMame LOG the category becomes "FIXDATFILE"
   Empty lists can't be saved anymore
   Multi file processing: select all files in WindowsExplorer and drag them on the ListTool window
   GoodTools log-files supported

v3.0 (08/23/2002):
   Bug fixed: Subfolders will now keep their extensions when scanned
   New options for the scanner: Case of the game and ROM names
   Scan options are asked just before scanning
   Changing the author adjusts simutaniously the "name" and the "description" if needed
   Loading an empty list is recognized
   Extra information/statistics altered
   Send to mIRC with new design
   Filter function rewritten (wildcards '*'/'?' and choice between "name" and "description" are possible)
   English texts in created .bat files
   Raine32.exe supported

v2.9 (08/09/2002):
   Bug fixed: name was not written in the author box at scanning
   Bug fixed: horizontal scrolling at the combo box at the link list dialog activated (not fixed length anymore)
   Extra info and send to mIRC implemented
   Bug fixed: ClrMamePro miss.txt files are recognized
   Bug with recognizing ClrMamePro-LOGs fixed
   Bug fixed: Crash while using remove function
   Bug fixed: Saving lists with a description which contains invalid characters for filenames
   's becomes ' if author name ends on s
   New options: include subfolder data and flood protection for mIRC

v2.8 (05/18/2002):
   Decimal seperator is shown in the current user language style
   Date in the About dialog is shown in the current user language style
   English MFC-messages in the external english language file
   Loading foreign languages optimized
   Prefix substituded by name (GoodHave und GoodMiss are distinguished, author will be inserted if needed)
   The Name is placed also at the beginning of the list's name (like it is done with the description)
   Combo box at saving as link list remembers the last 20 entries
   Files created by "mame.exe -listinfo" can be loaded without errors (transforming escape sequences)
   "mame.exe" can be loaded directly (also by drag & drop)
   ClrMamePro-DAT parser improved
   Filename extensions aren't cut anymore after scanning directories
   Checking header data at saving
   Description is used as filename at saving dialog

v2.7 (05/10/2002):
   First version supporting English