-------------------------------------------------------------------------------
File : 'options.txt' - Command line options for IrfanView
Author: Irfan Skiljan
E-Mail:
irfanview@gmx.net
WWW :
http://www.irfanview.com
-------------------------------------------------------------------------------
List of all command line options 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 IrfanView window to x,y
/convert=filename - convert input file(s) to "filename" and CLOSE IrfanView
(Note: See pattern help file page for more options)
/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
/thumbs - open Thumbnails window
/killmesoftly - close all IrfanView instances (exit after command line)
/closeslideshow - close slideshow and IrfanView after the last image
/page=X - open page number X from a multipage input image
/crop=(x,y,w,h) - crop input image: x-start, y-start, width, height
/print - print to default printer and CLOSE IrfanView
/print="Name" - print 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)
/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 messages for command line read/save errors
/invert - invert input image (negative)
/dpi=(x,y) - change image 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 Scan, 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
/rotate_l - rotate input image to left
/hflip - horizontal flip
/vflip - vertical flip
/filepattern="x" - browse only specific files
/effect=(x,p1,p2) - apply effect filter X, see below for examples
/sharpen=X - open image and apply the sharpen filter value X
/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)
/transpcolor=(r,g,b) - set transparent color if saving as GIF/PNG/ICO
/hide=X - hide toolbar, status bar, menu and/or caption of the main window
/aspectratio - used for resizes: keep image proportions
/info=txtfile - write image infos to "txtfile"
/fullinfo - used for /info, write EXIF, IPTC and Comment data
/append=tiffile - append image as (TIF) page to "tiffile"
/multitif=(tif,files) - create multipage TIF 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 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
/monitor=X - start EXE-Slideshow on monitor X
/window=(x,y,w,h) - set EXE-Slideshow window position and size
Important notes:
- Only lower case options are supported (don't type any UPPERCASE letters) !
- Input file name (if required) is always the first parameter!
- Use "" for file names with spaces, example: "c:\images\dummy test file.jpg"
- Write always the FULL paths for file names (incl. drive letter)
- You can combine several options in one command
- Wildcards supported only for /convert, /print, /info and /jpg_rotate
- Maximal command line length is limited by Windows, so use shorter names/paths.
- Most settings are loaded from the INI file. Using prepared INIs and /ini 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 error.
Example for conversion:
i_view32.exe c:\test.bmp /convert=c:\giftest.gif
=> Convert file: 'c:\test.bmp' to 'c:\giftest.gif' 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 /filelist=c:\mypics.txt /resize=(500,300) /aspectratio /resample /convert=d:\temp\*.png
i_view32.exe c:\test.bmp /convert=c:\test_$Wx$H.jpg
i_view32.exe c:\test.bmp /resize=(100,100) /resample /aspectratio /convert=d:\$N_thumb.jpg
i_view32.exe c:\test.bmp /convert=c:\temp\$T(%Y%m%d)\test_$Wx$H.jpg
i_view32.exe c:\test.bmp /convert=$D$N.jpg
i_view32.exe c:\*.bmp /convert=$D$N.jpg
i_view32.exe c:\*.jpg /advancedbatch /convert=c:\temp\*.jpg
i_view32.exe c:\test.bmp /transpcolor=(255,255,255) /convert=c:\giftest.gif
(Note: supported are all IrfanView read/save formats except audio/video)
Example for slideshow:
i_view32.exe /slideshow=c:\mypics.txt
(Note: The file 'c:\mypics.txt' contains, in each line, a name of an image file,
including the full path OR path relative to "i_view32.exe")
i_view32.exe /slideshow=c:\mypics.txt /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
Note: you have to close IrfanView after the last image from the TXT file, if no /closeslideshow is used.
Example for closeslideshow:
i_view32.exe /slideshow=c:\mypics.txt /closeslideshow
=> IrfanView will be closed after the last image from 'c:\mypics.txt'
Example for thumbnails:
i_view32.exe c:\test\image1.jpg /thumbs
=> open 'image1.jpg' and display thumbnails from directory 'c:\test'
i_view32.exe c:\test /thumbs
=> display thumbnails from directory 'c:\test'
i_view32.exe /filelist=c:\mypics.txt /thumbs
=> load filenames from TXT file and display as thumbnails
Example for filelist:
i_view32.exe /filelist=c:\mypics.txt
i_view32.exe /filelist=c:\mypics.txt /convert=d:\test\*.jpg
i_view32.exe /filelist=c:\mypics.txt /thumbs
Example for close:
i_view32.exe /killmesoftly
=> close IrfanView and terminate all instances
Example for page:
i_view32.exe c:\test.tif /page=3
=> Open page number 3 from the multipage image 'c:\test.tif'
Example for crop:
i_view32.exe c:\test.jpg /crop=(10,10,300,300)
i_view32.exe c:\test.jpg /crop=(10,10,300,300) /convert=c:\giftest.gif
=> Open 'c:\test.jpg' and crop: x-start=10, y-start=10, width=300, height=300
Example for print:
i_view32.exe c:\test.jpg /print
=> Open 'c:\test.jpg', print the image to default printer and close IrfanView
i_view32.exe c:\test.jpg /print="Printer Name"
=> Open 'c:\test.jpg', 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 current settings from the INI file are used.
Example for resize:
i_view32.exe c:\test.jpg /resize=(300,300) /resample
=> Open 'c:\test.jpg' and resample: width=300, height=300
(Note: Resample uses the the active resample filter from the INI file)
i_view32.exe c:\test.jpg /resize=(300,300) /aspectratio
=> Open 'c:\test.jpg' and resize: width = max. 300, height = max. 300, proportional
i_view32.exe c:\test.jpg /resize=(300,0) /aspectratio
=> Open 'c:\test.jpg' and resize: width=300, height=proportional
i_view32.exe c:\test.jpg /resize_long=300 /aspectratio /resample
=> Open 'c:\test.jpg' and resample: long side=300, short side=proportional
i_view32.exe c:\test.jpg /resize=(300,0)
=> Open 'c:\test.jpg' and resize: width=300, height=original
i_view32 c:\test.jpg /resize=(150p,150p)
=> Open 'c:\test.jpg' and resize: width=150%, height=150%
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
capture values:
0 = whole screen
1 = current monitor
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)
Advanced examples:
i_view32.exe /capture=2 /convert=c:\test.jpg
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; file name contains time stamp.
Example for ini:
i_view32.exe /ini
i_view32.exe c:\test.jpg /ini
i_view32.exe c:\test.jpg /ini="c:\temp\"
Example for clipboard paste:
i_view32.exe /clippaste
i_view32.exe /clippaste /convert=c:\test.gif
Example for clipboard copy:
i_view32.exe c:\test.jpg /clipcopy
i_view32.exe c:\test.jpg /clipcopy /killmesoftly
Example for /invert:
i_view32.exe c:\test.jpg /invert
Example for /dpi:
i_view32.exe c:\test.jpg /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:\test.gif
i_view32.exe /scanhidden /convert=c:\test.gif
i_view32.exe /scanhidden /gray /convert=c:\test.gif
i_view32.exe /print /scan
Example for /batchscan=(options):
options = 8 options from the batch scan 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:\test.jpg /bpp=8
Supported BPP-values: 1, 4, 8 and 24 (decrease/increase color depth)
=> Open 'c:\test.jpg' and reduce to 256 colors
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
Example for /effect=(effect-nr,param1,param2):
i_view32.exe c:\test.jpg /effect=(6,3,0)
=> apply Median filter, parameter = 3
i_view32.exe c:\test.jpg /effect=(2,3,50)
=> apply Blur-2 filter, parameter1 = 3, parameter2 = 50
effect-nr values: (from Effect-Browser dialog)
1 = Blur
2 = Blur-2
...
37 = Metallic Ice
Example for /sharpen:
i_view32.exe c:\test.jpg /sharpen=33
Examples for /hide:
Values (can be combined (add values)):
Toolbar 1
Status bar 2
Menu bar 4
Caption 8
i_view32.exe c:\test.jpg /hide=1
=> Open 'c:\test.jpg', hide toolbar only
i_view32.exe c:\test.jpg /hide=3
=> Open 'c:\test.jpg', hide toolbar and status bar
i_view32.exe c:\test.jpg /hide=12
=> Open 'c:\test.jpg', hide caption and menu bar
i_view32.exe c:\test.jpg /hide=15
=> Open 'c:\test.jpg', hide all
Examples for /info:
i_view32.exe c:\test.jpg /info=c:\test.txt
i_view32.exe c:\*.jpg /info=c:\jpgs.txt
i_view32.exe c:\test.jpg /info=c:\test.txt /fullinfo
Example for /append:
i_view32.exe c:\test.jpg /append=c:\test.tif
=> Open 'c:\test.jpg' and append it as page to 'c:\test.tif'
Example for /multitif:
Syntax: /multitif=(tifname,file1,...,fileN)
First file is the name of the result TIF file.
i_view32.exe /multitif=(c:\test.tif,c:\test1.bmp,c:\dummy.jpg)
=> Create multipage TIF (c:\test.tif) from 2 other files
Example for /panorama:
Syntax: /panorama=(X,file1,...,fileN)
First parameter (X) is the direction: 1 = horizontal, 2 = vertical.
i_view32.exe /panorama=(1,c:\test1.bmp,c:\dummy.jpg)
=> Create horizontal panorama image from 2 other files
Example for /jpgq:
i_view32.exe c:\test.jpg /jpgq=75 /convert=c:\new.jpg
=> Open 'c:\test.jpg' and save it as c:\new.jpg, quality = 75
Quality range: 1 - 100.
Example for /tifc:
i_view32.exe c:\test.jpg /tifc=4 /convert=c:\new.tif
=> Open 'c:\test.jpg' and save it as c:\new.tif, compression = Fax4
Compressions: 0 = None, 1 = LZW, 2 = Packbits, 3 = Fax3, 4 = Fax4, 5 = Huffman,
6 = JPG, 7 = ZIP
Example for wallpaper:
i_view32.exe c:\test.jpg /wall=0
=> Open 'c:\test.jpg' and set is as wallpaper (centered)
wall values: 0 (centered), 1 (tiled), 2 (stretched), 3 (proportional)
i_view32.exe c:\images\*.jpg /random /wall=0 /killmesoftly
i_view32.exe /filelist=c:\mypics.txt /random /wall=0 /killmesoftly
=> get random file from the folder/list and set as wallpaper
Example for /extract:
i_view32.exe c:\multipage.tif /extract=(c:\temp,jpg)
=> Open 'c:\multipage.tif' and save all pages to folder 'c:\temp' as JPGs
Examples for EXE slideshow:
MySlideshow.exe /monitor=2
=> Start standalone slideshow on monitor 2
MySlideshow.exe /window=(0,0,800,600)
=> Start standalone slideshow in top left corner, window size 800x600
Example for /advancedbatch:
i_view32.exe c:\test.jpg /advancedbatch /convert=c:\image.jpg
(some Misc. Advanced Batch options are not supported: overwrite, delete, subfolders, all pages)
=> Open 'c:\test.jpg', 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:\test.jpg /jpg_rotate=(6,1,1,0,1,300,0,0)
=> Auto rotate, optimize, set EXIF date as file date, set DPI to 300, keep all markers
i_view32.exe c:\test.jpg /jpg_rotate=(6,1,1,0,0,0,2,6)
=> Auto rotate, optimize, set EXIF date as file date, keep EXIF and IPTC markers
i_view32.exe c:\test.jpg /jpg_rotate=(3,1,0,1,0,0,1,0)
=> 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)
=> For all JPGs: Auto rotate, optimize, set EXIF date as file date, keep all markers