Command Line Options Page 1 of 9

Command Line Options Top Previous Next

==> see the file "i_options.txt" (IrfanView folder) for the most recent version on all command line options.

Command line options allow you to set some functions of IrfanView before the viewer is launched.

These command line options are supported in IrfanView:

/one - force 'Only one instance'

/fs - force Full Screen display
/bf - force 'Fit images to desktop' display option
/title=text - set window title to 'text'
/pos=(x,y) - move the window to x,y (if display option allows that)
/display=(x,y,w,h,zoom,sX,sY) - set position, size, zoom and scroll position of the IrfanView window and
image
/convert=filename - save/convert input image(s)/file(s) to "filename" and CLOSE IrfanView
(see Pattern page for additional filename options)
/makecopy - for convert: if destination file exists, save new file as copy: (1), (2), (3)
etc.
/slideshow=txtfile - play slideshow with the files from 'txtfile'
/slideshow=folder - play slideshow with the files from 'folder'
/reloadonloop - reload input source used in /slideshow when list finished
/filelist=txtfile - use filenames from "txtfile" as input, see examples below
/file=filename(s) - use filename(s) as input, see examples below
/thumbs - open Thumbnails window
/killmesoftly - close all IrfanView instances (exit after command line)
/cmdexit - close current IrfanView after command line processing
/fs_exit - ESC closes fullscreen and IrfanView (if started in fullscreen mode)
/closeslideshow - close slideshow and close IrfanView after the last image
/page=X - open page number X from a multipage input image
/crop=(x,y,w,h,C) - crop input image: x-start, y-start, width, height, C-start corner (0-4)
/print - print input image to default printer and close IrfanView
/print="Name" - print input image to specific printer and close IrfanView
/resize=(w,h) - resize input image to w (width) and h (height)
/resize_long=X - resize input image: set long side to X
/resize_short=X - resize input image: set short side to X
/resample - for resize: use Resample option (better quality)
/aspectratio - used for /resize, keep image proportions
/capture=X - capture the screen or window (see examples below)
/ini - use the Windows folder for INI/LST files (read/save)
/ini="Folder" - use the folder "Folder" for INI/LST files (read/save)
/clippaste - paste image from the clipboard
/clipcopy - copy image to the clipboard
/silent - don't show error messages for command line read/save errors
/invert - invert the input image (negative)
/dpi=(x,y) - change DPI values, set DPIs for scanning
/scan - acquire the image from the TWAIN device - show TWAIN dialog
/scanhidden - acquire the image from the TWAIN device - hide TWAIN dialog
/batchscan=(options) - simulate menu: File->Batch Scanning, see examples below
/bpp=BitsPerPixel - change color depth of the input image to BitsPerPixel
/swap_bw - swap black and white color
/gray - convert input image to grayscale
/rotate_r - rotate input image to right

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 2 of 9

/rotate_l - rotate input image to left

/hflip - horizontal flip
/vflip - vertical flip
/filepattern="x" - browse only specific files
/sharpen=X - open image and apply the sharpen filter value X
/effect=(X,p1,p2) - apply effect filter X, see below for examples
/contrast=X - open image and apply the contrast value X
/bright=X - open image and apply the brighntess value X
/gamma=X - open image and apply the gamma correction value X
/advancedbatch - apply Advanced Batch Dialog options to image (from INI file)
/hide=X - hide toolbar, status bar, menu and/or caption of the main window (see
examples below)
/transpcolor=(r,g,b) - set transparent color if saving as GIF/PNG/ICO
/info=txtfile - write image infos to "txtfile"
/fullinfo - used for /info, write EXIF, IPTC and Comment data
/shortinfo - used for /info, write just file index and name
/append=tiffile - append image as (TIF) page to "tiffile"
/multitif=(tif,files) - create multipage TIF from input files
/multipdf=(pdf,files) - create multipage PDF from input files
/panorama=(X,files) - create panorama image from input files; X = direction (1 or 2)
/jpgq=X - set JPG save quality
/tifc=X - set TIF save compression
/wall=X - set image as wallpaper; see below for /random and examples
/extract=(folder,ext) - extract all pages from a multipage/multiframe file
/import_pal=palfile - import and apply a special palette to the image (PAL format)
/export_pal=palfile - export image palette to file (PAL format)
/jpg_rotate=(options) - JPG lossless rotation, see examples below
/hotfolder="folder" - start Hotfolder option with a specific folder
/monitor=X - start EXE-Slideshow on monitor X
/window=(x,y,w,h) - set EXE-Slideshow window position and size
/clearmonitors - play EXE-slideshow on one monitor, clear all other monitors

