UI-less Settings

From XnView Wiki
Jump to: navigation, search

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.
  1. Important
  2. Work
  3. Personal
  4. To do
  5. 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.
  1. Bad
  2. Below average
  3. Average
  4. Good
  5. 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
  1. MOV & MP4 are extracted using QuickTime
  2. MOV is extracted using DirectX
  3. n/a
  4. MP4 is extracted using DirectX
  5. 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.
  1. Show only for the currently viewed image.
  2. Show also for the previous¦next file to view.
  3. Show between sessions.
Value: Integer, default value is 0
CopyClipboard
Changes the data XnView will set in the clipboard when copying an image.
  1. Copy only image data.
  2. Copy image filename and file object.
  3. Copy image data, filename and file object.
Value: Integer, default value is 0
GridType
Changes the display type of the grid coordinate markings.
  1. No coordinate markings.
  2. Shows digits and letters for both the coordinates X and Y.
  3. Shows separately digits for X, and letters for Y.
Value: Integer, default value is 1
LockZoomFlag
Changes the behavior of the 'lock zoom' feature.
  1. Lock zoom status is kept between sessions (default).
  2. 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.
  1. Middle of the image.
  2. Top-left of the image.
  3. 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