Refactoring - Moved some functions to new fmtutil-iff.c file

[deark.git] / formats.txt

Deark -- Information about supported formats


=== Image format modules ===

(Images that are not "extracted" will be converted to PNG, except as noted.)

* Alias PIX, a.k.a. Vivid ray tracer bitmap (module="alias_pix")
  - Truecolor only. Grayscale not supported.

* Alpha Microsystems BMP (module="alphabmp") (experimental)

* Amiga Workbench Icon (module="amigaicon")
  - Original format: Mostly supported, but the format is not portable, and
    there is not just one correct way to render the images.
  - NewIcons: Fully supported.
  - GlowIcons / OS3.5: Compressed images are supported. Uncompressed images are
    not.

* AMOS Picture Bank (module="abk")

* AMOS Sprite Bank (AmSp) / AMOS Icon Bank (AmIc) (module="abk")

* ANI (Windows Animated Cursor) (part of module "riff")
  - Extract individual CUR and ICO files.

* ANIM (Amiga IFF-ANIM) (module="anim")
  - Supports most common formats.
  - Extract the individual frames.
  Options
   -opt anim:includedups - Do not suppress duplicate frames.

* Animatic Film (module="animatic")
  - Extract the individual frames.
  Options
   -opt atari:palbits=<n> (refer to readme.md)

* ANSI Art (module="ansiart")
  - Autodetection usually works, but not always. You may have to use
     "-m ansiart" or "-m ansi".
  - Supports only the most common escape codes, which is usually good enough.
  - Some features depend on the output format. "Blink" is not supported with
     image output, for example.
  Options
   -opt char:output=image - Output to a bitmap instead of HTML
   -opt char:width=<n> - Number of characters per row
   -opt ansiart:no24bitcolor - Disable support for 24-bit color definitions
   -opt ansiart:noblink - Disable blinking characters, enabling high-intensity
     background colors. This is usually unnecessary, as well-formed files will
     explicitly disable blink.
   -opt ansiart:vt100 - Use VT100 mode

* Apple volume label image (module="applevol")

* ART - PFS: 1st Publisher clip art (module="fp_art")

* ArtWorx Data Format (ADF) (module="artworx_adf")

* AutoCAD Slide Library (.slb) (module="autocad_slb")
  - Extracts the component AutoCAD Slide (.sld) files.

* Award BIOS logo (EPA, AWBM) (module="awbm")
  - Supports version 1
  - Supports 4-bit and 8-bit version 2
  Options
   -opt awbm:rgb=0 - (v2) Assume BGR sample order (default for 4-bit)
   -opt awbm:rgb=1 - (v2) Assume RGB sample order (default for 8-bit)

* Binary Text (.BIN character graphics format) (module="bintext")
  - Must use "-m bintext", unless the file has a SAUCE record.
  Options
   -opt char:width=<n> - Number of characters per row

* BLD (MegaPaint BLD) (module="bld")

* BMI (Zoner bitmap) (module="bmi") (experimental)

* BMP (Windows bitmap) (module="bmp")

* Bob ray tracer bitmap (module="bob")

* BPG (module="bpg") (experimental)
  - Extract Exif, XMP, ICC Profiles, thumbnails

* BSAVE/BLOAD image (module="bsave")
  Support (some) PC-style BSAVE files.
  Options
   -file2 <file.pal> - Use this palette file (BSAVE format)
   -opt palfile=<file.pal> - Use this palette file (BSAVE format)
   -opt bsave:width=<n>
   -opt bsave:height=<n>
   -opt bsave:fmt=char  - Character graphics
   -opt bsave:fmt=cga2  - 640x200 2-color
   -opt bsave:fmt=cga4  - 320x200 4-color
   -opt bsave:fmt=cga16 - Very low (160x100) resolution
   -opt bsave:fmt=mcga  - 320x200 256-color
   -opt bsave:fmt=wh2   - 2-color, header includes width & height
   -opt bsave:fmt=wh4   - 4 color, header includes width & height
   -opt bsave:fmt=wh16  - 16 color, header includes width & height, inter-row
     interlaced
   -opt bsave:fmt=b265  - Special
   -opt bsave:fmt=2col  - 2-color noninterlaced (experimental)
   -opt bsave:fmt=4col  - 4-color noninterlaced (experimental)

* Calamus Raster Graphic (module="crg") (experimental)

* Cardfile (module="cardfile")
  - Supports MGC and RRG formats.
  - Extracts bitmaps.
  - Extracts text (use -a).
  - Extracts OLE objects.
  Options
   -opt ole1:extractall - Extract unidentified OLE objects

