Various EZ2DJ/EZ2AC Tools

ezinfo

Displays various information about (decoded) .ez files. File format versions v4 to v8 are supported. I have not been able to find any files that are v3 or earlier.

Starting with EZ2DJ 7th Trax v1.5, .ez files have been encoded in various ways. This program does not handle decoding, since each game handles it differently.

If you are going to use .ez format v8 data with this program, it is recommended to run it through ezunfn first.

Usage: ezinfo [file.ez]

Displays the following information:

• filesize
• .ez format version number
• internal track name (if any)
• ticks per measure
• initial and "other" BPM
• track count
• total ticks
• per-track data, including notes (handles commands 1-4)

ezins

Utility related to (decoded) .ezi files. Both old and new versions are supported.

Usage:

• ezins --info file.ezi to get information about an .ezi file.
• ezins --old file.ezi to convert a new format .ezi to the old format.
• ezins --new file.ezi to convert an old format .ezi to the new format.

The --info option displays:

• format type ("new" or "old)
• each entry, including equivalent keysound index (for old files) or key/octave pair (for new files; 0-255 only)
• notices if there are too many keysounds defined (256 for old version, 2048 for new version)

When converting between versions, the input file is overwritten, so be careful.

ezabm

Utility related to .abm and .bmp files.

Usage:

• ezabm --info filename.abm to get information about an .abm file.
• ezabm --tobmp version filename.abm [outfile.bmp] to convert .abm to .bmp
• ezabm --toabm version filename.bmp [outfile.abm] to convert .bmp to .abm

For --tobmp and --toabm, version is one of the following:

• old – 2nd Trax through Endless Circulation
• ev – Evolve
• nt – Night Traveler
• tt – Time Traveler
• fn – Final
• fnex – Final EX
• auto – attempt to auto-detect format (--tobmp only)

If the output filename is omitted while using one of the conversion options, the program will generate a filename based on the input filename.

abm2bmp

Cut down version of ezabm that only performs .abm to .bmp conversion.

Usage:

• abm2bmp filename.abm [outfile.bmp]

This program performs the same action as ezabm --tobmp auto, but unlike ezabm, you can drag and drop a file onto the executable.

ezwssf

Utility related to .ezw/.ssf and .wav files.

Usage:

• ezwssf --info filename.ezw to get information about an .ezw or .ssf file.
• ezwssf --towav filename.ezw [outfile.wav] to convert .ezw/.ssf to .wav
• ezwssf --toezw filename.wav [outfile.ezw] to convert .wav to .ezw/.ssf

If the output filename is omitted while using one of the conversion options, the program will generate a filename based on the input filename.

ezdec_715, ezenc_715

Utilities related to encoding and decoding EZ2DJ 7th Trax v1.5 files.

ezdec_715 decodes files, and ezenc_715 encodes them.

Usage:

• ezdec_715 [file] to decode
• ezenc_715 [file] to encode

These tools overwrite the input file with the modified version, so be careful.

ezdec_720, ezenc_720

Utilities related to encoding and decoding EZ2DJ 7th Trax v2.0 .ez files.

Only ezdec_720 works properly at the moment; there are some slight errors with ezenc_720.

Usage:

• ezdec_720 [file.ez] to decode
• ezenc_720 [file.ez] to encode

These tools overwrite the input file with the modified version, so be careful.

ezunfn, ezrefn

Utilities related to the anti-tampering pattern from (decoded) v8 .ez files.

ezunfn removes the anti-tampering pattern, while ezrefn adds it.

Usage:

• ezunfn [file.ez] to decode
• ezrefn [file.ez] to encode

These tools overwrite the input file with the modified version, so be careful.

ezunfn is essentially a v8 -> v7 downgrade tool, though it does not modify the format version byte.

ezrefn does upgrade v7 format files to v8, changing the format version byte.

Notice

I have no interest in producing tools for EZ2ON Reboot:R. If these tools happen to work with its data, then it's a happy accident that's completely unintended.