FILE ID.DIZ


FILE_ID.DIZ is a plain text file containing a brief content
description of the archive in which it is included.
It was originally used in archives distributed through bulletin board systems, and still in the warez scene.
stands for "file identification". stands for Description In Zipfile.
Traditionally, a FILE_ID.DIZ should be "up to 10 lines of text, each line being no more than 45 characters long." according to the specification v1.9.
The concept of DIZ files was to allow a concise description of uploaded files to be automatically applied. Advertisements and "high ASCII" artwork were specifically prohibited.

History

Bulletin boards commonly accept uploaded files from their users. The BBS software would prompt the user to supply a description for the uploaded file, but these descriptions were often less than useful. BBS system operators spent many hours going over the upload descriptions correcting and editing the descriptions. The inclusion in archives was designed to address this problem.
Clark Development and the Association of Shareware Professionals supported the idea of this becoming a standard for file descriptions. Clark rewrote the PCBDescribe program and included it with their PCBoard BBS software. The ASP urged their members to use this description file format in their distributions. Michael Leavitt, an employee of Clark Development, released the file specification and his PCBDescribe program source code to the public domain and urged other BBS software companies to support the DIZ file.
SysOps could add a common third-party script written in PPL, called "DIZ/2-PCB" that would process, rewrite, verify, and format DIZ files from archives as they were uploaded to a BBS. The software would extract the archive, examine the contents, compile a report, import the DIZ description file and then format it according to your liking. During this time, it was usual practice to add additional lines to the description, such as ads exclaiming the source of the uploaded BBS.
Even since the decline of the dial-up bulletin board system, FILE_ID.DIZ files are still utilized by the warez scene in their releases of unlicensed software. They are commonly bundled as part of the complete packaging by self-described pirate groups, and indicate the number of disks, and other basic information. Along with the NFO file, it is essential to the release. Especially in terms of unlicensed software, it was common for each file in a sequential compressed archive, to contain this file. This probably contributed to its extended popularity after the decline of the bulletin board system in the late 1990s and early 2000s until now, since even casual consumers of unlicensed software would have stumbled upon it due to its abundance.

Formal structure

While real-world use among BBSs varied, with the NPD world and even different BBS brands coming up with expanded versions, the official format is:
Plain, 7 bit ASCII text, each line no more than 45 characters wide.
  1. Program/file name: Ideally, all uppercase, and followed by one space. Carriage returns are ignored in this file
  2. Version number: in the format v1.123, followed by a space
  3. ASP number: only if an actual ASP member, otherwise ignored
  4. Description separator: a single short hyphen "-"
  5. Description: The description of the file. The first two lines should be the short summary, as older boards cut off the rest. Anything beyond that should be extended description, for up to eight lines, the official cutoff size. Additional text could be included beyond that but might not be included by the board.
Many archives would stick strictly to the 45 character plain ascii format for the first 8 lines, then contain an appended 80 character wide 8 bit ASCII or ANSI graphic page with better-formatted documentation after that.