* COKE (Atari Falcon) (*.tg1) (module="coke")

* Compface intermediate format (module="compfacei")
  This is an obscure text-based format related to X-Face, used by the Compface
  software.
  - Cannot be autodetected. You must use "-m compfacei".

* Corel CCX (module="corel_ccx")
  - Decompresses and converts to CMX format.

* CorelDRAW CDR, old "WL" format (module="cdr_wl") (experimental)
  - Extracts preview image.

* Corel Gallery BMF (module="corel_bmf") (experimental)
  - Extracts preview image.

* CorelMOSAIC CLB (module="corel_clb") (experimental)
  A thumbnail image library, companion to a CLH file.

* DIB (module="dib")
  - Adds a BMP file header to a raw Windows DIB file.

* DCX (module="dcx")
  Multi-image PCX format.
  - Extracts individual PCX files.

* DEGAS and DEGAS Elite (module="degas")
  Options
   -opt atari:palbits=<n> (refer to readme.md)
   -opt atari:respectpal - Don't ignore a seemingly bad 2-color palette

* DeskMate Paint .PNT (module="deskmate_pnt")

* DL animation (DL MAKER) (module="dlmaker")
  - Extracts all images and audio clips, in the order they appear in the file.
  - File extension must be ".dl".

* Doodle (Atari) (module="doodle")
  - Supports high resolution (640x400) only

* Dr. Halo .CUT (module="drhalocut")
  Options
   -file2 <file.pal> - Read the palette from this file.

* EggPaint (*.trp) (module="eggpaint")

* Enhanced Windows Metafile (module=emf)
  - Extract BMP and other images from some records.

* EPOC MBM/Sketch/AIF (module="epocimage")
  - Supports most image types
  - Supports most compression schemes

* EPS (Encapsulated PostScript) (module="eps")
  - Extract EPS, TIFF, and WMF from "EPS DOS Binary" format.
  - Supports preview images in EPSI format (1-, 2-, 4-, 8-bit grayscale)

* Falcon True Color (module="ftc")

* farbfeld (module="farbfeld")

* FLI/FLC (Autodesk Animator) (module="fli")
  - Extract the (non-repeated) frames.

* GEM VDI Bit Image (GEM Raster) (module="gemras")
  - Supports original bilevel format
  - Supports paletted XIMG format
  - Supports some non-XIMG 16-color images
  Options
   -opt atari:palbits=<n> (refer to readme.md)

* GIF (module="gif")
  - Extract the image, or every frame from an animated or mult-image GIF.
  - Plain text extensions are supported.
  - Extract comments (use -a).
  Options
   -opt gif:raw - Extract the individual component images, instead of rendering
     the frame in full. Plain text extensions might be extracted as text files,
     instead of images of text.
   -opt gif:dumpplaintext - Extract plain text extensions to text files (in
     addition to rendering them to the image).
   -opt gif:dumpscreen - Save a copy of the "screen" after the last image in
     the file has been disposed of. Incompatible with gif:raw.

* GodPaint (Atari Falcon) (module="godpaint")

* Graphic Workshop thumbnail (.thn) (module="gws_thn")

* GRASP GL animation (module="graspgl")
  - Extracts all files.

* GROB (HP calculator) (module="grob")
  - Supports binary and text encodings.
  - Some text GROB files can't be autodetected, and need "-m grob".
  Options
   -opt grob:planes=<n> - Treat image as grayscale. <n> should usually be 2.
   -opt grob:planeorder=l - For grayscale, assume the least-significant
     bitplane comes first.

* Hemera Photo-Object image (module="hpi")
  - Extracts the color components to a JPEG file, and the alpha component (if
   present) to a PNG file.

* HP 100LX / HP 200LX .ICN icon format (module="hpicn")

* HR (TRS-80 High Resolution graphics file) (module="hr")

* HS2 (module="hs2")
  Obscure format associated with a program called "POSTERING"

* HSI Raw (module="hsiraw")

* icns (Apple Icon) (module="icns")
  - Supports uncompressed 1-, 4-, and 8-bit images (with 1-bit mask).
  - Supports RLE-compressed 24-bit images (with 8-bit mask).
  - Extract embedded JP2 and PNG files.

* ICO/CUR (Windows icon/cursor) (module="ico")
  - Supports most but not all formats.
  - PNG-formatted icons will be extracted as-is, not decoded.
  - Extract images of the (otherwise unused) masks for 32-bit images (use -a).

