Eventhough this tool should still work, I haven't have the need to use it for quite some time. Furthermore I didn't have the time recently to integrate security fixes, or update dependencies. Therefore use it at your own risk. Of course feel free to update the dependencies yourself and create PR. That would be highly appreciated. I might update this tool and its dependencies once I need it again.

The TOSEC Tool is a commandline utility (cli), which allows to perform different tasks utilizing the TOSEC database (aka. any TOSEC dataset).

TOSEC Tool is written in TypeScript and ran using nodejs. Therefore an installed node executable is required to run the this project.

The latest version of the TOSEC Tool may be installed from the npm registry:

$ npm install -g tosec-tool

This command will automatically download the tool and all its dependencies. Furthermore it will link the needed executable files into your PATH.

After installation the TOSEC Tool is available as tosec inside your commandline interpreter:

$ tosec --help

TOSEC Tool (c) Jakob Westhoff <[email protected]>

  Tooling for usage with the TOSEC datasets and corresponding files.

  Usage
    $ tosec <command> <options...>

   Options:
     --help: Display this help text

The tool supports specific sub commands to do your bidding. Each command has its own help information readily available:

tosec sort --help

TOSEC Tool (c) Jakob Westhoff <[email protected]>

  Tooling for usage with the TOSEC datasets and corresponding files.

  Usage
    $ tosec sort -t <dataset-dir> -o <output-dir> [-s <storage-file>] <input-dirs...>

  ...

Currently the TOSEC Tool only has one command: sort.

This command will take a TOSEC dataset, as well as some directories with stored ROM files in it and sorts those files according to the TOSEC database. Thereby renaming and copying the files to a properly structured output directory. Zipped ROM files are transparently decompressed for analysing.

See tosec sort --help for more information.