UI-less Settings

Introduction

UI-less Settings are settings that doesn't have any user interface in XnView to change the state of the setting. Only way to modify these settings, is to edit manually the XnView configuration file (xnview.ini) or XnView settings in Windows registry (HKEY_CURRENT_USER\Software\XnView). For more information on how to edit and locate these settings, please read this FAQ topic or this XnView wiki page.

Each title in the list corresponds to a section in INI-file or a subkey in the XnView registry key. E.g. Settings under Browser title should be added under [Browser] section in the xnview.ini file or in the HKEY_CURRENT_USER\Software\XnView\Browser registry key. When adding settings in registry you should use REG_DWORD value type for boolean & integer values and REG_SZ type for string values.

Browser

BColorFilter## (01-xx)

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

Value: Formatted string (type, R G B) or (*.ext, R G B), "type" format colors are set in the settings 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 browser.

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

Broken ==> viewtopic.php?t=11011

ColorFilter## (01-xx)

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

Value: Formatted string (type, R G B) or (*.ext, R G B)

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

See also BColorFilter## setting

ColorLabel-# (0-4)

Overrides the default color category names.

0. Important

1. Work

2. Personal

3. To do

4. LaterValue: String

See also RatingLabel-# setting

FolderColor# (1-5)

Changes the colors of folder thumbnail.

1. Upper main gradient color
2. Lower main gradient color
3. Outline color of folder tab
4. Background color of folder tab
5. Color of vertical edge lines

Value: Raw color (integer) or formatted color string

See also SelBorderColor setting

HistoBColor

Changes the background color of histogram panel in XnView 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 browser layout so user cannot resize preview, folder or file panes.

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

NoDelayedPreview

When enabled, XnView doesn't have a delay between previews when browsing through pictures with arrow keys in XnView browser.

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

See also TimerForPreview setting

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 associated program.

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.

0. Bad

1. Below average

2. Average

3. Good

4. ExcellentValue: String

See also ColorLabel-# setting

SelBorderColor

Changes the color of folder thumbnail selection frame.

Value: Raw color (integer) or formatted color string

See also FolderColor# settings

SelectPrevFolder

When enabled, XnView automatically selects the first file in folder when opening folders in XnView browser.

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

SharpenValue

Changes the thumbnail sharpening level in XnView browser. This setting only takes effect if thumbnail sharpening is enabled.

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

TimerForPreview

Changes the delay between previews in XnView browser when browsing through pictures with arrow keys.

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

See also NoDelayedPreview setting

TreeBackColor

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

Value: Raw color (integer) or formatted color string

TreeFontColor

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

Value: Raw color (integer) or formatted color string

TreeFontHiColor

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

Value: Raw color (integer) or formatted color string

TreeFontHiColor2

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

Value: Raw color (integer) or formatted color string

TxtBackColor

Changes the background color of 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 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 preview pane when previewing text files.

Value: Raw color (integer) or formatted color string

See also TxtBackColor setting

VideoFramePercent

Changes the frame video thumbnail is extracted from.

Value: Integer (percent), default is 10

Canvas

Height

Height for custom size selection in canvas resize tool.

Value: Integer

Width

Width for custom size selection for canvas resize tool.

Value: Integer

Capture

ImportFormat

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

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

Compare

BackColor

Changes the background color of image compare tool.

Value: Raw color (integer) or formatted color string

Text

Changes the information showed on top left corner of 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

No idea what this one does.

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 Batch Rename tool.

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

BrowserContextMenu

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

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

CommandLine

When enabled, XnView hides the command line help menu item from 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 My Documents tree from the folder tree pane.

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

NetworkTree

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

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

OpenHex

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

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

OpenWith

When enabled, XnView hides open with features.

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

Options

When enabled, XnView hides and disables options dialog.

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

OptionsAssociations

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

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

OptionsInstall

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

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

PathField

When enabled, XnView hides the path field from files pane in browser.

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 shell open features.

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

Obsolete! Doesn't work properly. Use OpenWith instead.

SmallToolbar

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

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 from 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)

Custom name for specified open with tool.

Value: String

Param_# (0-x)

Custom command line parameters for specified open with tool.

Value: String

Print

JobPerPage

When enabled, XnView adds separate print jobs for each selected file / page in multi-page files when printing.

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

Note: Since XnView 1.98, JobPerPage is no longer UI-less setting.

Resize

Height

Width for custom size selection for resize tool.

Value: Integer

Width

Width for custom size selection for resize tool.

Value: Integer

Save

RgbCompress

No idea what this one does.

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

Scan

newMethod

When enabled, XnView uses newer method when using the batch scanning tool.

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

Start

BottomToolbar

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

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

Broken ==> viewtopic.php?t=17016

NoWIA

When enabled, XnView doesn't start WIA service at start up.

Value: Boolean (1/0)

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 is no 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

???

Value: Integer

SelectedShowAgain

When enabled, XnView doesn't ask which group (tagged or selected files) to use when deleting files and always perform the delete operation for selected files.

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

ShowSaveDlg

flags ???

Value: Bit flags

TagShowFlags

flags ???

Value: Bit flags

ToolbarBackColor

Changes the background color of the toolbar.

Value: Raw color (integer) or formatted color string

See also UseToolbarBackColor setting

Broken ==> viewtopic.php?t=17005

UseSavedPath

When enabled, XnView suggest 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 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.

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.

0. Show only for the currently viewed image.

1. Show also for the previous¦next file to view.

2. Show between sessions.Value: Integer, default value is 0

CopyClipboard

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

0. Copy only image data

1. Copy image filename and file object

2. Copy image data, filename and file objectValue: Integer, default value is 0

GridType

Changes the grid coordinate marking display type.

0. No coordinate markings

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

2. Shows separately digits for X, and letters for YValue: Integer, default value is 1

LockZoomFlag

Changes the behavior of the 'lock zoom' feature.

0. lock zoom status is kept between sessions (default).

1. zoom lock status is kept for current session onlyValue: Integer

MaximizeViewWhenOpen

When enabled, XnView will always maximize opened image views.

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

OldGifAni

When enabled, XnView uses old 8bits instead of 32bits decoding for animated gif files.

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

OpenWithAsPNG

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

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

ResetXY

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

0. Middle of the image

1. Top-left of the image

2. Top-right of the imageValue: Integer (0-2), default value is 0

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

RightButtonFlag

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

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

Obsolete! Use 'Keyboard/Mouse' options instead.

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

Doesn't work! Obsolete???

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