* ILBM and related IFF-based images (module="ilbm")
  - Supports ILBM, ACBM, PBM
  - Supports 1-8 bit paletted, 24-bit truecolor
  - Supports HAM6, HAM8, Halfbrite
  - Supports color-keyed and bitmask transparency
  - Extract thumbnails from TINY chunks
  - Extract text from ANNO chunks (use -a)
  Options
   -opt ilbm:notrans - Disable support for transparency
   -opt ilbm:fixpal=<0|1> - Don't/Do try to correct palettes that seem to have
     fewer than 8 bits of precision.

* IndyPaint (*.tru) (module="indypaint")

* Inset PIX (module="insetpix") (experimental)
  - Bitmap images only. Character graphics files are not supported.

* InShape IIM (module="iim")

* Jovian Logic VI bitmap (module="jovianvi") (experimental)

* JPEG and JPEG-LS (module="jpeg")
  - Extract ICC profiles.
  - Extract JFXX JPEG-formatted thumbnails (rare).
  - Extract JFIF uncompressed thumbnails (rare).
  - Extract XMP data, including "extended XMP".
  - Extract JPEG-HDR residual images.
  - Process Exif data (or extract it: use -a)
  - Process Photoshop-related data.
  - Extract Multi-Picture Format (MPF/MPO) thumbnails and other images.
  - Extract comments (use -a). Comment bytes are extracted as-is, or
     interpreted based on the "-inenc" option.
  - Extract Exif FPXR streams (use -a).

* JPEG 2000 (module="jpeg2000")
  - Extract JPEG 2000 codestream from JP2/JPX/JPM formats.
  - Extract XML data.
  - Extract GeoTIFF data.
  - Extract XMP data.
  - Extract Exif data (use -a) (nonstandard; partial support)
  - Process Photoshop-related data.

* JPEG 2000 codestream (module="j2c")
  - Extract comments (use -a).

* JPEG XR (HD Photo) (part of module "tiff")
  - Minimal support.

* LSS16 (SYSLINUX image) (module="lss16")

* Lumena CEL (module="lumena_cel")
  - Single-image files only

* MacPaint (module="macpaint")
  - Can also decode brush patterns (use -a)
  Options
   -opt macpaint:macbinary=<0|1>

* Magic Desk icon (module="mdesk_icn")

* MAKIchan graphics (module="makichan")
  - Supports most 16- and 256-color .MAG images
  - Supports most 16-color .MKI images
  - Does not support .MAX

* MegaPaint Symbol Library (.lib) (module="megapaint_lib") (experimental)

* MegaPaint Patterns (.pat) (module="megapaint_pat") (experimental)

* MRW (Minolta RAW) (module="mrw")
  - Process Exif data (or extract it: use -a)

* MSP (Microsoft Paint graphics) (module="msp")
  - Version 1 and 2

* MS Word for DOS Screen Capture (module="mswordscr")
  Supports the same options as the pcx module.

* NEOchrome (.NEO) (module="neochrome")
  Options
   -opt atari:palbits=<n> (refer to readme.md)

* NEOchrome Animation (module="neochrome_ani") (experimental)

* New Print Shop .POG format (module="newprintshop")
  Options
   -file2 <file.pnm> - Use this "name" file
   -opt namefile=<file.pnm> - Use this "name" file

* NIE/NII/NIA (module="nie") (experimental)
  The "Naive Image Formats" associated with the Wuffs project.

* NGG (Nokia Group Graphic) (module="ngg")

* NLM (Nokia Logo Manager bitmap) (module="nlm")

* NOL (Nokia Operator Logo) (module="nol")

* NPM (Nokia Picture Message) (module="npm")

* NSL (Nokia Startup Logo) (module="nsl")

* OLPC .565 firmware icon (module="olpc565")

* OS/2 Icon, Pointer, Bitmap Array formats (module="os2bmp")
  - Converts icons & pointers to individual PNG files.
  - Icon, pointer, and BMP image files are extracted from Bitmap Array files.
    Reprocess icon and pointer files to convert to PNG.

* PaintShop Pro Browser Cache (module="jbf")
  - Format v1.x: BMP files are reconstructed and extracted.
  - Format v2.x: JPEG files are extracted.

* Palm BitmapType (module="palmbitmap")
  - Cannot easily be autodetected. You must use "-m palmbitmap", except in most
    cases when the file extension is ".palm".
  - May be found inside some Palm files. See also the notes for the "Palm PRC"
    and "Palm PDB/PQA" modules.
  Options
   -opt palm:le - Assume little-endian byte order

