Skip to content

Split

Jump to bottom
Matt Nadareski edited this page Sep 19, 2025 · 4 revisions

Specialized DAT Splitting

Flags: -sp, --split

This feature allows the user to split input DATs by a number of different possible criteria. See the individual input information for details. More than one split type is allowed at a time.

Options

Flags Short Description Long Description
-ot=, --output-type= Output DATs to a specified format Add outputting the created DAT to known format. Multiple instances of this flag are allowed. See DatFile Formats for more details about supported values.
-dpc, --deprecated Output game instead of machine Requires --output-type=xml. By default, Logiqx XML DATs output with the more modern machine tag for each set. This flag allows users to output the older game tag instead, for compatibility reasons.
-out=, --output-dir= Set output directory This sets an output folder to be used when the files are created. If a path is not defined, the runtime directory is used instead.
-ip, --inplace Write to the input directories, where possible By default, files are written to the runtime directory (or the output directory, if set). This flag enables users to write out to the directory that the DATs originated from.
-es, --extension Split DAT(s) by two file extensions For a DAT, or set of DATs, allow for splitting based on a list of input extensions. This can allow for combined DAT files, such as those combining two separate systems, to be split. Files with any extensions not listed in the input lists will be included in both outputted DAT files.
-exta=, --exta= Set extension to be included in first DAT Requires -es, --extension. Set the extension to be used to populate the first DAT. Multiple instances of this flag are allowed.
-extb=, --extb= Set extension to be included in second DAT Requires -es, --extension. Set the extension to be used to populate the second DAT. Multiple instances of this flag are allowed.
-hs, --hash Split DAT(s) or folder by best-available hashes For a DAT, or set of DATs, allow for splitting based on the best available hash for each file within. The order of preference for the outputted DATs is as follows: Nodump, SHA-512, SHA-384, SHA-256, SHA-1, MD5, CRC (or worse).
-ls, --level Split a SuperDAT or folder by lowest available level For a DAT, or set of DATs, allow for splitting based on the lowest available level of game name. That is, if a game name is top/mid/last, then it will create an output DAT for the parent directory "mid" in a folder called "top" with a game called "last". Currently is not fully implemented.
-s, --short Use short output names Requires -ls, --level. Instead of using ClrMamePro-style long names for DATs, use just the name of the folder as the name of the DAT. This can be used in conjunction with --base to output in the format of "Original Name (Name)" instead.
-ba, --base Use source DAT as base name for outputs Requires -ls, --level. If splitting an entire folder of DATs, some output files may be normally overwritten since the names would be the same. With this flag, the original DAT name is used in the output name, in the format of "Original Name(Dir - Name)". This can be used in conjunction with --short to output in the format of "Original Name (Name)" instead.
-szs, --size Split DAT(s) or folder by file sizes For a DAT, or set of DATs, allow for splitting based on the sizes of the files, specifically if the type is a Rom (most item types don't have sizes).
-rad=, --radix= Requires -szs, --size. Set the midpoint to split at Set the size at which all roms less than the size are put in the first DAT, and everything greater than or equal goes in the second.
-tis, --total-size Split DAT(s) or folder by total game sizes For a DAT, or set of DATs, allow for splitting based on the combined sizes of the games, splitting into individual chunks.
-cs=, --chunk-size= Requires -tis, --total-size. Set the total game size to cut off at for each chunked DAT. It is recommended to use a sufficiently large size such as 1GB or else you may run into issues, especially if a single game could be larger than the size provided.
-ts, --type Split DAT(s) or folder by file types (rom/disk) For a DAT, or set of DATs, allow for splitting based on the types of the files, specifically if the type is a rom or a disk.

Examples

There are currently no examples

Clone this wiki locally