Documentation

FILEID media: previews an archive carries for itself

Updated 2026-10-08

All documentation

FILE_ID media: previews an archive carries for itself

Version 1, 2026-10-08. From the Canectic BBS project, for any BBS or file network software that wants to adopt it.

FILE_ID.DIZ became the standard way for an archive to describe itself: the uploader writes the description once, and every board that carries the file shows it. This does the same for pictures and sound. An archive can carry its own thumbnail, more pictures, a piece of ANSI art and a short audio sample, so a board shows what the author chose, instead of guessing from the archive's contents or showing nothing.

The files

File What it is
FILE_ID.PNG, FILE_ID.JPG, FILE_ID.GIF or FILE_ID.WEBP The archive's picture: the thumbnail a board shows first.
FILE_ID1 to FILE_ID9, same extensions More pictures, shown in that order after the first.
FILE_ID.ANS ANSI art for the archive, as art groups already use it.
FILE_ID.MP3 or FILE_ID.OGG A short audio sample, for music and sound packs.

They sit at the root of the archive, next to FILE_ID.DIZ, and names are matched without regard to case. Each is optional, and none replaces FILE_ID.DIZ, which stays the description.

The names are 8.3, so DOS-era tools handle them, and they sort beside FILE_ID.DIZ in an archive listing. Software that does not know the convention just sees a few more files in the archive. The extension says the format, so a board does not have to guess it, though it must still check (see below).

Formats and sizes

These are suggestions, not limits: a reader sets its own. Keeping to them makes a file welcome on any board, and keeps file echoes light.

  • Pictures: PNG, JPEG, GIF (the first frame is used) or WebP. 640×480 or smaller, and under 128 KB each.
  • FILE_ID.ANS: CP437 ANSI art, with a SAUCE record when it is wider than 80 columns or uses iCE colours. The top of a tall piece is what a board shows, so put the part that matters there.
  • Audio sample: MP3 or Ogg Vorbis, 30 seconds or less, under 512 KB.
  • SVG is not part of the convention. It can carry script, so readers should not show it.

For software that shows them

  • Prefer an archive's own FILE_ID media over anything worked out from its contents. Show FILE_ID, then FILE_ID1 to FILE_ID9 in order, then FILE_ID.ANS.
  • Decide a picture's or sample's format by its contents, not its name, and skip anything that is not what it claims.
  • Re-encode pictures into your own thumbnails rather than serving them as they came out of the archive.
  • Draw FILE_ID.ANS the way an art viewer would, honouring SAUCE's width and iCE flag.
  • Bound the work: a size limit for the archive you open, for each entry you read, and for the art you draw.
  • Do not count a preview as a download.

For people making archives

Add the files to the root of the archive alongside FILE_ID.DIZ. A thumbnail is the most useful one: a picture of what is inside, a title screen, or the art itself.

In Canectic

Canectic shows these on its file info pages: the info pop-up and each file's page. When an archive has none, Canectic picks the first few pictures, or the first piece of ANSI art, of an archive that is mostly pictures or art. A picture file, an ANSI or ASCII art file, and an MP3's embedded cover get previews of their own. The file_previews setting turns all of this off, and docs/reference/FILES_ARCHITECTURE.md ("Previews") has the details.