Notes:

- Only lower case options are supported (don't type any UPPERCASE letters for options) !
- Use "" for filenames/paths with spaces! (example: "c:\images\dummy test [Link]")
- Input filename (if required) is always the first parameter (unless /file or /filelist is used).
- Write always the FULL paths for filenames (incl. drive letter).
- You can combine several options in one command.
- The commands will be processed in the order you write them.
- Wildcards supported only for /convert, /multitif, /multipdf, /panorama, /print, /info, /jpg_rotate and /extract.
- Do not set any other commands after /batchscan or /scan, they won't be processed.
- Maximal command line length is limited to 4096 chars: use Drag&Drop, /file or /filelist for very large lists.
- Most settings are loaded from the INI file. Using prepared INIs and /ini=folder option, you can extend the
possibilities.
- IrfanView exit code is 0. If /convert or /print is used, there is 1 or 2 also possible, for load/save errors.
- Please test (e.g. conversions) first in GUI mode => some options may need to be set first (saved to INI file).

Example for conversion:

i_view32.exe c:\[Link] /convert=c:\[Link]

Convert file: 'c:\[Link]' to 'c:\[Link]' without GUI.

i_view32.exe c:\*.jpg /convert=d:\temp\*.gif

i_view32.exe c:\*.jpg /resize=(500,300) /aspectratio /resample /convert=d:\temp\*.png
i_view32.exe c:\*.jpg /resize_long=300 /aspectratio /resample /convert=d:\temp\outimage_###.jpg
i_view32.exe /filelist=c:\[Link] /resize=(500,300) /aspectratio /resample /convert=d:\temp\*.png

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 3 of 9

i_view32.exe c:\[Link] /convert=c:\test_$Wx$[Link]

i_view32.exe c:\[Link] /convert=c:\temp\$[Link]
i_view32.exe c:\[Link] /convert=c:\temp\*.tif
i_view32.exe c:\[Link] /makecopy /convert=c:\temp\$[Link]
i_view32.exe c:\[Link] /resize=(100,100) /resample /aspectratio /convert=d:\$N_thumb.jpg
i_view32.exe c:\[Link] /aspectratio /convert=d:\temp\$T(%Y%m%d)\test_$Wx$[Link]
i_view32.exe c:\[Link] /convert=$D$[Link]
i_view32.exe c:\*.bmp /convert=$D$[Link]
i_view32.exe c:\*.jpg /advancedbatch /convert=c:\temp\*.jpg
i_view32.exe c:\[Link] /transpcolor=(255,255,255) /convert=c:\[Link]
(Note: Supported are all IrfanView read/save formats except audio/video.)

Example for slideshow:

i_view32.exe /slideshow=c:\[Link]
(Note: The file 'c:\[Link]' contains, in each line, a name of an image, including the full path OR path
relative to "i_view32.exe".)

i_view32.exe /slideshow=c:\[Link] /reloadonloop

i_view32.exe /slideshow=c:\images\
i_view32.exe /slideshow=c:\images\ /reloadonloop
i_view32.exe /slideshow=c:\images\*.jpg
i_view32.exe /slideshow=c:\images\test*.jpg
i_view32.exe /slideshow=c:\images\*.jpg /effect=(8,3,0)
i_view32.exe /slideshow=c:\[Link] /effect=(30,0,0) /reloadonloop
i_view32.exe /slideshow="c:\images\" /filepattern="*.jpg;*.gif;*.png" /reloadonloop
You have to close IrfanView after the last image from the TXT file, if not /closeslideshow is used.

Example for /closeslideshow:

i_view32.exe /slideshow=c:\[Link] /closeslideshow

IrfanView will be closed after the last image from 'c:\[Link]'.

Example for thumbnails:

i_view32.exe c:\test\[Link] /thumbs

Open '[Link]' and display thumbnails from folder/directory 'c:\test'.

i_view32.exe c:\test\ /thumbs

i_view32.exe /thumbs c:\test\
Display thumbnails from folder/directory 'c:\test'.

i_view32.exe /filelist=c:\[Link] /thumbs

Load filenames from TXT file and display as thumbnails.

Example for file: (this option is nice if you need to send the input file(s) as last parameter)

i_view32.exe /file=c:\[Link] (same as "i_view32.exe c:\[Link]")

i_view32.exe /convert="c:\result\*.tif" /file=c:\[Link]
i_view32.exe /convert="c:\result\*.tif" /file=c:\[Link] "c:\spacy [Link]" c:\[Link]
i_view32.exe i_view32.exe /thumbs /file=c:\[Link] "c:\spacy [Link]" c:\[Link]
(Hint: you can create a special IrfanView desktop (or "Send to") shortcut which can use the files from
Drag&Drop with other options like: "i_view32.exe [options] /file=")

Example for filelist:

i_view32.exe /filelist=c:\[Link]
i_view32.exe /filelist=c:\[Link] /convert=d:\test\*.jpg
i_view32.exe /filelist=c:\[Link] /thumbs

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 4 of 9

Example for close:

i_view32.exe /killmesoftly
Close IrfanView and terminate all instances.

Example for /page:

i_view32.exe c:\[Link] /page=3

Open page number 3 from the multipage image 'c:\[Link]'.

Example for /display:

i_view32.exe c:\[Link] /display=(100,100,300,300,50,0,0)

Load image and set window position and size, zoom to 50%, scroll positions to 0.
i_view32.exe c:\[Link] /display=(,,300,,50,30,30)
Load image and set window width, zoom to 50%, scroll positions to 30 (height and position = default/old).

Example for /crop:

Start corner values: 0 = Left top, 1 = Right top, 2 = Left bottom, 3 = Right bottom, 4 = Center.
i_view32.exe c:\[Link] /crop=(10,10,300,300,0)
Open 'c:\[Link]' and crop: x-start=10, y-start=10, width=300, height=300, corner = Left top (in pixels).
i_view32.exe c:\[Link] /crop=(10,10,300,300,4) /convert=c:\[Link]
Open 'c:\[Link]' and crop: x-start=10, y-start=10, width=300, height=300, corner = center.

Example for /print:

i_view32.exe c:\[Link] /print

Open 'c:\[Link]', print the image to default printer and close IrfanView.

i_view32.exe c:\[Link] /print="Printer Name"

Open 'c:\[Link]', print the image to specific printer and close IrfanView.

i_view32.exe c:\*.jpg /print

Print all JPGs from "C:\" and close IrfanView.

Note: The actual settings from the INI file are used.

Example for /resize:

i_view32.exe c:\[Link] /resize=(300,300) /resample

Open 'c:\[Link]' and resample: width=300, height=300.
(Note: Resample uses the active resample filter from the INI file.)

i_view32.exe c:\[Link] /resize=(300,300) /aspectratio

Open 'c:\[Link]' and resize: width= max. 300, height= max. 300, proportional.

i_view32.exe c:\[Link] /resize_long=300 /aspectratio /resample

Open 'c:\[Link]' and resample: long side=300, short side=proportional.

i_view32.exe c:\[Link] /resize=(300,0)

Open 'c:\[Link]' and resize: width=300, height=original.

i_view32.exe c:\[Link] /resize=(300,0) /aspectratio

Open 'c:\[Link]' and resize: width=300, height=proportional.

i_view32.exe c:\[Link] /resize=(150p,150p)

Open 'c:\[Link]' and resize: width=150%, height=150%.

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 5 of 9

Example for /capture:

i_view32.exe /capture=0
Capture the whole screen.
i_view32.exe /capture=6
Start in Capture mode, use last used capture dialog settings.
i_view32.exe /capture=7
Capture the screen rectangle from GUI/Capture dialog (=INI values).
i_view32.exe /capture=7=(0,0,800,600)
Capture the screen rectangle: x (0), y (0), width (800), height (600).

capture values:
0 = whole screen
1 = current monitor, where mouse is located
2 = foreground window
3 = foreground window - client area
4 = rectangle selection
5 = object selected with the mouse
6 = start in capture mode (can't be combined with other commandline options)
7 = fixed rectangle (using capture dialog values or direct input)

Advanced examples:
i_view32.exe /capture=2 /convert=c:\[Link]
Capture foreground window and save result as file.
i_view32.exe /capture=2 /convert=c:\capture_$U(%d%m%Y_%H%M%S).jpg
Capture foreground window and save result as file; the filename contains time stamp.

Example for /ini:

i_view32.exe c:\[Link] /ini="c:\temp\"

i_view32.exe /ini
i_view32.exe c:\[Link] /ini

Example for /clippaste:

i_view32.exe /clippaste
i_view32.exe /clippaste /convert=c:\[Link]

Example for /clipcopy:

i_view32.exe c:\[Link] /clipcopy

i_view32.exe c:\[Link] /clipcopy /killmesoftly

Example for /invert:

i_view32.exe c:\[Link] /invert

Example for /dpi:

i_view32.exe c:\[Link] /dpi=(72,72)

Example for /scan:

With the scan command, you can only combine: /print, /dpi, /gray and /convert.
i_view32.exe /scan
i_view32.exe /scanhidden
i_view32.exe /scanhidden /dpi=(150,150)
i_view32.exe /scan /convert=c:\[Link]
i_view32.exe /scan /append=c:\[Link]

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 6 of 9

i_view32.exe /scan /append=c:\[Link]

i_view32.exe /scanhidden /convert=c:\[Link]
i_view32.exe /scanhidden /gray /convert=c:\[Link]
i_view32.exe /print /scan

Example for /batchscan=(options):

options = all 8 options from the batch scanning dialog:

filename, index, increment, digits, skip, dest-folder, save-extension, multi-tif
i_view32.exe /batchscan=(scanfile,1,1,2,1,c:\temp,bmp,0)
i_view32.exe /batchscan=(scanfile,1,1,2,1,c:\temp,bmp,0) /dpi=(150,150)
i_view32.exe /batchscan=(scanfile,1,1,2,0,c:\temp,tif,1)
i_view32.exe /batchscan=("crazy, filename",1,1,2,0,"c:\temp\crazy, (folder)",tif,1)
i_view32.exe /batchscan=(scanfile,1,1,2,1,c:\temp,bmp,0) /scanhidden

Example for /bpp:

i_view32.exe c:\[Link] /bpp=8

Open 'c:\[Link]' and reduce to 256 colors. Supported BPP-values: 1, 4, 8 and 24 (decrease/increase color
depth).

Example for /filepattern:

i_view32.exe c:\images\ /filepattern="*.jpg"

Go to folder "'c:\images" and load JPGs only in the browse/file list.

i_view32.exe c:\images\ /thumbs /filepattern="*.jpg"

Go to folder "'c:\images" and show JPG thumbnails only.

i_view32.exe c:\images\ /thumbs /filepattern="123*.jpg"

Go to folder "'c:\images" and show JPG with names "123*" as thumbnails.

i_view32.exe c:\images\ /filepattern="*.jpg;*.gif;*.png"

Go to folder "'c:\images" and load only JPG, GIF and PNG files in the browse/file list.

Example for /effect=(effect-nr,param1,param2)::

i_view32.exe c:\[Link] /effect=(6,3,0)

Apply Median filter, parameter = 3.

i_view32.exe c:\[Link] /effect=(2,3,50)

Apply Blur-2 filter, parameter1 = 3, parameter2 = 50.

effect-nr values: (from Effect-Browser dialog):

1 = Blur
2 = Gaussian Blur
...
42 = Color Temperature
80 = AltaLux

Example for /sharpen:

i_view32.exe c:\[Link] /sharpen=33

Example for /hide:

Values (can be combined (add values)):

Toolbar 1
Status bar 2

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 7 of 9

Menu bar 4
Caption 8
i_view32.exe c:\[Link] /hide=1
Open 'c:\[Link]', hide toolbar only.
i_view32.exe c:\[Link] /hide=3
Open 'c:\[Link]', hide toolbar and status bar.
i_view32.exe c:\[Link] /hide=12
Open 'c:\[Link]', hide caption and menu bar.
i_view32.exe c:\[Link] /hide=15
Open 'c:\[Link]', hide all.

Example for /info:

i_view32.exe c:\[Link] /info=c:\[Link]

i_view32.exe c:\[Link] /info=c:\[Link] /fullinfo
i_view32.exe c:\*.jpg /info=c:\[Link]

Example for /append:

i_view32.exe c:\[Link] /append=c:\[Link]

i_view32.exe c:\[Link] /append=c:\[Link]
Open 'c:\[Link] ' and append it as page to 'c:\[Link]'.

Example for /multitif: (/multipdf is similar/identical)

Syntax: /multitif=(tifname,file1,...,fileN)
First file is the name of the result TIF file, wildcards for file1-N are allowed.
i_view32.exe /multitif=(c:\[Link],c:\[Link],c:\[Link])
Create multipage TIF ('c:\[Link]') from 2 other files.
i_view32.exe /multitif=(c:\[Link],c:\*.bmp)
i_view32.exe /multitif=(c:\[Link],filelist=c:\[Link])
i_view32.exe /multitif=(c:\[Link],c:\*.bmp,c:\[Link],c:\123*.gif)

Example for /panorama:

Syntax: /panorama=(X,file1,...,fileN)
First parameter (X) is the direction: 1 = horizontal, 2 = vertical, wildcards for file1-N are allowed.
i_view32.exe /panorama=(1,c:\[Link],c:\[Link])
Create horizontal panorama image from 2 other files.
i_view32.exe /panorama=(1,c:\[Link],c:\*.bmp)
i_view32.exe /panorama=(2,c:\[Link],c:\*.bmp,c:\[Link],c:\123*.gif)
i_view32.exe /panorama=(2,c:\[Link],"c:\crazy, comma [Link]")
i_view32.exe /panorama=(2,filelist=c:\[Link])

Example for /jpgq:

i_view32.exe c:\[Link] /jpgq=75 /convert=c:\[Link]

Open 'c:\[Link]' and save it as 'c:\[Link]', quality = 75. Quality range: 1 - 100.

Example for /tifc:

i_view32.exe c:\[Link] /tifc=4 /convert=c:\[Link]

Open 'c:\[Link]' and save it as 'c:\[Link]', compression = Fax4.
Compressions: 0 = None, 1 = LZW, 2 = Packbits, 3 = Fax3, 4 = Fax4, 5 = Huffman, 6 = JPG, 7 = ZIP.

Example for /wall:

i_view32.exe c:\[Link] /wall=0

Open 'c:\[Link]' and set is as wallpaper (centered).

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 8 of 9

wall values: 0 (centered), 1 (tiled), 2 (stretched), 3 (stretched-proportional)

i_view32.exe c:\images\*.jpg /random /wall=0 /killmesoftly
i_view32.exe /filelist=c:\[Link] /random /wall=0 /killmesoftly
Get random file from the folder/list and set as wallpaper.

Example for /extract:

i_view32.exe c:\[Link] /extract=(c:\temp,jpg)

Open 'c:\[Link]' and save all pages to folder 'c:\temp' as single JPGs.
i_view32.exe c:\*.tif /extract=(c:\temp,jpg)
i_view32.exe /filelist=c:\[Link] /extract=(c:\temp,jpg)
i_view32.exe c:\[Link] /extract=(c:\temp,bmp)

Example for /hotfolder:

i_view32.exe /hotfolder="c:\input\"
Scan 'c:\input\' folder for new images and display them. Uses timer settings from the Hotfolder menu/dialog.
i_view32.exe "c:\input\[Link]" /fs /hotfolder="c:\input\"
Display an image in fullscreen mode, wait for new files in 'c:\input\' folder and display them.

Example for EXE slideshow:

[Link] /monitor=2
=> start standalone slideshow on monitor 2.
[Link] /window=(0,0,800,600)
=> start standalone slideshow in top left corner, window size 800x600.
[Link] /monitor=2 /clearmonitors
=> Start standalone slideshow on monitor 2, clear monitor 1 (and all other monitors).

Example for /advancedbatch:

i_view32.exe c:\[Link] /advancedbatch /convert=c:\[Link]

(some Misc. Advanced Batch options are not supported: overwrite, delete, subfolders, all pages)
Open c:\[Link]', apply Advanced Batch options from the INI file and save as new file.

Example for /jpg_rotate=(options):

options = all 8 options from the JPG lossless dialog:

transformation, optimize, EXIF date, current date, set DPI, DPI value, marker option, custom markers
Note: this option will overwrite the original file(s)!
Values:
Transformation : None (0), Vertical (1) ... Auto rotate (6)
Optimize : 0 or 1
Set EXIF date : 0 or 1
Keep current date : 0 or 1
Set DPI : 0 or 1
DPI value : number
Marker option : Keep all (0), Clean all (1), Custom (2)
Custom markers values (can be combined (add values)):
Keep Comment 1
Keep EXIF 2
Keep IPTC 4
Keep others 8
i_view32.exe c:\[Link] /jpg_rotate=(6,1,1,0,1,300,0,0) /cmdexit
=> Auto rotate, optimize, set EXIF date as file date, set DPI to 300, keep all markers
i_view32.exe c:\[Link] /jpg_rotate=(6,1,1,0,0,0,2,6) /cmdexit
=> Auto rotate, optimize, set EXIF date as file date, keep EXIF and IPTC markers
i_view32.exe c:\[Link] /jpg_rotate=(3,1,0,1,0,0,1,0) /cmdexit

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm
Command Line Options Page 9 of 9

=> Rotate 90, optimize, use current file date, clean all markers
i_view32.exe c:\images\*.jpg /jpg_rotate=(6,1,1,0,0,0,0,0) /cmdexit
=> For all JPGs: Auto rotate, optimize, set EXIF date as file date, keep all markers

mk:@MSITStor[Link]\PROGRA~1\IRFANV~1\I_VIEW32.CHM::/hlp_command_line.htm