file-format

Build

Crate for determining binary-based file formats.

Examples

Determines from a file:

use file_format::{FileFormat, Kind};

let format = FileFormat::from_file("fixtures/application/sample.zip").unwrap();
assert_eq!(format, FileFormat::Zip);
assert_eq!(format.name(), "ZIP");
assert_eq!(format.media_type(), "application/zip");
assert_eq!(format.extension(), "zip");
assert_eq!(format.kind(), Kind::Application);

Determines from bytes:

use file_format::{FileFormat, Kind};

let format = FileFormat::from_bytes(&[0xFF, 0xD8, 0xFF, 0xEE]);
assert_eq!(format, FileFormat::JointPhotographicExpertsGroup);
assert_eq!(format.name(), "Joint Photographic Experts Group");
assert_eq!(format.media_type(), "image/jpeg");
assert_eq!(format.extension(), "jpg");
assert_eq!(format.kind(), Kind::Image);

Usage

Add this to your Cargo.toml:

[dependencies]
file-format = "0.9"

Features

cfb - Enables Compound File Binary formats support.
zip - Enables ZIP formats support.

All these features are disabled by default.

Supported formats

3rd Generation Partnership Project - 3gp
3rd Generation Partnership Project 2 - 3g2
7-Zip - 7z
ALZ - alz
AV1 Image File Format - avif
AV1 Image File Format Sequence - avifs
Adaptive Multi-Rate - amr
Adobe Flash Player Audio - f4a
Adobe Flash Player Audiobook - f4b
Adobe Flash Player Protected Video - f4p
Adobe Flash Player Video - f4v
Adobe Illustrator Artwork - ai
Adobe InDesign Document - indd
Adobe Photoshop Document - psd
Advanced Audio Coding - aac
Android Binary XML - xml
Android Compiled Resources - arsc
Animated Portable Network Graphics - apng
Apache Arrow Columnar - arrow
Apple Disk Image - dmg
Apple Icon Image - icns
Apple QuickTime - mov
Apple iTunes Audio - m4a
Apple iTunes Audiobook - m4b
Apple iTunes Protected Audio - m4p
Apple iTunes Video - m4v
Arbitrary Binary Data - bin
Archived by Robert Jung - arj
Au - au
Audio Codec 3 - ac3
Audio Interchange File Format - aiff
Audio Video Interleave - avi
Better Portable Graphics - bpg
Blender - blend
Cabinet - cab
Canon Raw 2 - cr2
Canon Raw 3 - cr3
Cineon - cin
Compound File Binary - cfb
Creative Voice - voc
DER Certificate - der
Dalvik Executable - dex
Debian Binary Package - deb
Digital Imaging and Communications in Medicine - dcm
Digital Picture Exchange - dpx
DjVu - djvu
Dynamic Link Library - dll
Embedded OpenType - eot
Encapsulated PostScript - eps
Executable and Linkable Format - elf
Experimental Computing Facility - xcf
Extensible Archive - xar
FastTracker 2 Extended Module - xm
Flash Video - flv
Flexible Image Transport System - fits
Free Lossless Audio Codec - flac
Free Lossless Image Format - flif
Fujifilm Raw - raf
GL Transmission Format Binary - glb
Game Boy Advance ROM - gba
Game Boy Color ROM - gbc
Game Boy ROM - gb
Google Chrome Extension - crx
Graphics Interchange Format - gif
High Efficiency Image Coding - heic
High Efficiency Image Coding Sequence - heics
High Efficiency Image File Format - heif
High Efficiency Image File Format Sequence - heifs
ISO 9660 - iso
Impulse Tracker Module - it
JPEG 2000 Part 1 - jp2
JPEG 2000 Part 2 - jpx
JPEG 2000 Part 3 - mj2
JPEG 2000 Part 6 - jpm
JPEG Extended Range - jxr
JPEG XL - jxl
Java Class - class
Java KeyStore - jks
Joint Photographic Experts Group - jpg
Khronos Texture - ktx
Khronos Texture 2 - ktx2
LHA - lzh
LLVM Bitcode - bc
LZ4 - lz4
Lempel–Ziv Finite State Entropy - lzfse
Long Range ZIP - lrz
Lua Bytecode - luac
MPEG-1 Audio Layer 1 - mp1
MPEG-1 Audio Layer 2 - mp2
MPEG-1 Video - mpg
MPEG-1/2 Audio Layer 3 - mp3
MPEG-2 Transport Stream - mts
MPEG-4 Part 14 Video - mp4
MS-DOS Executable - exe
Material Exchange Format - mxf
Matroska Video - mkv
Meta Information Encapsulation - mie
Microsoft Access 2007 Database - accdb
Microsoft Access Database - mdb
Microsoft Compiled HTML Help - chm
Microsoft DirectDraw Surface - dds
Microsoft Virtual Hard Disk - vhd
Microsoft Virtual Hard Disk 2 - vhdx
Mobipocket - mobi
Monkey’s Audio - ape
Musepack - mpc
Musical Instrument Digital Interface - mid
Nikon Electronic File - nef
Nintendo 64 ROM - z64
Nintendo DS ROM - nds
Nintendo Entertainment System ROM - nes
Ogg FLAC - oga
Ogg Media - ogm
Ogg Multiplexed Media - ogx
Ogg Opus - opus
Ogg Speex - spx
Ogg Theora - ogv
Ogg Vorbis - ogg
Olympus Raw Format - orf
OpenEXR - exr
OpenType - otf
Optimized Dalvik Executable - dey
PCAP Dump - pcap
PCAP Next Generation Dump - pcapng
PEM Certificate - crt
PEM Certificate Signing Request - csr
PEM Private Key - key
PGP Message - asc
PGP Private Key Block - asc
PGP Public Key Block - asc
PGP Signature - asc
Panasonic Raw - rw2
PgpSignedMessage - asc
Portable Document Format - pdf
Portable Executable - exe
Portable Network Graphics - png
PostScript - ps
Qualcomm PureVoice - qcp
Radiance HDR - hdr
Red Hat Package Manager - rpm
Rich Text Format - rtf
Roshal Archive - rar
SQLite 3 - sqlite
ScreamTracker 3 Module - s3m
SeqBox - sbx
Shapefile - shp
SketchUp - skp
Small Web Format - swf
Snappy - sz
Sony DSD Stream File - dsf
Sony Movie - mqv
TASTy - tasty
Tag Image File Format - tiff
Tape Archive - tar
TrueType - ttf
UNIX archiver - a
UNIX compress - Z
VirtualBox Virtual Disk Image - vdi
WavPack - wv
Waveform Audio - wav
Web Open Font Format - woff
Web Open Font Format 2 - woff2
WebAssembly Binary - wasm
WebM - webm
WebP - webp
Windows Animated Cursor - ani
Windows Bitmap - bmp
Windows Cursor - cur
Windows Icon - ico
Windows Media Video - wmv
Windows Metafile - wmf
Windows Shortcut - lnk
XZ - xz
ZIP - zip
Zstandard - zst
bzip2 - bz2
cpio - cpio
gzip - gz
lzip - lz
lzop - lzo
macOS Alias - alias
zoo - zoo

Compound File Binary:

Microsoft Excel Spreadsheet - xls
Microsoft PowerPoint Presentation - ppt
Microsoft Project Plan - mpp
Microsoft Publisher Document - pub
Microsoft Software Installer - msi
Microsoft Visio Drawing - vsd
Microsoft Word Document - doc

ZIP:

3D Manufacturing Format - 3mf
Android Package - apk
Circuit Diagram Document - cddx
Design Web Format XPS - dwfx
Electronic Publication - epub
Enterprise Application Archive - ear
Java Archive - jar
Keyhole Markup Language Zipped - kmz
Microsoft Visual Studio Extension - vsix
Office Open XML Document - docx
Office Open XML Drawing - vsdx
Office Open XML Presentation - pptx
Office Open XML Spreadsheet - xlsx
OpenDocument Graphics - odg
OpenDocument Presentation - odp
OpenDocument Spreadsheet - ods
OpenDocument Text - odt
Web Application Archive - war
Windows App Package - appx
XAP - xap
XPInstall - xpi
iOS App Store Package - ipa

License