* Palm Database (PDB) ImageViewer/FireViewer (part of module "palmdb")

* PCPaint / Pictor (module="pcpaint")
  - Supports PIC and CLP formats. Some files are not portable, because they use
    a nonstandard palette that is not contained in the file.
  - Supports most images with 8 or fewer bits/pixel.
  - Supports character graphics (experimental).
  Options
   -opt pcpaint:fmt=pic
   -opt pcpaint:fmt=clp
   -file2 <file.pic> - PIC file to read the palette from
   -opt palfile=<file.pic> - PIC file to read the palette from

* PCX (module="pcx")
  - Supports most of the common varieties of PCX.
  Options
   -opt pcx:pal=<0|1> - The predefined palette to use, if there is no palette
     in the file. Default is 0.
   -opt pcx:resmode=<ignore|dpi|screen|auto> - How to interpret the
     "resolution" field. "screen" means as the target screen mode's pixel
     dimensions (assumes 4:3 screen). The default is "auto", which means to
     guess.
   -file2 <file.p13> - Read the palette from a separate file. Each entry is 3
     bytes (R,G,B); samples range from 0-63.

* PGC (Portfolio graphics compressed) (module="pgc")

* PGF (Portfolio graphics) (module="pf_pgf")

* PGX (Portfolio graphics animation) (module="pgx")
  - Extract embedded PGC images.

* PI4 (Atari Falcon 320x240) (module="fpaint_pi4")

* PI7 (Atari Falcon 640x480) (module="atari_pi7")

* PI9 (Atari Falcon 320x200) (module="fpaint_pi9")

* PICT (Macintosh image) (module="pict")
  - Extract bitmap images.

* PM (module="pm_xv") (experimental/incomplete)
  This is an obscure format supported by XV and XnView.
  - Supports 24-bit truecolor, and 8-bit grayscale

* PNG / MNG / JNG (module="png")
  - Extract XMP data.
  - Extract ICC profiles.
  - Extract or process various other metadata formats.
  - Extract frame images (may be image fragments) from APNG files.
  Options
   -opt png:extractapng=0 - Do not extract APNG frames

* PNM/PBM/PGM/PPM/PAM (module="pnm")

* PrintMaster .SHP format (module="printmaster")
  Options
   -file2 <file.sdr> - Use this "name" file
   -opt namefile=<file.sdr> - Use this "name" file

* PrintPartner .GPH (module="pp_gph")

* Print Shop .DAT format (module="printshop")
  - Not all files can be autodetected. You may need "-m printshop".
  Options
   -file2 <file.sdr> - Use this "name" file
   -opt namefile=<file.nam> - Use this "name" file

* Prism Paint (module="prismpaint")
  - Supports 1-, 2-, 4-, 8-, and 16-bits per pixel

* PSD / PSB (Photoshop) (module="psd")
  - Basic support for RGB/grayscale/paletted 8/16-bit images
  - Extract JPEG thumbnails. Some thumbnail images have the red and blue
    channels swapped -- Deark warns about this, but does not correct it.
  - Extract XMP data.
  - Extract ICC profiles.
  - Extract linked layer image data (could be PNG/JPG/PSD/etc. format).
  - Process Exif data (or extract it: use -a)
  - Extract IPTC-IIM data (use -a).
  - Extract "text engine data" (use -a)

* Psion PIC (module="psionpic")
  A Psion PIC file contains one or more 1-bpp bitmaps, some of which can be
  combined to make grayscale images. Deark will try to guess which images
  should be combined, but it may not always get it right.
  - Supports 1- and 2-bit grayscale.
  Options
   -opt psionpic:bw - Do not try to detect grayscale images. Write each bitmap
     as a separate image.

* QDV (Giffer) (module="qdv")

* QTIF (QuickTime image) (module="qtif")
  - Extract embedded JPEG, TIFF, and other image files.
  - Decode some "raw" (uncompressed) images.

* RIPscrip icon (.ICN) or BGI image (module="ripicon") (experimental)
  - Not all files are autodetected. You may need "-m ripicon".
  - Only 16-color images are supported.

* RISC OS / Acorn Sprite (module="rosprite")
  - Autodetection may not always work. May need "-m rosprite".
  - "Old" format is pretty well supported.
  - "New" format is mostly supported, but not well-tested.

* RISC OS / Acorn Draw (module="rodraw") (experimental)
  - Extract sprite image files.

