UI-less Settings

Introduction

UI-less Settings are settings that do not have any user interface in XnView to change the state of the setting. The only way to change these settings is to manually edit the XnView configuration file "xnview.ini" or XnView settings in the Windows registry "HKEY_CURRENT_USER\Software\XnView". See Settings and Ini Files and Info about XnView's settings for more information on how to edit and locate these settings.

All settings are grouped into sections and each title in the list corresponds to a section in the INI-file or a subkey in XnView's registry key. E.g. Settings under the Browser title should be added under the "[Browser]" section in the "xnview.ini" file or in the "HKEY_CURRENT_USER\Software\XnView\Browser" registry key. When adding settings to the registry, you should use a (REG_DWORD) value type for boolean & integer values and a (REG_SZ) type for string values.

Browser

AlphaForThumbnail

When enabled, XnView uses alpha transparency in thumbnails.

Value: Boolean (1/0), enabled by default

Regression ==> viewtopic.php?t=23352

BColorFilter## (01-xx)

Changes the file name label background color of specified file-types in XnView's browser file pane.

Value: Formatted string [type, R G B] or [*.ext, R G B], all possible "type" format values are set by default

Example: BColorFilter01=jpeg, 237 237 202 or BColorFilter01=*.txt, 212 208 200

See also ColorFilter## setting

CheckNetFolder

When enabled, XnView will check if subfolders exist on network drives when updating the folder tree pane in XnView's browser.

Value: Boolean (1/0), disabled by default

Regression ==> viewtopic.php?t=11011

See also ExpandUNC setting

ColorFilter## (01-xx)

Changes the file name label text color of specified file-types in XnView's browser file pane.

Value: Formatted string [type, R G B] or [*.ext, R G B]

Example: ColorFilter01=jpeg, 25 25 25 or ColorFilter01=*.txt, 10 200 10

See also BColorFilter## setting

ColorLabel-# (0-4)

Overrides the default color category names.

Important

Work

Personal

To do

Later

Value: String

See also RatingLabel-# setting

ExpandUNC

When enabled, XnView always expands UNC network paths in the folder tree pane in XnView's browser.

Value: Boolean (1/0), disabled by default

See also CheckNetFolder setting

FolderColor# (1-5)

Changes the colors of folder thumbnails.

1. Top color of the gradient area
2. Bottom color of the gradient area
3. Outline color of the folder tab
4. Background color of the folder tab
5. Color of the left and right edges

Value: Raw color (integer) or formatted color string

See also SelBorderColor setting

Note: Changes to folder colors might not be visible until the folder thumbnails are rebuilt.

HistoBColor

Changes the background color of the histogram panel in XnView's browser.

Value: Raw color (integer) or formatted color string

LabelColor_## (01-10)

Changes the text and background color of thumbnail labels in thumbnail & labels view mode.

Value: Formatted string [text color, back color] <> [R G B, R G B]

Example: LabelColor_03=255 255 255, 0 0 0

LockLayout

When enabled, XnView will lock the browser layout so the user cannot resize preview, folder tree or file pane.

Value: Boolean (1/0), disabled by default

NoDelayedPreview

When enabled, XnView does not have a delay between image previews when switching files with the arrow keys in XnView's browser.

Value: Boolean (1/0), disabled by default

See also TimerForPreview setting

OldSortMethod

When disabled, XnView will use the same sort order as Explorer on Windows XP and later: File names are sorted based on numerical value (3 < 22 < 111).

When enabled, XnView will use the same sort order as Explorer on Windows 2000 and earlier: File names are sorted literally (111 < 22 < 3).

Value: Boolean (1/0), disabled by default

Added in v2.25

OpenNone

Custom list of file-type extensions that XnView should not open.

Value: String, space separated list

Example: OpenNone=DB SYS COM BAT

OpenWithAssociatedProgram

Custom list of file-type extensions that XnView should open with their associated programs.

Value: String, space separated list

OpenWithXnView

Custom list of file-type extensions that should be opened in XnView.

Value: String, space separated list

RatingLabel-# (0-4)

Overrides the default rating category names.

Bad

Below average

Average

Good

Excellent

Value: String

See also ColorLabel-# setting

