Annex B - Command Line Startup Parameters

Top  Previous  Next

IDimager can be started from the command line with the following parameters:

 

-downloader

Starts IDimager and opens the Downloader on startup

-camwiz

Identical as -downloader

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -camwiz

 

Optionally enter a name of the download profile that should be started by separating it with a semi colon;

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe "-downloader:my profile"

 

-i <<script name>>

Start IDimager and run the script as specified. The script can either have the extension .psc (quick script) as .idscript (GUI script)

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -i "C:\Script Files\MyScript.idscript"

 

-autoclose

Start IDimager and close it afterwards. The recommended way to use this is to start IDimager with other parameters so that the application is closed after the parameter is processed.

 

-a <<data files folder>>

IDimager will store all data files (like options file, custom XMP designs, etc) in the Windows local user's data folder (%appdata% under XP and %localappdata% under Vista). With this startup parameter you can change the folder that should be used. Once you set this parameter, IDimager will search for the data files in that folder.

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -a "d:\my data folder"

 

-o <<options file>>

By default IDimager starts the application and will load the file Options.imb as you active option settings. With this parameter you will be able to start IDimager with different option settings by passing the options file to the command line.

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -o "c:\My Settings\network options.imb"

 

-folder <<foldername>>

By default IDimager will restore the Catalog Explorer to the last visited item in the tree. By specifying this start up command you'll be able to force IDimager to open in a specific catalog folder (not media folder). If your folder name contains spaces then you should enclose the folder name in double quotes.

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -folder "C:\Users\Havezet\Desktop"

 

-portable

Use the -portable parameter to start IDimager in a mode where it won't store any of its data on the computer but instead store its data on the medium (e.g. a USB memory stick) where IDimager is ran from. This includes temporary data as well as registry key settings.

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -portable"

 

-regfile

When this option is specified, IDimager will not store any data to the registry but to a local file instead (in the application's data folder. You can specify the name of the file that you want to use.

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -regfile "mydata.idreg"

 

 

Every parameter can be combined with other parameters. For example to close IDimager after running a script you could use this:

 

C:\Program Files\IDimager Products\IDimager\IDimager.exe -i c:\myscript.psc -autoclose -folder "C:\My Pictures"

 

 

The Professional SQLServer Edition also allows you to enter the login details directly on the command line. That way you can bypass the login screen or easily start IDimager in Windows batch files.

 

-S <<SQLserver instance name>>

 

Specify the name of the SQLServer instance you want to connect to. By default this is .\SQLExpress

 

-D <<database name>>

 

Specify the name of the database within the SQLServer instance. By default this is IDimager

-U <<username>>

 

Specify the IDimager-username that should be used to login. The Professional Edition requires this to be admin

-P <<password>>

 

Specify the login password for the IDimager-username

-T <<thumbs folder>>

(optional) Specify the folder location for the thumbnails database

 

 

 

 

 

-TD

Specify the name of the database within the SQLServer instance . By default this is idimagerthumbs

 

By default IDimager uses a SQLite database to store the thumbnails (even in Pro-SQLServer). However, it is possible to use a SQLServer version of the thumbnails database.

 

The requirement is that the SQLserver thumbnail database is created within the same SQLServer instance that also hosts your IDimager database.

 

To create new SQLServer based database, then download and run the file SQLServerThumbs.sql in your SQLServer console. First check the file paths in this script to make sure they are configured in the way you want it to be. Find the SQLServerThumbs.sql file in the sub folder ...\IDimager\Tools\others

 

Only use this command line startup parameter after you have set up the thumbnail database

 

 

 

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -S .\SQLExpress -D IDimager -U admin -P master2004

 

The Professional Desktop Edition also allows you to enter the login details directly on the command line to bypass the login dialog.

 

-D <<database name>>

 

Specify the path and name of the SQLite database.

-U <<username>>

 

Specify the IDimager-username that should be used to login. The Professional Edition requires this to be admin

-P <<password>>

 

Specify the login password for the IDimager-username

-T <<thumbs folder>>

(optional) Specify the folder location for the thumbnail database

 

 

Example:

C:\Program Files\IDimager Products\IDimager\IDimager.exe -D "c:\IDimager Catalog\idimager.cat.db" -U admin -P master2004