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.

An online demo (the website from this repository) is available at https://hdrify.benhouston3d.com — an HDR, EXR, and Ultra HDR (JPEG-R) format 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.ultrahdr.jpg    # JPEG-R with gain map (Ultra HDR, default)
hdrify convert input.exr output.gainmap.jpg --format adobe-gainmap   # Adobe gain map format
hdrify convert input.jpg output.exr    # Read JPEG gain map (Ultra HDR or Adobe) as input
hdrify convert input.exr output.webp   # Tonemaps the HDR during conversion to SDR webp format

# View file metadata
hdrify info input.exr
hdrify info input.hdr
hdrify info input.jpg    # JPEG gain map (Ultra HDR / Adobe)

# Create synthetic reference image
hdrify reference output.exr
hdrify reference output.exr --compression zip   # EXR only; --compression ignored for .hdr
hdrify reference output.hdr
hdrify reference output.exr --type cie-wedge    # CIE chromaticity wedge (default: rainbow)
hdrify reference output.hdr --type cie-wedge-r # CIE wedge, R channel only (G,B black)
hdrify reference output.hdr --type cie-wedge-g # CIE wedge, G channel only
hdrify reference output.hdr --type cie-wedge-b # CIE wedge, B channel only
hdrify reference output.hdr --type gradient     # SDF gradient

Options

Key flags for convert: --compression (EXR output only: none, rle, zip, zips, piz, pxr24), --format (JPEG output only: ultrahdr, adobe-gainmap; default: ultrahdr), --tonemapping (aces, reinhard, neutral, agx), --exposure, --quality (JPEG). For reference: --type (rainbow, cie-wedge, cie-wedge-r, cie-wedge-g, cie-wedge-b, gradient; default: rainbow), --compression (EXR output only: rle, zip, piz, pxr24), --width, --height. Run hdrify --help for full usage.

Library

For programmatic use, install the hdrify library.

License

MIT

Author

Ben Houston [email protected] (https://benhouston3d.com), Sponsored by Land of Assets