SelBorderColor

Changes the color of the selection frame around the selected thumbnail.

Value: Raw color (integer) or formatted color string

See also FolderColor# settings

SelectPrevFolder

When enabled, XnView automatically selects the previous directory you were in when moving back to a parent folder.

Value: Boolean (1/0), enabled by default

SharpenValue

Changes the thumbnail sharpening level in XnView browser.

Value: Integer (1-100), default value is 50

Note: This setting only takes effect if thumbnail sharpening is enabled.

Note 2: This change might not be visible until the thumbnails are rebuilt.

TimerForPreview

Changes the delay between image previews in XnView's browser when switching files with the arrow keys.

Value: Integer, time in milliseconds, default value is 200

See also NoDelayedPreview setting

TreeBackColor

Changes the background color of the folder tree pane in XnView's browser.

Value: Raw color (integer) or formatted color string

TreeFontColor

Changes the text color of the folder tree pane in XnView's browser.

Value: Raw color (integer) or formatted color string

TreeFontHiColor

Changes the highlighted text color of the folder tree pane in XnView's browser.

Value: Raw color (integer) or formatted color string

TreeFontHiColor2

Changes the inactive highlighted text color of the folder tree pane in XnView's browser.

Value: Raw color (integer) or formatted color string

TxtBackColor

Changes the background color of the preview pane when previewing text files.

Value: Raw color (integer) or formatted color string

See also TxtForeColor setting

TxtExt

List of file-type extensions that are shown as "text thumbnails" and previewed as text in XnView's browser.

Value: String, space separated list, default value is "txt c c++ cc h cpp pas js css php ini"

TxtForeColor

Changes the text color of the preview pane when previewing text files.

Value: Raw color (integer) or formatted color string

See also TxtBackColor setting

VideoFormat

Determines how thumbnails are extracted

MOV & MP4 are extracted using QuickTime

MOV is extracted using DirectX

n/a

MP4 is extracted using DirectX

MOV & MP4 are extracted using DirectX

Value: Integer, default value is 1

Added in v2.33

VideoFramePercent

Changes the frame from which video thumbnails are extracted.

Value: Integer (percent), default is 10

Note: This change might not be visible until the thumbnails are rebuilt.

Canvas

Height

Height for custom size selection of the canvas resize tool.

Value: Integer

Width

Width for custom size selection of the canvas resize tool.

Value: Integer

Capture

ImportFormat

Changes the clipboard format when pasting images from the clipboard or capturing images with the capture tool.

Value: Integer, 0 => CF_BITMAP & CF_DIB, 1 => CF_DIB & CF_BITMAP

Compare

BackColor

Changes the background color of the image compare tool.

Value: Raw color (integer) or formatted color string

Text

Changes the information shown on the top left corner of the image compare tool.

Value: Formatted string. Supports the same placeholders as thumbnail tooltips, etc.

Example: Text=<Filename>||<Size> bytes||<Width>x<Height>

File

Companion_## (00-100)

Custom companion file extension pair. File operations such as move, copy and delete on the first file-type will also effect the companion file with the other file-type extension.

Value: Formatted string [ext1:ext2]

Example: Companion_00=cr2:jpg

CopyNameOld

Unknown. Possibly obsolete.

HiddenDescription

When enabled, XnView will hide descript.ion files by setting the hidden attribute to the descript.ion files when writing them.

Value: Boolean (1/0), enabled by default

Hidden

Acquire

When enabled, XnView hides Twain and WIA acquire related features.

Value: Boolean (1/0), disabled by default

BatchRename

When enabled, XnView hides and disables the Batch Rename tool.

Value: Boolean (1/0), disabled by default

BrowserContextMenu

When enabled, XnView disables the right-click context menu in the browser.

Value: Boolean (1/0), disabled by default

CommandLine

When enabled, XnView hides the command line help menu item in the info menu.

Value: Boolean (1/0), disabled by default

MenuBar

When enabled, XnView hides the menu bar.

Value: Boolean (1/0), disabled by default

MyDocumentsTree

When enabled, XnView hides the My Documents tree in the folder tree pane.

Value: Boolean (1/0), disabled by default

NetworkTree

