JavaScript support is required to run this website properly.
Please enable it in your browser's settings, or turn off the script blocker.

Documentation / EasyHDR command line parameters


The run time parameters allow running batch scripts of easyHDR tasks in background. It is also possible to initialize easyHDR, by loading input photos, or performing part of operation automatically, before continuing manual work.


Parameters:

--auto                           process automatically and close
--hide                           start minimized 
--tm_settings=[file name]        tone mapping settings to use
--auto_align                     automatic alignment
--auto_align_nocrop              disable cropping for automatic alignment
--auto_lens                      automatic lens correction (chromatic aberration, distortion & vignette)
--auto_lens_ca                   automatic lens correction (only chromatic aberration)
--auto_lens_distortion           automatic lens correction (only distortion)
--auto_lens_vignette             automatic lens correction (only vignette)
--auto_lens_ca_distortion        automatic lens correction (only chromatic aberration & distortion)
--auto_lens_ca_vignette          automatic lens correction (only chromatic aberration & vignette)
--auto_lens_distortion_vignette  automatic lens correction (only distortion & vignette)
--auto_lens_nocrop               disable cropping for automatic lens correction
--defringe                       defringe (remove purple/cyan on distinct edges, near the image borders)
--auto_deghost                   ghost removal
--noise_filter=[a,b{,c}]         noise filter parameters as in the GUI (third parameter for color is optional)
--panorama                       360 deg panorama mode
--output_fn=[file name]          result file path (supported formats: JPEG, JP2, J2K, TIFF & PNG)
--output_hdr_fn=[file name]      intermediate HDR file path (supported formats: OpenEXR, HDR (RadianceRGBE) & 32-bit TIFF)
--output_dir=[path]              when 'output_fn' is not defined the default file name is used to store the result
--no_tonemapping                 skips tone mapping (useful to just generate intermediate HDR image)
--jpeg                           save as jpeg in the 'output_dir'
--jp2                            save as jp2 in the 'output_dir'
--j2k                            save as j2k in the 'output_dir'
--png                            save as png in the 'output_dir'
--tiff                           save as tiff in the 'output_dir'
--b8                             8-bit depth (j2k, jp2, tiff)
--b16                            16-bit depth (j2k, jp2, tiff)
--tiff8                          = tiff+b8
--tiff16                         = tiff+b16
--jp2_8                          = jp2+b8
--jp2_16                         = jp2+b16
--j2k_8                          = j2k+b8
--j2k_16                         = j2k+b16
--save_resize=[longer edge]      define the longer edge result image dimension (only when saving in JPEG format)
--output_to_srgb                 convert to sRGB space on save
[input image file names]         input image(s) - passed as a list of parameters

'output_hdr_fn' and 'no_tonemapping' are supported since version 3.16.3

Examples (Windows):

    "C:\Program Files\easyHDR 3\easyHDR3.exe" "d:\test\in1.jpg" "d:\test\in2.jpg" "d:\test\in3.jpg"
	--auto_align --auto_align_nocrop --auto_lens_distortion --auto_lens_nocrop --save_resize=1333
	--tm_settings="C:\Program Files\easyHDR 3\built-in presets\interior.ehsx" 
	--auto_lens --auto_deghost --noise_filter=3,3,4 --output_fn="d:\test\result.jpg"

    "C:\Program Files\easyHDR 3\easyHDR3.exe" "d:\test\in1.jpg" --auto --hide --noise_filter=4,4
	--tm_settings="C:\Program Files\easyHDR 3\built-in presets\default.ehsx" 
	--output_dir="d:\test" --jp2 --b16 --output_hdr_fn="d:\test\hdrresult.exr"

Examples (macOS):

    /Applications/easyHDR3.app/Contents/MacOS/easyHDR3 
	"/Users/bartek/Documents/test/P1210404.JPG" 
	"/Users/bartek/Documents/test/P1210405.JPG" 
	"/Users/bartek/Documents/test/P1210406.JPG" 
	--auto --auto_lens --auto_lens_nocrop --auto_align --auto_align_nocrop --auto_deghost --noise_filter=3,3,4
	--tm_settings="/Users/bartek/Documents/easyHDR 3/built-in presets/black-and-white.ehsx" 
	--output_dir="/Users/bartek/Documents/test/out" --tiff16


The standard paths on Windows:

	easyHDR executable: 
		C:\Program Files\easyHDR 3\easyHDR3.exe
	
	Built-in and user presets:
		C:\Program Files\easyHDR 3\built-in presets
		C:\Users\[name]\easyHDR 3\presets\
		

The standard paths on macOS:

	easyHDR executable: 
		/Applications/easyHDR3.app/Contents/MacOS/easyHDR3
	
	Built-in and user presets:
		/Users/[name]/Documents/easyHDR 3/built-in presets
		/Users/[name]/Documents/easyHDR 3/presets
 



The additional parameters listed below are for potential GUI workarounds.

-scale [value]         Overrides easyHDR's GUI scaling. Default value is 1, other possible: 0.3 through 2.00. 
                       In easyHDR versions below 3.17 only 0.5, 1, and 2 are allowed.
-roundscale            Forces automatic scaling rounding (that's default Qt GUI behavior, which easyHDR 
                       normally does not use) - available since easyHDR 3.17.
-nohidpi               Forces High DPI mode disabled.
-dontcheckqtversion    Disables check for exact linked Qt version.

Last updated: 2.11.2025

Current easyHDR version
3.17   (November 25th 2025)