hdrify-cli

CLI for converting and inspecting EXR, HDR, and JPEG gain map (Ultra HDR / Adobe) files. Convert to highly compressible JPEG-R (JPEG with gain maps) for efficient HDR storage. Powered by hdrify.

Related packages: hdrify (core library) · hdrify-react (React component)

An online demo is available at https://hdrify.ben3d.ca — HDR, EXR, and Ultra HDR viewer and converter; try it in your browser without installing the CLI.

Installation

pnpm add -g hdrify-cli

Usage

Command	Description
hdrify convert <input> <output>	Convert between EXR, HDR, JPEG gain map, PNG, WebP, and JPEG
hdrify info <file>	Display metadata (format, dimensions, compression)
hdrify reference <output>	Create synthetic reference test images

# Convert between formats
hdrify convert input.exr output.hdr
hdrify convert input.hdr output.exr --compression piz
hdrify convert input.exr output.jpg    # JPEG-R with gain map (Ultra HDR, default)
hdrify convert input.exr output.jpg --format adobe-gainmap
hdrify convert input.jpg output.exr    # Read JPEG gain map as input
hdrify convert input.exr output.webp   # Tonemaps to SDR

# View file metadata
hdrify info input.exr
hdrify info input.hdr
hdrify info input.jpg

# Create synthetic reference images
hdrify reference output.exr --compression zip
hdrify reference output.hdr
hdrify reference output.exr --type cie-wedge
hdrify reference output.hdr --type gradient

Options

convert: --compression (EXR: none, rle, zip, zips, piz, pxr24), --format (JPEG: ultrahdr, adobe-gainmap), --tonemapping, --exposure, --quality

reference: --type (rainbow, cie-wedge, cie-wedge-r, cie-wedge-g, cie-wedge-b, gradient), --compression, --width, --height

Run hdrify --help for full usage.

License

MIT

Author

Ben Houston, Sponsored by Land of Assets