Archives

Diffoniq can open archives directly, without the help of an external archive utility. An archive behaves like a folder: it can be compared against a directory, against another archive, or appear inside a recursive directory comparison. The following archive types are recognized by their file extension:

ZIP .zip .jar
7-Zip .7z
RAR .rar
tar .tar, compressed: .tar.gz/.tgz, .tar.bz2/.tbz/.tbz2, .tar.xz/.txz, .tar.zst/.tzst
Windows .cab .iso

Renamed archives. A file whose extension is not in the table is still recognized as an archive when its content identifies it as one — for example a ZIP renamed to data.bak. Diffoniq checks the file’s first bytes for the known archive signatures and, on a match, treats the file like an archive of that type. Office and OpenDocument files (.docx, .xlsx, .odt, …), which are technically ZIP containers, are deliberately excluded and keep behaving as plain files.

File names in older ZIP files. A ZIP file either marks its file names as Unicode or stores them in the character set of the computer it was packed on. Diffoniq reads unmarked names in the character set of your Windows: names from a Chinese, Japanese, Korean, Arabic or Hebrew Windows read correctly on a Windows of the same language, and umlauts in names from older packers on a Western Windows. With the Windows option “Beta: Use Unicode UTF-8 for worldwide language support” turned on, the character set is the one of the language Windows uses for non-Unicode programs (see Languages and Character Sets).

Nested archives. An archive stored inside another archive (for example a .zip inside a .zip, or a .tar.gz inside a .zip) behaves like a subfolder: open it the same way you open a folder — double-click its row or press Enter — and Diffoniq lists its contents so you can compare them too. This works to any depth and across formats; the header shows the full path, such as outer.zip\inner.zip\readme.txt. The inner archive is expanded only when you open it, so browsing a large archive stays fast. To open a file or an inner archive, Diffoniq unpacks it into a temporary file beside the archive; the progress bar shows how far that is, and Cancel stops it. Unpacking also stops, with a message, when less than 512 MB would be left on the drive, or when an entry holds more data than the archive declares for it.

A folder inside an archive as one side. Many release archives wrap everything in one extra folder: release.zip holds release-2.4.0\bin\… while the build folder holds bin\… directly. Name that folder as part of the path, and the comparison starts there: release.zip\release-2.4.0 against build pairs bin\a.exe with bin\a.exe, the same way two folders pair. Both \ and / work as separator. The path may continue through nested archives, as in outer.zip\inner.zip\sub; the inner archive is expanded beside the outer one and removed again when the comparison closes. Such a path works wherever a path goes: on the command line, in the selection dialog and with /report; the header, the report and its JSON show the full path. A folder the archive does not hold is an error that names it (“no folder "release-2.5.0" in the archive”; exit code 3 with /report), never an empty side. Upper and lower case do not matter, as in Explorer: Release-2.4.0 finds a folder stored as release-2.4.0, unless the archive holds both spellings. A real file or folder of that name always wins: the path is only read into the archive when it does not exist on disk.

A damaged or truncated archive is not rejected outright: Diffoniq falls back to a forward-only scan and still lists every entry whose local data is intact. A file of 0 bytes is no archive at all, whatever its extension (often an interrupted download or copy): the comparison stops with “the file is empty (0 bytes) - not an archive” instead of showing every file of the other side as missing. The same goes for a compressed file with nothing inside (a .tgz of an empty stream): “the compressed file holds no data - not an archive”.

Encrypted archives. Diffoniq cannot open password-protected archives (ZIP with AES or ZipCrypto, 7-Zip with encrypted content or encrypted file names). The comparison stops with the message “the archive is encrypted (password-protected)” and names the archive; with /report it ends with exit code 3. It never shows such an archive as empty. Extract it with the program that created it and compare the folder.

Content check. When an archive is compared against a folder (or against another archive), files of the same size are checked by content, just like in a folder comparison: Diffoniq reads each archive entry once while listing the archive, so only the folder side is read afterwards. A pair whose content matches is shown as identical, a pair that differs is marked as different — with /report --content neither counts as unverified.

Timestamp note: many archive formats store file times with a 2-second resolution (a DOS/ZIP heritage), so an archive entry’s time can differ from the on-disk file’s time by a second. When comparing an archive against a directory, enable Ignore Time to avoid such spurious time differences — content comparison is not affected.