revelo-cli-0.4.4 is not a library.

revelo-cli

A fast, safe, pure-Rust command-line tool for extracting technical and tag metadata from media files — a from-scratch Rust port of MediaInfoLib with optional ExifTool-grade EXIF/maker-note depth.

No ./Configure, no system libraries, no Perl runtime. Installs with one cargo install and runs anywhere a Rust toolchain runs.

Part of the revelo project — see the project README for the full picture.

Install

cargo install revelo-cli

The binary is named revelo.

For ExifTool-grade maker-note depth across 14 camera vendors, opt into the exiftool-tables feature:

cargo install revelo-cli --features exiftool-tables

License note: the default build is BSD-2-Clause. The exiftool-tables feature pulls in tables derived from ExifTool, so a binary built with it is subject to GPL/Artistic terms. See Licensing below.

Quick start

# Human-readable text report (default)
revelo video.mp4

# MediaInfoLib-compatible XML
revelo --xml video.mp4

# JSON, including EXIF / maker-note tags
revelo photo.jpg --json

# One-line aggregate summary
revelo --summary movie.mkv

Running revelo with no path prints the help banner.

Output formats

Flag	Format	Notes
(default)	Text	Human-readable, MediaInfo-style report
`-x`, `--xml`	XML	Byte-compatible with MediaInfoLib's XML output
`-j`, `--json`	JSON	Structured; includes EXIF/IPTC/XMP/ICC tag streams
`--csv`	CSV	Flat field rows
`--summary`	Summary	Aggregate statistics across streams

Only one format applies per run; text is used when none is given.

Options

Flag	Description
`-d`, `--demux <LEVEL>`	Demux depth: `frame` (default), `container`, `elementary`
`-r`, `--trace <N>`	Trace verbosity, `0`–`9` (default `0`)
`-m`, `--multi-file`	Scan companion files (BDMV M2TS playlists, sidecar subtitles)
`--video-only`	Keep only General + Video streams
`--audio-only`	Keep only General + Audio streams
`--stream <KIND:INDEX>`	Select specific streams; repeatable (see below)
`--verify`	Report structural integrity (`IsComplete`, truncation warnings)
`--inform-version`	Prepend the revelo library version to text output
`--inform-timestamp`	Prepend a report timestamp to text output
`--log-file <FILE>`	Write output to a file instead of stdout
`-h`, `--help`	Print help
`-V`, `--version`	Print version

Selecting streams

--stream KIND:INDEX picks an individual stream. KIND accepts either a number or a name, and the flag may be repeated:

revelo movie.mkv --stream Video:0 --stream Audio:1
revelo movie.mkv --stream 1:0          # same as Video:0

#	Kind	#	Kind
0	General	7	Exif
1	Video	8	Iptc
2	Audio	9	Xmp
3	Text	10	Icc
4	Other	11	C2pa
5	Image	12	MakerNotes
6	Menu

What it extracts

Containers & codecs — MP4/MOV, Matroska/WebM, MPEG-TS, AVI, WAV, and ~200 formats total, with codec details from AVC/HEVC/AV1/VP9 and AAC/AC-3/DTS/FLAC/Opus.
Photo metadata — EXIF, GPS, IPTC, XMP, ICC, C2PA, and (with exiftool-tables) deep maker-notes for Canon, Nikon, Fujifilm, Olympus, Sony, Panasonic, and more.
HDR signalling — HDR10+, Dolby Vision, HLG/PQ, plus Dolby Atmos / AC-4 and IAMF audio.

Examples

# Audio tracks only, as JSON, written to a file
revelo concert.mkv --audio-only --json --log-file tracks.json

# Verify a possibly-truncated download
revelo --verify suspicious.mp4

# Deep camera maker-notes (requires the exiftool-tables build)
revelo IMG_1234.CR2 --json

License

Core (default build): BSD-2-Clause — see LICENSE.
exiftool-tables feature: pulls in revelo-exiftool-tables, which is GPL-1.0-or-later OR Artistic-1.0-Perl (tables derived from ExifTool, © Phil Harvey). A binary built with this feature inherits those terms.

revelo-cli 0.4.4