* RSC (GEM resource) (module="rsc") (experimental)
  - Supports both "old" and "new" formats.
  - Extracts icons and bitmaps.
  Options
   -opt rsc:fmt=<atari|pc> - Use this byte order. Default is to autodetect.

* SHG and MRB (module="shg")
  Segmented Hypergraphics and Multi-Resolution Bitmap formats are used in
  Windows .HLP files.
  - Converts bitmap graphics to BMP format.
  - Extracts WMF files.

* Spectrum 512 Compressed (.spc) (module="spectrum512c")
  Options
   -opt spectrum512:tospu - Output to an .spu file

* Spectrum 512 Smooshed (.sps) (module="spectrum512s")
  Options
   -opt spectrum512:tospu - Output to an .spu file

* Spectrum 512 uncompressed (.spu) (module="spectrum512u")
  Options
   -opt atari:palbits=<n> (refer to readme.md)

* STOS Memory Bank (.mbk) (module="stos")
  - Decode "sprite bank" images
  - Decode "icon bank" images
  Options
   -opt atari:palbits=<n> (refer to readme.md)

* Sun Raster (module="sunras") (incomplete)
  - Supports most common image types
  Options
   -opt sunras:fmt32=<xbgr|abgr|xrgb|argb|bgrx|bgra|rgbx|rgba> - Specify the
     interpretation of a 32-bit pixel

* TGA (Targa) (module="tga")

* Thumbs.db (Windows thumbnail) (part of module "cfb")
  - Extract thumbnail files (embedded JPEG or PNG files)
  - Some thumbnails use a nonstandard RGBA format. These are not converted to
    a portable format.

* TI calculator "variable" files (module="tivariable")
  - TI73/TI82/TI83 pictures
  - TI85/TI86 pictures
  - TI89/TI92/TI92+ pictures

* TIFF and Exif (module="tiff")
  - Decode most images, excluding lossy-compressed images.
  - Extract JPEG-formatted Exif thumbnails, and some types of JPEG-compressed
    images.
  - Extract ICC profiles.
  - Process Photoshop-related data.
  - Extract IPTC-IIM data (use -a).
  Options
   -opt tiff:decode=0 - Do not decode images

* TIM (Playstation graphics) (module="tim") (experimental/incomplete)

* Tiny Stuff (.TNY, .TN1, .TN2, .TN3) (module="tinystuff")
  Options
   -opt atari:palbits=<n> (refer to readme.md)
   -opt atari:respectpal - Don't ignore a seemingly bad 2-color palette

* VBM (VDC BitMap) (module="vbm")
  - Version 2 only