When enabled, XnView hides the My Network and Network drive trees in the folder tree pane.

Value: Boolean (1/0), disabled by default

OpenHex

When enabled, XnView hides and disables the hex view mode features.

Value: Boolean (1/0), disabled by default

OpenWith

When enabled, XnView hides the 'Open With' features.

Value: Boolean (1/0), disabled by default

Options

When enabled, XnView hides and disables the options dialog.

Value: Boolean (1/0), disabled by default

OptionsAssociations

When enabled, XnView hides the associations section in the options dialog.

Value: Boolean (1/0), disabled by default

OptionsInstall

When enabled, XnView hides the system integration section in the options dialog.

Value: Boolean (1/0), disabled by default

PathField

When enabled, XnView hides the path field in the browser's file pane.

Value: Boolean (1/0), disabled by default

SaveAs

When enabled, XnView disables the file 'save as' feature.

Value: Boolean (1/0), disabled by default

Search

When enabled, XnView hides and disables the file search tools.

Value: Boolean (1/0), disabled by default

Shell

When enabled, XnView hides the shell open features.

Value: Boolean (1/0), disabled by default

Obsolete: Does not work properly. Use OpenWith instead.

SmallToolbar

When enabled, XnView hides the small toolbar in the browser's file pane.

Value: Boolean (1/0), disabled by default

Obsolete: Small toolbar can be hidden from the view menu.

Wallpaper

When enabled, XnView hides and disables the wallpaper features.

Value: Boolean (1/0), disabled by default

Web

When enabled, XnView hides the website menu items in the info menu.

Value: Boolean (1/0), disabled by default

Load

IcoIn32bits

When enabled, XnView uses 32bit rendering for all color depths in icon files.

Value: Boolean (1/0), enabled by default

OpenWith

Name_# (0-x)

Sets a custom name for the specified 'Open With' tool.

Value: String

Param_# (0-x)

Sets a custom command-line parameters for the specified 'Open With' tool.

Value: String

Note: The %1 placeholder in the string is replaced with the filename used to launch the 'Open With' tool.

Working_# (0-x)

Sets a custom working directory for the specified 'Open With' tool.

Value: String

Print

CustomSize

Adds custom print sizes to the preset sizes list of 'Single - custom' print layout template.

Value: Formatted string [name|WxH;...], semicolon separated list

Example: CustomSize=name1|2.5x2;name2|3x3.23

Resize

Height

Width for custom size selection of the resize tool.

Value: Integer

Width

Width for custom size selection of the resize tool.

Value: Integer

Sharpen

Changes the sharpening level of the resize tool.

Value: Integer (percent), default value is 50

Note: This setting only takes effect if “Apply Sharpen” is enabled.

Save

RgbCompress

Unknown.

Value: Boolean (1/0), enabled by default

Scan

newMethod

When enabled, XnView uses a newer method for the batch scanning tool.

Value: Boolean (1/0), disabled by default

Start

BottomToolbar

When enabled, the main toolbar is shown on the bottom of the main window.

Value: Boolean (1/0), disabled by default

Regression ==> viewtopic.php?t=17016

ClipboardNewMethod

When disabled, XnView will copy alpha channel transparency (32-bit RGBA) as non-premultiplied/unassociated/straight (vs. premultiplied/associated) component (see Transparency – Straight vs. premultiplied alpha).

Value: Boolean (1/0), enabled by default

Added in v2.24

FormatSaveAll

Changes the file format XnView uses when saving new files with the 'Save opened image(s)...' option.

Value: String, default value is PNG

Example: FormatSaveAll=jpeg

GpsMap

Changes the online GPS service XnView uses when viewing the GPS location of geotagged photograph.

Value: String, use placeholder strings [LAT] for Latitude, [LON] for Longitude and [LAN] for Language.

Example: GpsMap=http://maps.google.com/?q=[LAT],[LON]&spn=0.05,0.05&t=h&om=1&hl=[LAN]

Note: Language placeholder is replaced with two-letter (ISO 639) language code. E.g. "en" for English.

NoExtraFiles

When enabled, XnView completely disables the use of category.db file.

Value: Boolean (1/0), disabled by default

NoWIA

