ImgWorks - Command Line

Contents->Command Line

Usage

The [path(s)...] specifies the paths to the file(s) and/or directory(ies) to queue on the source list at startup.

[options]can be any of the following:

`[options]`	Description
`--formats`	Prints a list of supported image formats and exits
`--help`	Prints the help screen and exits
`--version`	Prints the version and exits

[GUI_options] can be any of the following:

`[GUI_options]`	Description
`--geometry <WxH+X+Y>`	Specifies the geometry of the windows
`--fn <font>`	Specifies the font to be used for the lists
`--fg <color>`	Specifies the foreground color for the lists
`--bg <color>`	Specifies the background color for the lists
`--sfg <color>`	Specifies the selected foreground & text color for the lists
`--sbg <color>`	Specifies the selected background & base color for the lists
`--cfg <color>`	Specifies the pointer cursor's foreground color
`--cbg <color>`	Specifies the pointer cursor's background color
`--bg-pixmap <path>`	Specifies the background pixmap for the lists
`--sbg-pixmap <path>`	Specifies the selected background pixmap for the lists
`--name <name>`	Specifies the WM window name
`--class <class>`	Specifies the WM class name
`--title <title>`	Specifies the title to be displayed on the title bars

[GUI_options] can be any options standard to your GUI, consult your GUI's manual for available options.

<path(s)...> specifies the file(s) and/or directory(ies) to scan in text mode (used with --scan only).

Command line options override any options in the configuration file.

Environment Variable	Description
`DISPLAY`	Specifies the host address, display number, and screen number to connect to the X server
`PATH`	Specifies the search path, a string containing a list of paths separated by `;` characters
`USERNAME`	Specifies the user's name
`USER`	Fallback for `USERNAME`
`HOME`	Specifies the absolute path to the user's home directory
`EDITOR`	Specifies the command to execute the prefered text editor
`EDIT`	Fallback for `EDITOR`
`VIEWER`	Specifies the command to execute the prefered file viewer
`VIEW`	Fallback for `VIEWER`
`BROWSER`	Specifies the command to execute the prefered web browser
`HELPBROWSER`	Specifies the command to execute the prefered help browser (if this is not set then it will fallback to `BROWSER`)
`TMPDIR`	Specifies the path to the tempory files directory (default value is `/tmp`)

Return Value	Description
`0`	Success
`1`	General error
`2`	Bad value
`3`	Systems error or memory allocation error
`4`	User aborted
`5`	An identical operation is already in progress
`6`	Segmentation fault