* VITec image format (module="vitec) (experimental/incomplete)

* VORT ray tracer .pix image (module="vort") (experimental/incomplete)

* Windows 1.0 ICO/CUR (module="win1ico")

* Windows Metafile (module=wmf)
  - Extract BMP images from some records.
  - Extract embedded EMF documents.

* Winzle (module=winzle)
  - Convert Winzle obfuscated BMP (.wzl) to BMP.

* WordPerfect Graphics (module=wpg)
  - Extract bitmaps

* X11 puzzle (module="xpuzzle")
  Format used by X-Windows "puzzle" program.
  ftp://ftp.x.org/pub/unsupported/programs/puzzle/
  Generated by Netpbm's ppmtopuzz utility.

* XBIN (module="xbin")
  Renders XBIN character graphics to a bitmap (default) or HTML.
  - Extract embedded fonts (use -a).
  Options
   -opt char:output=html - Use HTML output format

* X-Face (icon/avatar format) (module="xface")
  - You may have to use "-m xface".

* XGA (Atari Falcon image) (module="falcon_xga")

* YBM (Bennet Yee face format) (module="ybm")

* ZBR ((Zoner) Zebra Metafile) (module="zbr")
  - Extract the preview image.

=== Font formats ===

* FNT (Windows font) (module="fnt")
  Most FNT files have an extra "absolute space" character, which Deark
  arbitrarily places at code point 256, or U+2002 (EN SPACE).

* GEM bitmap font (module="gemfont") (experimental)
  - Autodetection may not always work. May need "-m gemfont".

* GRASP font (module="graspfont") (experimental)
  .set/.fnt; may be found inside GRASP .gl files.

* PCF font (module="pcf") (experimental/incomplete)

* PC Screen Font (PSF) (module="psf")
  Options
   -opt font:noaliases - Restrict to one Unicode codepoint per glyph

* PFF2 font (module="pff2")

* PK font (Packed Font) (module="pkfont") (partial support)

* Unifont HEX (module="unifont_hex")
  - Cannot be autodetected. You must use "-m unifont_hex".

=== Compression, archive, installer, disk image modules ===

* ADF (Amiga disk image) (module="amiga_adf") (experimental)

* ARC archive (module="arc")
  - Some rare compression methods are not supported.

* ArcFS (module="arcfs")

* ArcMac (module="arcmac") (experimental)
  Variant of ARC.

* ARJ (module="arj") (experimental)

* AmBs (AMOS "Banks" aggregate format) (module="abk")
  - Extract AmSp, AmIc, AmBk files.

* Apple Partition Map (module="apm") (experimental)

* AppleSingle/AppleDouble (module="applesd")
  AppleDouble files often have names beginning with "._".
  - Extract data fork.
  - Extract (default for AppleSingle) or decode (default for AppleDouble)
    resource fork.
  Options
   -opt applesd:extractrsrc=<0|1> - Specify whether the resource fork is
     decoded (0), or extracted (1).

* ar (.a archive/library format) (module="ar") (experimental/incomplete)
  - Supports System V long filenames

* ATR (Atari disk image) (module="atr") (experimental/incomplete)

* BinHex (.hqx) (module="binhex")
  - Extract data and resource forks to separate files.

* CAB (Microsoft Cabinet) (module="cab")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* ARX (module="arx") (experimental)
  Variant of LHA. Deark tries to convert it to LHA.

* CAR (module="car_lha")
  Variant of LHA by MylesHi! Software. Deark tries to convert it to LHA.
  - File extension must be ".car" (or use "-m car").

* CD/raw (module="cd_raw")
  - Extract .ISO and other filesystem data from some raw CD images, such as
    the .BIN file in CUE/BIN format.

* compress (legacy Unix .Z format) (module="compress")

* cpio (module="cpio")

* CRLZH (module="crlzh")
  An old compressed file format used mainly on CP/M.

* Crunch (module="crunch")
  An old compressed file format used mainly on CP/M.
  - The header can be parsed, but only the rare v1.x format can be
    decompressed.

* CRUSH (.cru) (module="crush")
  CRUSH is a DOS archive utility by PocketWare.

* D64 (Commodore 64 disk format) (module="d64") (experimental)

* DMS (Amiga disk image) (module="amiga_adf") (experimental)
  - Decompresses to ADF format.

* Doom WAD (module="wad")
  - The extracted files are usually in specialized formats.

* FAT (module="fat") (experimental/incomplete)
  - Limited support, mainly for floppy disk images.

* Gzip (module="gzip")

* HFS filesystem image (module="hfs") (experimental/incomplete)
  - Incomplete support, but should be enough for most CD-ROM images.

* InstallShield Z archive (module="is_z") (experimental)

* ISO 9660 CD-ROM image (module="iso9660")
  Options
   -opt iso9660:tolower - Convert filenames to lowercase. Does not affect Rock
     Ridge or Joliet filenames.
   -opt iso9660:voldesc=<n> - Use the volume descriptor at sector <n>. A
     typical use is to set n=16 to ignore Joliet extensions.

* LBR (module="lbr")
  LRB is an uncompressed CP/M archive format.
  - These often contain files in compressed formats known as Squeeze, Crunch,
  and CrLZH. Deark doesn't necessarily support all of those formats.

* LHA/LZH/PMA (module="lha")
  - All common compression methods are supported.
  Options
   -opt lha:lhark - Assume "lh7" compression is LHARK format, instead of the
     standard lh7 format. (Unfortunately, autodetecting LHARK is impractical.)

* LoadDskF/SaveDskF (module=loaddskf)
  An OS/2 floppy disk image format.
  - By default, non-compressed files are interpreted (as with FAT).
  - Compressed files are decompressed.
  Options
   -opt loaddskf:toraw - Convert to raw FAT/IMA format.

* LZWCOM (module="lzwcom")
  LZWCOM/LZWUNC is an old file compression utility.
  - Not autodetected; you must use "-m lzwcom". In rare cases, you must also
    specify the version.
  Options
  -opt lzwcom:version=<1|2> : The format version.

* MacBinary (module="macbinary")
  - You may have to use "-m macbinary".

* Microsoft Compound File Binary (module="cfb")
  - Streams are not extracted by default, but some streams contain images and
    other objects that can be extracted.
  Options
   -opt cfb:extractstreams - Extract raw streams, instead of decoding.
   -opt cfb:fmt=raw - Do not try to detect the document type.
   -opt cfb:fmt=auto - Autodetect the document type (default).
   -opt cfb:fmt=thumbsdb - Treat the file as a Thumbs.db file.

* Microsoft Installation Compression (module="mscompress")

* MSA (Magic Shadow Archiver) (module="msa") (experimental)
  - Atari ST disk image format.
  Options
   -opt msa:toraw - Instead of decoding, extract to raw ".ST" format (this is
     usually a FAT format).
   -opt msa:touncmsa - Instead of decoding, convert to uncompressed MSA.

* NRG (module="nrg") (experimental)
  Nero CD image format.
  - Extract or decode ISO 9660 data.

* Pack (module="pack") (experimental)
  Old Unix compressed file format (.z).

* PackDir (module="packdir") (experimental)

* Palm PDB/PQA (module="palmdb")
  - You may have to use "-m palmdb".
  - Use -a to extract the record blocks, but note that they are usually not in
    well-known formats.
  Options
   -opt timestampfmt=<macbe|unixbe|macle> - The timestamp format to assume.

* Palm PRC (module="palmrc")
  - You may have to use "-m palmrc".
  - Use -a to extract the record blocks, but note that they are usually not in
    well-known formats.
  - Extracted ".palm" files are in Palm BitmapType format. Reprocess them to
    convert to PNG.

* Pasti (.stx) (module="pasti") (experimental)
  - Atari ST disk image format.
  Options
   -opt pasti:toraw - Instead of decoding, extract to raw ".ST" format (this is
     usually a FAT format).

* RPM (package manager) (module="rpm")
  - Extract compressed cpio file.

* SIS (EPOC/Symbian archive) (module="sis")
  - EPOC release 3/4/5/6

* Spark archive (module="spark")
  Options
   -opt spark:recurse=0 - Extract subdirectories as Spark files

* Squash (module="squash")
  A variant of "compress", used on RISC OS.

* Squeeze (module="squeeze")
  An old compressed file format used mainly on CP/M.
  - SQ2 variant is also supported (experimental).

* StuffIt (.sit) (module="stuffit")
  - Limited support. Old format only.

* tar (module="tar")
  - Rare files may need "-m tar", as tar is difficult to autodetect.

* TTComp (module="ttcomp")
  - In rare cases, you may have to use "-m ttcomp".

* WOZ (module="woz") (incomplete)
  Apple II disk image format.
  - Some metadata is parsed, but the disk contents are not extracted or listed.

* ZIP (module="zip")
  - Supports most compression methods.
  - Extract main ZIP file comment (use -a).
  - Extract comments for individual files (use -a).
  Options
   -opt zip:scanmode - Attempt to read the file without using the ZIP "central
     directory". Not recommended, but allows some damaged ZIP files to be read.

* zlib (module="zlib")
  - Raw zlib files are uncompressed.

* Zoo (module="zoo")
  - Extract comments (use -a).
  Options
   -opt zoo:undelete - Also extract deleted files.

* Zoo filter format (module="zoo_filter")
  Format created by "zoo fc".

* Zoo Z format (module="zoo_z")
  Format created by "zoo xz <foo.zoo> [...]". Not all Zoo programs support it.
  - Will be translated to Zoo format.

* ZSQ (module="zsq")
  Compressed file format related to LZWCOM.

== Transfer encoding modules ==

* Ascii85 (module="ascii85") (incomplete)
  - Supports old and new btoa formats
  - Supports data with "<~" / "~>" delimiters

* Base16 (module="base16" or "hex")
  - Decode "hex encoded" data.
  - Not autodetected; use "-m base16".
  - Only supports raw data, such as that produced by "xxd -p". Does not
    support full hex dumps.

* Base64 (module="base64")
  - Not autodetected; use "-m base64".

* Uuencoded (module="uuencode")

* Xxencoded (module="xxencode")

=== Other modules ===

* AMOS source code (module="amos_source")
  - Extract AmBs resource file.

* ASF multimedia (module="asf")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Byte frequency analysis (module="bytefreq")
  Print a table showing how many times each byte value occurs.
  - You must use "-m bytefreq".

* C64 BASIC (module="basic-c64") (experimental)
  - Detokenize C64 BASIC programs

* Copy (module="copy")
  - "Extract" the entire file. Use with -start and -size to extract part of
    the file.

* CP437 (module="cp437")
  Convert DOS Code Page 437 text to UTF-8.
  - Not autodetected. Use "-m cp437".
  - Note that code points below 0x20 are ambiguous. Deark tries to guess which
    ones are control characters.

* CRC (module="crc")
  Print various CRC hashes and checksums of the file, including the IEEE
  CRC-32.
  - You must use "-m crc".

* DS_Store (module="dsstore") (experimental)
  Metadata format associated with MacOS Finder.

* EBML/Matroska/MKV/WebM (module="ebml")
  Options
   -opt ebml:encodedid - Also print element ID numbers in raw (encoded) form.

* EXE/PE/NE/etc. (module="exe")
  EXE format can be complex. Not all varieties are correctly supported.
  - Extract bitmaps, icons, and cursors from NE and PE (Windows .exe) files.
  - Extract fonts.
  - Extract embedded manifests (use -a).
  - Extract code-signing certificates (use -a).
  - Extract bitmaps from LX (Linear Executable) files. Note that some of these
    may be in "Bitmap Array" format. Reprocess them with Deark to extract the
    actual BMP file(s).
  - Extract icons and cursors from LX files. Note that these will use OS/2
    format. Reprocess them with Deark to convert to PNG.

* FLAC audio (module="flac")

* Hex dump (module="hexdump")
  Print a hex dump of the file.
  - You must use "-m hexdump".

* HLP (Windows Help) (module="hlp")
  Options
   -opt hlp:extracttext - Write the file's text (unformatted) to a file. This
     feature is experimental and incomplete.
   -opt hlp:extractstreams - Extract raw files, instead of decoding.

* ICC profile (module="iccprofile")
  - Debug info only.

* IFF (Interchange File Format) (module="iff")
  - IFF can be parsed, but in many cases nothing can be extracted from it.
  Options
   -opt iff:align=<n> - Assume chunks are padded to an n-byte boundary.

* IPTC-IIM metadata (module="iptc")
  - Extract captions/abstracts (use -a).
  - Extract raster caption bitmaps.

* ISO-BMFF (module="bmff") (incomplete)
  - MP4, QuickTime .mov, HEIF, etc.
  Options
   -opt bmff:maxentries=<n> - Maximum number of sample table entries to print
     when using -d. This applies to several boxes, such as 'stsz'.

* JPEG scan (module="jpegscan")
  - This module tries to find and extract embedded JPEG and JPEG-LS files from
    otherwise-unsupported formats. Use "-m jpegscan".

* Macintosh Resource Manager (module="macrsrc") (experimental/incomplete)
  This is the format generally used by Mac resource forks.
  Options
   -opt macrsrc:extractraw - Extract all resources directly to files.

* MIDI (module="midi")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Monkey's Audio (.ape) (module="monkeys_audio")
  - Minimal support. Decodes APE tag metadata.

* MP3 / MPEG audio (module="mpegaudio" or "mp3")
  - Not all files can be autodetected.
  - Mainly for ID3 and APE metadata. The audio data is not converted.

* NULL (module="null")
  - Do nothing.

* Ogg (Vorbis, Theora, etc.) (module="ogg")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.
  Options
   -opt ogg:hexdump - With -d, include a hex dump of more data than usual.

* Photoshop Action format (.atn) (module="ps_action")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Photoshop Brush format (.abr) (module="ps_brush")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Photoshop Custom Shapes format (.csh) (module="ps_csh")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Photoshop Gradient format (.grd) (module="ps_gradient")
  - Supports file version 5 only (Photoshop 6+)
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Photoshop Patterns format (.pat) (module="ps_pattern")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Photoshop Styles format (.asl) (module="ps_styles")
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Plain text (module="plaintext")
  Read a plain text file, and write it as UTF-8.
  - Not autodetected. Use "-m plaintext".
  - See also the "cp437" module, which works better on some files.

* .plist Property List (module="plist")
  - Supports binary .plist format only
  - Files can be parsed, but there is usually nothing that can be extracted
    from them.

* Psion APP/IMG and OPA/OPO (module="psionapp")
  - Extract Psion PIC icons.
  - Extract other contents (use -a).

* RIFF (module="riff")
  Metaformat used by WAV, AVI, WebP, etc.
  - RIFF can be parsed, but in many cases nothing can be extracted from it.

* Split (module="split")
  Split the file into equal-sized chunks.
  Options
   -opt split:size=<n> - The size of each chunk, in bytes.
   -opt split:stride=<n> - The distance between the start of one chunk and the
    start of the next chunk, in bytes.

* WRI - Microsoft Write (module="wri") (incomplete)
  - Extract raw text to an HTML file. Very little formatting, etc.
  - Extract most pictures.
  Options
   -opt wri:extracttext=0 - Do not extract text
   -opt ole1:extractall - Extract unidentified OLE objects