When enabled, XnView does not invoke the WIA service at start-up.

Value: Boolean (1/0), disabled by default

OpenWithMax

Changes the maximum number of selected files XnView passes to an application when using 'Open With'.

Value: Integer, default value is 20

QuitNoView

When enabled, CTRL+W keyboard shortcut closes XnView if there aren't any views open.

Value: Boolean (1/0), enabled by default

RecentDirsMax

Changes the number of items shown in the recently used directories list.

Value: Integer, default value is 10

RecentFilesMax

Changes the number of items shown in the 'recent files' list.

Value: Integer, default value is 10

SaveAdvDlg

Description needed.

Value: Integer

SelectedShowAgain

When enabled, XnView does not ask which group (tagged or selected files) to use when deleting files and always performs the delete operation for selected files.

Value: Boolean (1/0), disabled by default

ShowSaveDlg

Description needed.

Value: Bit flags

TagShowFlags

Description needed.

Value: Bit flags

ToolbarBackColor

Changes the background color of the toolbar.

Value: Raw color (integer) or formatted color string

See also UseToolbarBackColor setting

Regression ==> viewtopic.php?t=17005

UseSavedPath

When enabled, XnView suggests the last used file save path for the first save operation of the session.

Value: Boolean (1/0), disabled by default

UseToolbarBackColor

When enabled, XnView uses the custom toolbar background color specified by the ToolbarBackColor option.

Value: Boolean (1/0), disabled by default

See also ToolbarBackColor setting

UseWindowsForINI

When enabled, XnView loads xnview.ini from the Windows directory.

Value: Boolean (1/0), disabled by default

Obsolete: Settings save location can be changed from the XnView options dialog.

View

CheckerColor1

Changes the first color of the checkerboard pattern background.

Value: Raw color (integer) or formatted color string

CheckerColor2

Changes the second color of the checkerboard pattern background.

Value: Raw color (integer) or formatted color string

CheckerSize

Changes the size of squares in the checkerboard pattern background.

Value: Integer, default value is 8

ColorInfo

Changes the behavior of the color information tool.

Show only for the currently viewed image.

Show also for the previous¦next file to view.

Show between sessions.

Value: Integer, default value is 0

CopyClipboard

Changes the data XnView will set in the clipboard when copying an image.

Copy only image data.

Copy image filename and file object.

Copy image data, filename and file object.

Value: Integer, default value is 0

GridType

Changes the display type of the grid coordinate markings.

No coordinate markings.

Shows digits and letters for both the coordinates X and Y.

Shows separately digits for X, and letters for Y.

Value: Integer, default value is 1

LockZoomFlag

Changes the behavior of the 'lock zoom' feature.

Lock zoom status is kept between sessions (default).

Zoom lock status is kept for current session only.

Value: Integer

MaximizeViewWhenOpen

When enabled, XnView will always maximize opened image views.

Value: Boolean (1/0), enabled by default

OldGifAni

When enabled, XnView uses old 8-bit instead of 32-bit decoding for animated GIF files.

Value: Boolean (1/0), disabled by default

OpenWithAsPNG

When enabled, XnView temporarily saves unsaved images in PNG instead of BMP format when opening them in an external application.

Value: Boolean (1/0), disabled by default

ResetXY

Changes the default image X/Y position when viewing images.

Middle of the image.

Top-left of the image.

Top-right of the image.

Value: Integer (0-2), default value is 0

Note: ResetXY setting does have a UI, only value 2 cannot be set through the options dialog.

RightButtonFlag

When enabled, the right mouse button is used for image selection instead of the left one.

Value: Boolean (1/0), disabled by default

Obsolete: Mouse button actions can be changed from the XnView options dialog.

UndoCount

Changes the number of undoable (undo & redo) image changes.

Value: Integer, default value is 5

UseUndo

When enabled, image changes are undoable???

Value: Boolean (1/0), enabled by default

Possibly obsolete. Does not work.

Wallpaper

Filename

Changes the file name XnView uses when saving wallpapers.

Value: String, Example: Filename=wallpaper.jpg

Format

Changes the file format XnView uses when saving wallpapers. Default format is BMP.

Value: String, Example: Format=jpeg