IrfanView Command Line Options

From ETCwiki
Jump to: navigation, search

This page is a direct copy from the official IrfanView help file that comes with IrfanView. This info was pulled from IrfanView 4.27 in October 2010.

IrfanView Command Line

IrfanView 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 
/convert=filename -        convert input file to 'filename' and CLOSE IrfanView  
(see Pattern page for additional filename 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 -        force thumbnails 
/killmesoftly -        close all IrfanView instances 
/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) -        crop input image: x-start, y-start, width, height 
/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) 
/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 
/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 
/aspectratio -        used for /resize and /resample, 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) 
/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 

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=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.


IrfanView File Conversion

Convert file: 'c:\test.bmp' to 'c:\test.jpg' without GUI.

i_view32.exe c:\test.bmp /convert=c:\test.jpg

Examples:

i_view32.exe c:\*.jpg /convert=d:\temp\*.gif
i_view32.exe c:\*.jpg /resize=(500,300) /convert=d:\temp\*.png
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:\*.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.)


IrfanView Slideshow:

i_view32.exe /slideshow=c:\mypics.txt

(Note: The file 'c:\mypics.txt' contains, in each line, a name of an image, including the full path OR path relative to "i_view32.exe".)


Slideshow Examples

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

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:\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'. Display thumbnails from directory 'c:\test'.

i_view32.exe c:\test\ /thumbs


Load filenames from TXT file and display as thumbnails.

i_view32.exe /filelist=c:\mypics.txt /thumbs


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: Close IrfanView and terminate all instances.

i_view32.exe /killmesoftly



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 (in pixels).


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 actual 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 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_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.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=(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, 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)


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; the 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 /clippaste:


i_view32.exe /clippaste

i_view32.exe /clippaste /convert=c:\test.gif


Example for /clipcopy:


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 /gray /convert=c:\test.gif

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:\test.jpg /bpp=8

Open 'c:\test.jpg' 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.


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


Example 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.


Example for /info:


i_view32.exe c:\test.jpg /info=c:\test.txt

i_view32.exe c:\test.jpg /info=c:\jpgs.txt /fullinfo

i_view32.exe c:\*.jpg /info=c:\jpgs.txt


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 images.


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 /wall:


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 (stretched-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 single JPGs.


Example 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