Program Settings

File Handling

This group of settings controls the file processing rules

Program startup group:

  • Start without filename – to set the behavior if FastRawViewer was started without passing a filename to view:
    • Empty ScreenFastRawViewer starts up "without file".
    • Last opened file – opens the top (last) file from the Recent Files list.
    • Last visited folder – opens the folder from the list of Recent Folders.
    • Specified folder – allows you to set a "start folder".
    • Flexible, last file or folder – opens last file or last folder, what it was later.
  • Do not recall network/removable media – forbids the automatic display of files/folders from network volumes and removable media.
  • Reset folder tree filtering on start – will clear folder filtering on program start.

File Browsing group

  • Warn on broken RAWs – turns on the warning if a damaged RAW file is encountered.
  • Warn on empty Folders – turns on notifications for situations when folders have no files the program can process.
  • Additional RAW extensions – additional extensions for the RAW files FastRawViewer should process (appended to the built-in extension list).
  • Ignore extensions when file browsing – this setting allows the user to supply a list of file extensions. Files having the extensions listed here:

    - will be ignored during file browsing;

    - not displayed in the "Open file" dialogue window.
  • Open folder dialog starts at – sets the folder at which the “Open Folder” dialog starts:
    • Current folder – Current folder.
    • One level up – One level up.
    • Specified folder – the folder specified by the user, always the same (until a different folder is specified here).

Sorting and Filtering Group

This group controls behavior for the sorting and filtering of files in the current folder.

  • Lazy metadata read – if, for the current sorting/filtering method, file metadata (EXIF or XMP) isn’t necessary, then metadata won’t be read (ahead).
  • Reset filtering on folder change – if this setting is turned on, then filtration will be turned off when changing the current folder.
  • Scroll to selected image while filtering/metadata being read – if metadata is necessary for filtration/sorting, then the files in the current folder will be re-sorted/re-filtered as metadata reading progresses. When this setting is turned on, Grid/Filmstrip will auto-scroll to the currently selected file (meaning scroll the Grid/Filmstrip at the same time as re-sorting/filtering – it will automatically return to the current file).

Copy/Move/Reject

  • Use global rejected folder – sets the folder for Rejected files as a global folder, or as a subfolder in the current folder (checkbox is unchecked).
  • Subfolder for rejected files – the name of the subfolder to store the rejected files.
  • Warn when file(s) are moved to rejected – customizes the warning settings for when files are moved to the _Rejected subfolder:
    • No – never warn me.
    • Always – always warn me.
    • Multiple files – warn only moving several files to the _Rejected subfolder.
  • Show progress bar on copy/move/reject – controls the display of the progress bar for these operations (the progress bar also allows to stop the operation, if necessary).
  • Confirm file move  – customizes the warning about moving a file(s) to the same destination as for the previous operation, with same options as for the setting directly above this.
  • Drop file(s) to folders tree – allows one to select one of the following drop modes:
    • Copy w/o prompt – the file is copied; no user confirmation is requested.
    • Select copy or move – at each drop action, the user will be prompted to select what to do with the file (copy, move, cancel the action).
    • Move files – the files will be moved, while the request for confirmation is controlled by the Confirm file move checkbox in the same Copy/Move/Reject pane).
  • Verify file contents after copy – turns on the verification of files after copying or moving a file to another file system.
  • Remember drop targets in last used copy/move lists – turns on the recording of the names of folders that are used in drag and drop to the list of folders in copy file to/move file to.
  • Change/Cleanup recent folders/file lists and favorites on folder tree edits – when renaming folders, whether to rename/remove elements in the Recent files/Recent folders/Favorite folders lists, etc.
  • Copy/Move folder selector starts at – controls the dialog to select a destination folder when preforming copy/move operations, with the following options:
    • Last used – the folder that was used last for Copy or Move operation (for Copy and Move, separate “last used” lists are kept).
    • One level up from last used – a folder one level above (“parent”) the previous option.
    • Current folder – current folder
    • One level up from current folder – a folder one level above (“parent”) the previous option.
    • Specified folder – the specified folder (an additional text line input will pop up to enter the folder path with folder selection button).
  • Undo settings – Customizing the Undo mode:
    • Clear undo history on folder change – clears the undo history when the undo is changed.
    • Undo history length – sets the number of undo levels.

Removable Media

This group of settings sets the specifics of work with removable media and network volumes.

  • On removable media arrive – what to do when removable media is detected:
    • Open most recent subfolder in – opens the most recent (by date of modification) subfolder in the selected folder (/DCIM by default).
    • Open folder – opens the selected folder.
    • Do nothing – Do Nothing.
  • Warn before automatically open folder on removable media – display a warning before automatically opening a folder on removable media.
  • Disable A: and B: floppy access – prevents any access to the A: and B: drives, as well as monitoring of changing media for those drives (Windows only). This preference is intended for the (fairly common in our day) case of a computer having a floppy drive controller, and one or two drives being “visible” to the system, though they’re not actually present.
  • Show unmounted network volumes in Folders panel

    – this setting will switch on the display of the contents of the current un-mounted volume in this panel (if this setting is Off, the network devices that do not have a drive letter assigned will not be displayed).
  • Monitor folder changes on removable media/network volumes – monitor changes in removable media/network volume folders, updating the Folders and Filmstrip panels when new subfolders and files are added.
  • Prefetch depth on removable media/network volumes – sets how many files to decode before moving to the next file.

RAW+JPEG

  • Handle RAW+JPEG together – turns on the pairing of RAW and JPEG of the same name: displaying them as different representations of the same image, and treating them as a single unit for move operations, so that both are relocated to a different folder when a move operation is invoked.
    • Do not show internal JPEG if external JPEG is present – removes the embedded JPEG from the list of available representations if there is an external JPEG (which, usually, has better resolution).
    • Decode and show external JPEGs – enables the decoding and the display of external JPEG files.
    • Analyze external JPEG Orientation tag and image dimensions to match RAW

      – FastRawViewer will rotate the external JPEG if necessary, to match the orientation of the RAW image.
  • Ignore internal JPEGs – unconditionally disables decoding of embedded JPEG previews. Automatically turns on and disables changing of Do not show internal JPEG if external JPEG is present setting.
  • Default image to display – which representation to display when switching to the next file:
    • Same as previous – the same as for the current file.
    • RAW, internal JPEG, external JPEG – explicit designation of the representation.

XMP

This group of settings controls the processing of XMP files

  • Use XMP for RAW files – turns on/off the use of XMP files.
  • Read Only XMP – turns on the mode, where XMP files are read, but not changed.
  • Warn about XMP writing errors – informs the user of any errors that occurred during the XMP file recording process.
  • Warn if overwrite XMP for file with same name – If it is "on", FastRawViewer will ask user for confirmation before overwriting an XMP sidecar file containing settings for a file with the same name but different extension.
  • Disable batch XMP operations if files with same name are selected – If it is "on" (default) and the selected files contain filenames that differ in extension only, the batch editing of XMP (setting or changing orientation, labels, ratings) will be grayed out / disabled in Menu - Select/Batch and in context menu.
  • Force XMP file creation – turns on the unconditional creation of XMP files, even if no adjustments were changed manually while viewing the RAW file (those adjustments are orientation, white balance, exposure adjustment, labels and ratings). Useful for automatic propagation of adjustments to the next file.
  • Write XMP blocks to JPEG files instead of creating sidecars – when working with JPEG files, record XMP blocks directly to the JPEG files, instead of creating sidecar files.
    • Fallback to XMP sidecar if XMP block write to JPEG fails – if XMP block could not be recorded into JPEG file (e.g. because of read-only file), FastRawViewer will create XMP sidecar file for this JPEG file.
  • XMP rating and labels Section:
    • Use XMP Reject Rating – turns on the possibility of setting the rating to -1. This rating is supported in Adobe Bridge. The setting is turned on automatically when selecting XMP Label Style: Adobe Bridge.
    • XMP Label Style – sets the label format in XMP files:
      • Adobe Bridge: Select, Second, Approved, Review, To Do.
      • Color labels/Adobe Lightroom: Red, Yellow, Green, Blue, Purple.
      • Review status/Adobe Lightroom: To Delete, Color Correction Needed, Good to Use, Retouching Needed, To Print.
      • Custom – user labels (any text you choose).
    • Write photoshop:Urgency tag with color labels (for PhaseOne C1) – Turns on the recording of the XMP-tag photoshop:Urgency, which is used by CaptureOne to recognize and set color labels. The setting is activated only if the mode XMP labels is set in 'Color Labels' (this is the default). In other modes, the XMP Labels photoshop:Urgency tag is not modified: if it was in the XMP file, it stays unchanged.
    • Visual feedback on rating label change – give easily-seen visual feedback when ratings/labels are changed (as in Adobe Lightroom).
  • Adobe compatible Exposure and White Balance – turns on reading and recording into XMP files exposure compensation and white balance in Adobe format:
    • Adobe process version for newly created XMP files. Default: 2012, can be set to 2010 or 2003.

      Features:
      • If the tag crs:ProcessVersion is set already in XMP file, the version doesn't change and the exposure is written according to the version.
      • If the crs:ProcessVersion tag isn't present in XMP file, then it's added in accordance to the setting (this way, XMP-files created in older versions of FastRawViewer and then not changed by ACR/LR will be "upgraded");
      • For 2012 process, Exposure2012 (equal to expo correction in FastRawViewer plus Adobe Shift) and the tags Contrast2012, Whites2012, Blacks2012 (set to 0, if these tags are not present in the file) are recorded.
      • For the 2003/2010 processes the tags crs:Exposure, crs:Brightness, and crs:Contrast are recorded (if the file already had the values for those tags, they are preserved, otherwise they are set to 0).
    • Write adobe-compatible Contrast/Blacks into XMP files – enables the recording of the contrast settings in the Adobe-compatible format.
    • Preferred tags for Exposure/WB – controls the priority of FastRawViewer/Adobe exposure and white tags:
      • FastRawViewer – use tags recorded in FRV (libraw: ), if they exist.
      • Adobe Camera Raw/Lr – use Adobe tags
      • Flexible: last recorded – choose between FRV/Adobe according to the date of the last change made to the file (only works with the FRV tags of version 1.4 or newer).

Interface

The group of settings to control the user interface.

Panels group

  • Panel’s font size: sets the font size in the informational panels.
  • Panels color scheme – sets the brightness of the panel background.
  • Hide Menu bar when hiding information panels – for the hide informational panels mode (Tab), controls if the menu bar should be hidden too.
  • Hide bottom window bar when hiding information panels – hide main program window status bar in ‘hide information panels’ (Tab key) mode.
  • Disable transparency for panels outside of main window – allows disabling transparency for informational panels that are placed completely outside the main program window.
  • Hide floating panels – controls floating (not “docked”) informational panels behavior on Menu-Panels-Hide All panels action:
    • Hide all – hide all panels
    • Those inside main window – hide only panels, that float within main program window
    • Do not hide – do not hide floating panels

Further Settings

  • Bottom bar font size – controls bottom bar font size (Small – Extra Large on Windows and Normal – Extra Large on OS X).
  • Background Gray level allows you set the brightness of the main program window background.
  • Selected/active files contrast – allows one to change the contrast (against the FRV background) of selected or active files when showing them in Grid mode or in the Filmstrip panel.
  • Selected files background – allows one to set the background color for selected files.
  • Activate program on file drop – controls program behavior for file Drag-n-Drop operations and if started in ‘Single instance’ mode:
    • None – the program remains on the background (if it is already there)
    • Fullscreen – the program brings itself to the foreground if it is in Fullscreen mode
    • Always – the program brings itself to the foreground for both Fullscreen and “windowed” modes.
  • Ignore successive wheel events for NN msec – this setting is designed to tame the stream of events generated by mouse wheel, Apple Magic Mouse, or trackpad.
  • Restore last View settings on program start – when closing the program the following image display parameters are saved (independent of the status of the settings):

    Display mode (RGB, per-channel, BW Conversion)

    Focus Peaking mode

    Boost Shadows mode

    Exposure correction on/off

    If 'Restore last View settings' is turned on, then during the next start-up of the program, the above-listed parameters will be in effect.
  • Use built-in drive/folder icons in Folders panel – show icons built-in into FastRawViewer in the Folders panel (in several cases, using the system’s icon can lead to problems).
  • Use system Open file/Open folder dialogs – switches between standard and smaller dialogs when opening files/folders.
    • Use built-in file/folder icons in Open File/Open Folder dialogs – when using non-system dialogs for opening files/folders – use built-in icons.
  • Force open Folders panel if started without filename – if this setting is on, starting the program without a file to be opened, or with an invalid / non-existent filename will result in the display of Folders panel, even if this panel was switched off previously.
  • Disable splash screen – switches off the display of logo at FastRawViewer start.
  • Edit bottom bar items – launches the dialog that allows one edit the composition of the program’s bottom bar.

Zoom

  • Image zoom on next file – sets the zoom factor to be used when displaying the next file:
    • Keep zoom ratio – will keep the zoom factor.
    • Keep image width – will keep the visible width of the image
    • Fit to window – the Fit to screen mode will be turned on.
  • Zoom and Drag Zoom to – sets zoom factor to use in the Zoom and Drag mode (Shift – left mouse click).
  • Zoom and Pan Zoom to – sets zoom factor to use in the Zoom and Pan mode (Shift – right mouse click).
  • Toggle Zoom Zoom to – sets the magnification/zoom level used for the Toggle Zoom (Z) mode.
  • Zoom step (for shortcut) – controls the zoom step for keyboard (and mouse) shortcuts:
    • Large – fixed zoom step value of about 50%, to be used for keyboard control.
    • Medium – zoom step is set to 20%.
    • Small – zoom step is set to 5%.

The last two settings are designed to be used while zooming with the Mouse Wheel or trackpad.

  • Zoom+Pan within visible area – if this setting is on, then the panning will take place inside the area visible before the start of the panning. If it is off, then the panning will be over the entire image.
  • Zoom anchor at mouse cursor – zooming will happen taking the position of the mouse cursor into account; the point underneath it will retain its position respective of the window during zooming.
  • Use Logical pixels for zoom calculation (Mac OS X only):
    • If turned on (default, "legacy" behavior), then the pixel in the screen is considered to be the "logical pixel" (in the case of Retina, it's a block of 2x2 "physical" pixels) and the calculation of the zoom size is done in these units.
    • If turned off, the zoom value is calculated in "physical pixels", so for Retina screens the displayed zoom value will now be doubled, and at 100% zoom the image will be half the size compared to "legacy" behavior.

Touchscreen

The settings in this group control working with the touchscreen

Touchscreen support is off by default, to turn it on one ought to use the setting Enable Touchscreen features. After it’s turned on, the following settings become available:

  • Enable Toolbars – turns on toolbars (their visibility can be controlled through Menu – Panels – Toolbars).
  • Toolbars size – controls the size of the toolbar icons.
  • Dim image while switching to next – gives visual feedback about the status of the image moving to another image:
    • Do not dim – works as previous; no brightness decreases while switching between images
    • While switching to next file – decreases the brightness by 40% while in the process of switching to another image. This is the default.
    • Next file or RAW/JPEG switch – the same as previous, plus a 25% decrease in brightness when switching between RAW and JPEG.

Other checkboxes control touch features:

  • Single finger filmstrip scroll/grid scroll – the scroll is performed with a single figure gesture.
  • Double tap to switch grid/single mode – switches between Grid Mode and displaying a Single File with a double-tap.
  • Gesture support in Single File View:
    • Single finger pan to switch – allows one to switch images with one finger gesture from left to right). If the zoom is larger than Fit to Screen, instead of switching images the current image is scrolled.
    • Pinch to zoom/unzoom – change the zoom level of the image with a pinch.
    • Double tap to unzoom (if zoomed): if the image zoom level is larger than Fit to Screen, a double-tap will bring it to Fit to Screen.

      If Double tab to switch grid/single mode is turned on, another double tap will return to Grid Mode.

Grid/Filmstrip

The settings in this group control the display of the image in Grid mode and the Filmstrip panel.

  • Apply automatic brightening to thumbnails – automatically increases the brightness of previews in Grid/Filmstrip modes if they’re too dark.
  • Enable Grid mode – Turns on/off support for Grid Mode. You must restart the program for the change to take effect.
  • Start in Grid mode – when launched without passing a filename, FastRawViewer will start in Grid mode.
  • Remember Grid/Single file state on exit – turns on restoration of the previous mode for the next time FastRawViewer is launched.
  • Browse folders in Grid mode – when moving from the current folder to another one, FastRawViewer will switch to Grid Mode.
  • Hide panels floating within main window in Grid mode – if the setting is on, all floating panels in the Grid Mode that are currently positioned inside the program’s main window will be hidden; they will reappear when switching to Single File View Mode.
  • Hide Filmstrip in Grid mode – customizes the visibility of the Filmstrip panel in Grid Mode (the Filmstrip panel can be brought back to display through Menu – Panels – Filmstrip):
    • No – do not hide the Filmstrip panel
    • If Docked at bottom – if the Filmstrip panel is at the bottom of the program window, it will be hidden upon switching to Grid Mode. The setting has no effect for a Filmstrip that is anywhere else.
    • If Docked anywhere – the Filmstrip panel will be hidden if it is located in one of the main dock areas of the main window (at the top, at the bottom, and on the left). If the Filmstrip panel is dragged out of the main window, it will stay visible after switching to Grid Mode.
  • RAW processing in Grid mode – customizes the RAW decoding when Grid Mode is enabled and RAW decoding is switched on through the Show Histogram/Stats/EXIF icon:
    • Partial – only partial decoding is preformed, enough for displaying the exposure statistics and histogram. In this mode, browsing files happens faster.
    • Full – full decoding is preformed, and switching to Single File view mode is nearly instantaneous.
  • Grid View Font size, Filmstrip panel font size – to set the size of the fonts for the Grid View and Filmstrip panels:
    • Auto – the font size is set automatically, based on the setting for the Panel Font size and the preview size.
  • Extra small…Extra Large – the font size is set to the same as that of the Panels (using the same setting).
  • Pause thumbnail decoding while RAW being processed – this control allows one to set priorities between the decoding of preview files and the decoding of RAW data (these two processes compete for CPU resources and hard drive access):
    • No – concurrency; Thumbnail decoding is not postponed while RAW decoding takes place.
    • Single file mode – Thumbnail decoding is postponed in Single File View Mode until the RAW decoding is finished.
    • Single file and grid modes – Thumbnail recording is postponed for any RAW decoding action.
  • Center edge filmstrip items – controls what happens when the first or the last visible image in the Filmstrip is selected. If on, the Filmstrip is moved in such a way that this image is placed in the center of the visible portion of the Filmstrip.

Image Display

The settings in this group control the processing and the display of the images (except for white balancing, as the WB settings are in a separate group).

  • Contrast curve – sets the tone curve to be used when displaying the image:
    • Gamma 1.8, Gamma 2.2, sRGB, L* - sets one of the standard tone curves, typically used in image editing.
    • Adobe Linear – corresponds to the linear tone curve in Adobe Camera Raw/Lightroom.
    • BW Movie, Monochrome, Landscape, Portrait, Vivid – more punchy tone curves, may be useful for a quick demonstration of unedited images, adding to a more finished look.
  • Boost shadows amount – controls the additional gamma adjustment while in Boost Shadows mode, the range is 0.2 to 2.0.
  • Highlights inspection – this group of settings controls the Highlight Inspection mode:
    • Gamma decrease – the amount by which the Gamma for the image will be reduced.
    • Decrease Exposure by – additional image darkening.
    • Apply UniWB white balance – White Balance will be substituted with UniWB, thus avoiding any possible clipping caused by White Balance.
  • Use embedded color data for – controls the use of color data embedded into RAW files and allows using that data instead of data that comes with FastRawViewer.
  • On-screen sharpening – enables sharpening for display.
    • Preset 1/Mode:
      • Always on – sharpening for display is always on
      • Button/Shortcut – turns on when the button is press.
    • Preset 2/Enabled – allows one to use a second group of parameters for sharpening, thus cycling will be between Off-Preset1-Preset2 or Off-Preset1.
    • Radius – the radius the Unsharp Mask filter, which closely correlates to the Radius parameter in Adobe Photoshop USM settings.
    • Amount – the strength of the sharpening, same as Amount Photoshop USM amount.
    • Sharpen RAW files only – if this setting is on, the sharpening for display will affect RAW files only.
  • Force Black-White mode for Bayer images – turns on the black’n’white mode for color cameras. This mode is intended for modified cameras, where the color filter array is removed.

Exposure

  • Apply Adobe hidden exposure correction – switches ON the automatic exposure correction similar to the one used by Adobe RAW converters, such as Camera Raw and Lightroom. With this correction ON, same values in exposure correction will result in overall image brightness being similar between Adobe converters and FastRawViewer.
  • Set hidden exposure correction to – allows setting a user-defined value for the hidden automatic exposure correction. Often this is not necessary, as FastRawViewer already comes with the corrections for all cameras supported in Adobe converters.
  • Exposure correction on file open:
    • No correction – no additional exposure correction (apart from the Adobe-style one, if it is ON) is applied when a file is opened, unless the correction is found in the accompanying XMP sidecar file.
    • Autoexposure – automatic exposure correction is applied, according to the settings listed below.
    • Keep from prev. file – the new file will be opened with the same exposure correction that was set for the previous file (it does not matter here how that exposure correction was set, manually or automatically).
  • Auto Exposure – controls the automatic exposure correction (the one that is applied when ‘automatic correction’ action is performed).
    • Fixed Exposure Shift – the exposure is shifted by the fixed value.
    • ETTR-style autoexposure (shift histogram to the right) – positive exposure correction that forces the saturation of the given percentage of pixels (those saturated pixels are having value of 255 on the 8-bit scale); the percentage is controlled through Saturate up to %NN of pixels setting.

The amount of the positive exposure correction shift is limited by the ‘Limit to’ setting:

  • Unlimited – no limit

  • Hard limit – the limit is set to the given amount.

  • Virtual ISO – limits the automatic exposure correction, taking into account the ISO setting in the camera. For example, if the current shot is taken at ISO 400 setting in the camera, while auto limit is set to ISO 6400 (the default value), the positive exposure correction is limited to (6400/400 =) 16 times, or, in photographic units, to 4EV.

  • Manual exposure big step size/small step size – sets the step of manual exposure adjustment change.
  • The Over/Underexposure display section controls the over- and underexposure indications
    • Exposure adjustments affect OverExposure display – when turning on this setting the change in exposure adjustment (both automatic and manual) will affect the display of overexposed areas.
    • Under/Overexposure layer opacity – controls the perceived contrast of the highlighting for over- and underexposed areas.
    • Use camera linearity limit to detect clipping – displays overexposure for RAW for the RAW values that are larger than the camera’s linearity limit as recorded in RAW file metadata (not all the cameras record it; if the limit is unknown, then the maximum possible value will be used).
    • Underexposure detection limit NN EV below sensor saturation – sets the “usable dynamic range” of the camera with one value, the same for all ISO settings. Everything below this limit will be displayed as underexposed.
    • ISO-based underexposure limit – the working range will be set by a kinked curve of the following type:
      • For ISO 6-1600 – straight line going through the points @ISO 200 and @ISO 1600
      • For ISO above 1600 – the dynamic range decreases by one photographic stop for each stop of ISO increase, but no less than the value set for @high ISO.

White Balance

This group contains all the white balance processing controls:

  • White Balance Sampler size – for “click-on-gray” (Alt-Click) method, sets the size of the area used to evaluate the white balance
  • White Balance for next file (same camera) – sets the white balance mode when opening a file coming from the same camera model as the current file. Choices here are:
    • Same as previous – keep the current white balance choice.
    • Camera Auto/As Shot – if the camera records the metered white balance (which may differ from that which is used during the shoot), then that balance is used. Otherwise, it will be As Shot.
    • All others – the respective white balance mode will be in effect.
  • White Balance for next file (another camera) – sets the white balance mode when opening

    a file coming from a different camera model.
  •  White Balance display mode:
    • Color Temperature/Tint – a mode commonly used in many RAW converters, including those by Adobe
    • Mired/Tint – instead of correlated color temperatures, the value indicated is in Mired. Useful for selecting color filters to be used on the lens and on studio lights.
    • WB Coefficients – the per-channel multipliers for white balance are indicated.
    • Channel EV Correction – per-channel correction in EV (stops) for white balance are indicated.
  • White Balance edit mode:
    • Color Temperature/Tint – a mode commonly used in many RAW converters, including those by Adobe
    • Channel EV Correction – per-channel correction in EV (stops) for white balance are indicated.
  • Keep Custom WB for next file (same camera) – instructs FastRawViewer if the current white balance coefficients should be applied to the next file coming from the same camera model.
  • Read White Balance presets from RAW (if present) – turns on reading white balance tables from RAW files.

Color Management

This group of settings controls the appearance of the color on-screen in respect to color management:

  • Enable Color Management – turns on ICC-compatible color management.
  • Use system profile (for monitor where program starts) – the ICC profile chosen in the system for that monitor where the program is being started will be used as the profile for the monitor.
  • Display Color profile – allows one to specify a file with the ICC profile for the monitor.
  • RAW processing color space – allows one to set a color space in which the last steps of the RAW data processing are done (the first steps are performed in the camera’s color space).
  • Color space for untagged JPEGs – allows one to set a color space for JPEG files for which the color space is not specified (not recorded in EXIF tags or ICCProfile of JPEG sections).
  • Warn on incorrect, broken or nonexistent display profiles – turns on a warning for when one tries to use an incorrect display profile.
  • Warn on incorrect or broken embedded profiles – turns on a warning for incorrect profiles built into the JPEG data.
  • Color space for thumbnails: sets the mode for color space for previews (thumbnails).

GPU Processing

This group controls the video card modes and how the sharp areas of the image will be displayed.

  • Graphics Engine (Windows only): sets the method of using the graphics hardware acceleration: DirectX 9, DirectX 11 (Windows7 and newer), OpenGL, OpenGL emulator. The last option can only be set through an external script, as it results in extremely low performance, and can be selected only for the purposes of testing.
  • Image resampling method:
    • No resampling – for large zoom factors, the image will look as if it is constituted of small square tiles. The fastest method.
    • Bilinear resampling – pretty fast, mid-quality method
    • Bicubic resampling – high-quality method, can be slow, a relatively fast vast video card is recommended.
  • Downsampling options:
    • None – no additional processing, the downsized image may have a low quality look.
    • Generate low resolution previews – low-resolution previews are rendered in advance with the help of video card driver.

      Requires additional memory for the graphic textures, compatible with all video cards.
    • Suppress downsampling artifacts – suppresses the colored noise on the high ISO images. Not supported on all video cards.
  • Focus peaking mode:
    • High contrast edges – enables the outlines for contrasty details using color contouring. Edges display color sets the color for the contours.
    • Fine details – enables the outlines for the areas with plenty of smaller sharp details using color contouring. Details display color sets the color for the contours.
    • Focus Peaking layer opacity – controls the fading of the main image for the Focus Peaking contours to be visible better.
  • GPU compatibility settings

This group of settings is helps with the cases when certain compatibility problems are encountered (for instance, the image is not completely refreshed):

  • Store compile GPU programs (shaders) – on those video cards on which this is supported, compiled GPU programs will be saved on the disk during the first startup. Program will start faster ever after.
  • Store all renderings in GPU memory – if the setting is on, all of the file representations (RAW, internal JPEG, and external JPEG) will be stored in the video memory, right after the first use; this makes switching between RAW and JPEG for the same file nearly instantaneous.
  • Synchronous GPU operations turns on the synchronous mode of video card work (slower, but more reliable).
  • Force window refresh by slight resize – turns on bouncing to force image redraw
  • Exit program on OS Sleep/suspend – forces the program to exit when the computer goes to sleep (that is to address the issue with some older OS being unable to correctly restart OpenGL operations after the wake up).

External Editors

This window displays the paths to external programs. FastRawViewer can launch those, passing to them the name of the currently displayed file.

  • Supports batch processing: if this checkbox is marked for the program, then this program will be included in both Menu – Select/Batch – Batch Run program and in the context menu for groups of files.
  • Use […] buttons to lookup executable file on your system.
  • Supports batch processing – this program supports the import of several files into it at the same time. Said programs will be displayed in the menu Run Program for file groups.
  • Set custom name – allows one to set an arbitrary name for a program (said name will be used in the menu in place of the application file name of the external program)
  • Add slot button adds additional slot for external program (up to 10).
  • Check external programs presence on startup enables check each program existence on FastRawViewer start.

Performance

Memory usage and performance Group

  • Decoded RAW cache size – the number of decoded RAW files that are kept in the operational memory (RAM) to boost the speed of the browsing.
  • JPEG cache size – the number of JPEG files that are kept in the operational memory to boost the speed of the browsing.
  • Number of simultaneous RAW decode threads – the number of concurrent processes of RAW decoding.
  • Downscale JPEGs larger than NN Mpix – JPEG files larger than the specified size will be down-sampled during the decoding process, so less memory will be required, while decoding and display will happen faster.
  • Do not decode RAW files larger than NN Mpix – RAW data with a pixel count more than the specified will not be decoded; only an internal JPEG will be shown (if it exists)

All changes made to this group of settings come into effect only after restarting FastRawViewer.

  • Use high speed preview for Fujifilm X-Trans – this preference turns on faster (but lower quality) processing for files created by Fujifilm X-Trans sensors.

    This mode is recommended if you are not satisfied with the display rate of these files in standard mode.

    Automatically turns on during the first start-up, and when resetting to default the preferences if the system has one of the following processors:
    • Intel Core2Duo and older.
    • Intel i3-i7 1st generation with fewer than 4 cores.
  • Use all subframes for Pentax 4-shot files – enables merging all subframes into one when working with Pentax frames shot in Pixel Shift mode.

Thumbnail cache Group:

  • Prefetch thumbnails for preceding images: to decode previews for the files “before” those visible on the screen.
  • Thumbnail cache size: maximum size of the cached pr­eviews in the memory (each preview is stored in 4-byte per pixel format, so standard 200x133 preview is about 100kb, so 200Mbytes cache limit translates to ~2000 images).
  • Thumbnail prefetch depth: how many files (relative to those viewed on the screen) to read ahead and decode previews.
  • Thumbnail decoder thread count: how many parallel decode streams (threads) are enabled.

Other settings:

  • Check for folder updates each  – sets the refresh rate for the list of files in the current folder (if the folder changes, for instance other files are copied into it, then it won’t be reread very often).

Other

This section contains other settings that cannot be grouped with any other preceding group:

  • Write RPPS files – saves an .rpps file (for RawPhotoProcessor) if manual changes of WB/exposure are applied to the image
    • Force RPPS files creation – saves an .rpps file with automatic settings for WB/Exposure when a RAW file is opened.
    • Never write Green2 white balance for RGB files – switches off the recording of the separate white balance coefficient for the second green channel.
    • RPPS Template – the name of the file that will be used as a template while creating specific .rpps files (used if .rpps file does not yet exist for the raw file)
  • Check for updates – this parameter schedules the checks for updates - at each program launch or once in every 1-3-7-15-30 days.
  • Debug log messages – turns on the debug mode, the debug messages are available through Menu – Help – Debug log.
  • Run single program instance(Windows only) turns on the “one instance” mode of the program. At an attempt of starting the second instance, the file is displayed in the already existing program window.
  • Check global folders presence on startup – checks for the presence of (and, if necessary, for write permission) the following global folders, if they're configured (in the File Handling and Copy-Move-Reject Preference sections):
    • Start without filename - Specified folder
    • Open folder dialog starts at - Specified folder
    • Use global rejected folder - Subfolder for rejected files
    • Copy/Move folder selector starts at - Specified folder.
  • Faster program close (Windows only) turns on the fast program completion mode.
  • Manage File Associations (Windows-only, not supported in Legacy Windows version): activates the system dialogue to edit file association with FastRawViewer:

Additional Settings

A few of FastRawViewer’s settings are accessible only by running scripts that are installed alongside the program. These “hidden” settings are needed extremely rarely, and should be applied, as a rule, only once.

These settings are only read at program start, so if you apply scripts with FastRawViewer running, immediately close the program and restart it. If the program is not closed immediately, and you move to editing and saving the settings, the changes made by the script may be lost and require repeating the procedure.

Using Additional Settings Scripts: Windows

Scripts installed with the program are copied into the folder

C:\Program Files\LibRaw\FastRawViewer\Scripts. To open it, use Menu – Help – Auxiliary settings scripts:

To use scripts, one needs to open the shown above folder with any file manager (Windows Explorer, for example), choose the necessary script, and run it (double click or Enter).

Registry Editor will run, which will first display a Windows UAC message:

Press Yes to agree to the warning, after which Register Editor will warn you again:

Once again confirm by pressing Yes, and Registry Editor will inform you of your success:

Using Additional Settings Scripts: Mac OS X

The Mac version of FastRawViewer contains additional settings scripts in the Scripts folder in the installation icon (FastRawViewer-1.2.N.MMM.dmg).

To use the scripts:

  1. Use Menu – Help – Auxiliary settings scripts
  2. The Scripts folder will open:

  3. Open the Terminal program

    Applications – Utilities – Terminal.
  4. Drag the needed script onto the Terminal window, and you will see the full path to the script you are about to execute.

  5. Switch to the Terminal window and press Enter. The script will be executed without any output to the Terminal window; if there’s some sort of message, it means that there was an error.

Additional Settings Description

Name of script file

Description

Advanced Troubleshooting

Windows: choosing the program graphics acceleration method

GraphicsToDirectX9

GraphicsToOpenGL

GraphicsToDirectX11

 

Sets the graphics “engine” DirectX9, OpenGL, or DirectX11

Turning resource-intensive graphics operations on and off

EnableAdvancedShaders

DisableAdvancedShaders

Turns on (default)/off resource-intensive graphics operations:

  • Bicubic interpolation
  • Simultaneous use of focus peaking in the Edge and Fine detail modes
  • Artifact reduction filtration.

These scripts are for both Mac and Windows, however for all modern Macs, it is not necessary to turn off resource-intensive operations – the efficiency of the graphics adapters is good enough to use those.

Switching them off may be necessary for Windows platforms using low-end graphics (chipset Intel graphics, the oldest and weakest graphics processing cores).

Controlling the Folders panel

EnableFoldersOnStart

DisableFoldersOnStart

Enable (default value) turns on the default behavior of the Folders panel:

  • When starting FastRawViewer passing the file name as an argument (including through the Start without filename setting) the last state of the Folders panel (opened/closed, floating/docked) is applied.
  • When starting without a filename as a parameter, the Folders panel always opens.

Disable: FastRawViewer starts with a closed Folders panel. It can be opened through Menu – Panels – Folders.

This setting is intended, first of all, as a test in extraordinary situations – in a few rare cases, the monitoring of the removable media status and/or the use of the folder/disc system icons leads to FastRawViewer not being able to work.

UseBuiltinIcons

UseSystemIcons

Allows one to switch the Interface – Use built-In file/folder icons setting without launching FastRawViewer.

This is intended for the case when the additional icon provider that is built into the system isn’t working (this has been known to happen, for example, with some versions of Dell Backup) and FastRawViewer cannot be launched to change these settings because the program crashes during the communication with the icon provider.

DisplayNetworkSharesVolumeLabel

DisplayNetworkSharesShareNameShort

DisplayNetworkSharesShareNameFull

(Windows only)

Controls network volumes name display:

  • …VolumeLabel – show volume label (same as Share name for most NAS, may differ on Windows servers).
  • ...ShareNameShort – display share name (last part)
  • …ShareNameLong – display \\server\share

Advanced Tune

Using Adobe DNG SDK

UseDNGSDKAllFiles

UseDNGSDKSelectedFiles

NoDNGSDK

Use DNG SDK for

  • All files
  • Linear DNG/Floating point DNG (default)
  • Do not use

DNGSDKSingleThread

DNGSDKMultiThread

Use/do not use DNG SDK in multi-thread mode.

Multi-thread mode gives greater efficiency, but may take up over the processor, getting in the way of other computer programs running at the same time.

Controlling the Filmstrip/Thumbnails panels behavior

EnableUnknownDrivesMonitoring

DisableUnknownDrivesMonitoring

EnableAllDrivesMonitoring

DisableAllDrivesMonitoring

Turns on/off the monitoring of any changes in the current folder on:

  • Media (discs), whose type cannot be recognized by FastRawVewer (for example, RamDrive)
  • Media, which are recognized by FastRawViewer (CDROM, Floppy disks), but for which there are no separate settings in the Preferences (it is there only for Removable Media and for network volumes).

FilmstripCenterOnFolderUpdate

NoFilmstripCenterOnFolderUpdate

Turns on (default)/off the centering of the highlighted Filmstrip element when changing the contents of the current folder.

FilmstripDefaultContrast

Sets the default contrast for the highlighted element in the Filmstrip panel.

If one wants to increase/decrease the contrast – copy the script, and edit it (change the default value by 5 more or 5 less) and run it.

WheelScrollDefault

Sets the default mouse wheel scroll step for all scrolling lists (folders, thumbnails in Filmstrip and Grid View, EXIF table).

If one wants to increase/decrease the contrast – copy the script, and edit it (change the default value to wheel step needed) and run it.

FilmstripDefaultOpenDelay

File selected by Filmstrip panel navigation is not opened immediately. This delay allows arrow keys Filmstrip navigation without CPU/disk overload (not every intermediate file will be opened).

Default delay is 30 milliseconds. If one wants to increase/decrease this delay – copy the script and edit it.

FileArrivalDefaultDelay

NoFileArrivalDelay

Designed to prevent FastRawViewer from attempting to display files that are not yet fully copied into the current folder. FastRawViewer

  • waits for the file size on the disk to stop changing (to determine that the size stopped changing the folder is re-read with the frequency set in  Preferences - Performance - Re-read folder in...)
  • additionally, delays the display of this new file for the amount of time set in FileArrivalDelay (default setting - 2 seconds)
  • displays this file in Filmstrip panel

Scripts that control the delay:

  • FileArrivalDefaultDelay - sets the default delay (2000 milliseconds); if you want a different value for the default delay please edit the script
  • NoFileArrivalDelay - sets the delay to zero, thus disabling any extra delay and file size change analysis.

ShiftClickSelectionModeDefault

This script assigns a standard value (0) to the ShiftClickSelectionMode parameter, which modifies the program’s behavior while selecting a range of files using Shift-Click. To change parameter value you need to edit the script before apply.

This parameter is a bit field of 3 bits:

  • Bit 0:
    • 0 - the second limit for the Shift-Click's range will be 'last Ctrl-Clicked', irrespective of whether the action was "selection" or "de-selection"
    • 1 - the second limit for the range will be 'last Ctrl-Clicked' only if the action was "selection"
  • Bit 1:
    • 0 - If 'last Ctrl-Clicked' isn't there, the second limit for the range will be the first file in the current folder

2 - The second limit for the range will be the

  • current file if it wasn't Shift-Clicked (if it was, then it will again be the first file in the current folder)
  • Bit 2:
    • 0 - Shift-Click always creates a new range selection, overriding the previous one.
    • 4 - Shift-Click always expands the selection, never de-selecting previous selections.

 

File Processing

TryJPEGasRAW

NoJPEGasRAW

Attempts to decode files with a JPEG extension the same as for RAW files.

This setting is useful for cameras with modified Firmware (the DiagRAW hack and old versions of the CHDK hack) because these cameras save RAW files with JPG extensions.

UseGPSStatus

IgnoreGPSStatus

Check GPS Status field (default) or ignore it and display GPS coordinates regardless of status.

OEDetectionDefault

OEDetectionHistogram

OEDetectionManual

OEDetectionMethod allows one to change the algorithm for detecting overexposure.

Default - invokes the default method, which searches for the rightmost hump on the histogram.

Histogram - the algorithm looks for a one-bin wide peak in the histogram highlights (the bin width in FRV's histogram is 1/20 EV)

Manual - a manual setting, the value is taken from the OEManualLimit parameter.

CoolscanNEFGamma

CoolscanNEFGamma sets the Gamma value for processing Nikon Coolscan NEF files.

   The value is multiplied by 100, that is for Gamma 2.2 use 220; for Gamma 1.0 use 100. The default value is 220.

   There are no scripts to edit this, please set this value into the registry manually.

EnableRotationWithoutXMP

DisableRotationWithoutXMP

Turns on the option of rotating in Single View mode while recording this to XMP is disabled. The orientation isn’t recorded anywhere.

EnableDetectDNGfromTiff

DisableDetectDNGfromTiff

Turns on the detection of DNG files converted form RGB Tiff. When such files are detected

  • An sRGB tone curve is set
  • UniWB White Balance is set

Color data is taken from the DNG file

Alternate keyboard shortcuts handling

AlternateKeyHandler

NoAlternateKeyHandler

Alternate keyboard handler (Windows only) – turns on the alternative keyboard shortcuts processing mode. Turn on only if there are problems with the processing of keyboard shortcuts (this happens when using utterly non-standard keyboard layouts, for instance when switching between Qwerty и Dvorak).

Performance

SetProcessingMaxParallel

By default, FastRawViewer uses all of the available processing cores to process RAW data.

Setting the Prefs.ProcessingMaxParallel parameter to a smaller value (taking HyperThreading into account) may increase the performance if there are many cores while the RAW files are relatively small.

UseAVX2

NoAVX2

Turns on/off the use of AVX2 instructions where for those computers where this instruction set is supported. By default, this is turned on.

Other settings

DragPanCursorWOZoom

NoDragPanCursorWOZoom

Turns on (default)/off the display of the Drag and Pan cursors in the case when the image fits completely in the Window and there is nowhere to Drag/Pan.

EnableNextPrevQueue

DisableNextPrevQueue

Enable (default mode): if a user issues a new command to move to the Next/Previous file while FastRawViewer was still executing the prior Next/Prev File command, this new command is queued and will be executed as soon as the prior one is completed. This allows for fluid browsing through files with just the Spacebar depressed, but can become uncomfortable if very large files are present, as reading and processing such files takes time.

Disable: the new command to move to Next/Previous file will be ignored while the current command is in effect, and transition to the current file is not completed.

AlternateXMPWrite

NoAlternateXMPWrite

Turns on alternate XMP write mechanics, use only if you experience problems with standard method.

 

Support of non-standard cameras

FastRawViewer can be used for the display and analysis of images from “engineering” cameras, which are saved in the form of “sensor data dumps” without any other additional metadata.

A series of such cameras are already directly supported by the program (FastRawViewer contains an internal table with the necessary data); to support other (arbitrary) sensors, one has to add a description of the structure of the sensor’s data into the Windows Registry (on Windows) or OS X defaults (on Mac OS X).

To do this one must:

Windows: prepare a registry-script with content similar to the following:

[HKEY_CURRENT_USER\Software\LibRaw LLC\CustomCameras]

"Camera01"="24096096,4008,3006, 0, 0, 0, 0,0,148,0,0,Dalsa, FTF4052C 4:3,0"

And run it in Windows Explorer.

OS X: run a command in the Terminal, similar to the following one-liner:

defaults write com.libraw-llc.CustomCameras "Camera01" "24096096,4008,3006, 0, 0, 0, 0,0,148,0,0,Dalsa, FTF4052C 4:3"

In both cases:

Camera01 (or Camera02 … Camera64) – the “number line” in the table, up to 64 records of this type are supported.

The line “24096096,4008,3006, 0, 0, 0, 0,0,148,0,0,Dalsa, FTF4052C 4:3,0” defines the format of the camera’s data and consists of 14 fields separated by commas (a note for engineers: the format of this line is completely analogous to the line in the “sensor dump” table’s description in dcraw.c with the one difference being that the CFA filter’s format is set in base 10):

  1. The exact size of the file in bytes (in this example – 24096096). This is the only criterion by which FastRawViewer recognizes a data “format”, files of a different size will be ignored.
  2. The width of the sensor in pixels. Put the entire width, including the “black frame” in this field.
  3. The height of the sensor in pixels, including the black frame.
  4. The width of the black frame at the left edge of the sensor (in pixels)
  5. The width (height) of the black frame at the top.
  6. The width of the black frame at the right edge.
  7. The width (height) of the black frame at the bottom.
  8. Additional parameters for the file decoding subprogram (see below).
  9. The Bayer filter CFA format, with the byte field taking one of the following values:
    • 22 – BGGR
    • 97 – GRBG
    • 73 – GBRG
    • 148 – RGGB
    • 180 - GMYC
  10. The amount of unused bit data (for example, if 14-bit data is recorded in a 16-bit format)
  11. Additional metadata, bit mask.
    1. Bit 0 – find a .JPG file with the same name and read the EXIF data from it.
    2. Bit 1 – filter (average neighbors) for pixels with values of zero
    3. Bits 2-4 – the orientation of the image (0=do not rotate, 3=180, 5=90CCW, 6=90CW)
  12. Camera manufacturer
  13. Camera model
  14. The offset of the beginning of the sensor data from the beginning of the file (the value range is 0-65534, the special value 65535 means that “the rows are going in the opposite direction”).

8, 10, 12, and 16-bit data formats are supported, the amount of bits is calculated as (the size of the file minus the offset from the beginning of the data)/number of pixels.

Depending on the bit-ness of the data, the 8th field (“additional parameters for the file decoding subprogram”) can accept the following values for 10-bit data:

  • 1: “4 pixels in 5 bytes” packing is used
  • 0: “6 pixels in 8 bytes” packing is used

For the cameras that are supported through this method, the data needed for proper color transforms is (obviously) missing in FastRawViewer. As a result:

  • the color displayed will be "raw", that is the saturation is low and hues are inaccurate;
  • only Auto WB is available in drop-down;
  • no calculation of CCT and Tint

Backing up the Settings

Windows: to back up the settings, please use the BackupSettings.cmd script, which is installed in the same C:\Program Files\LibRaw\FastRawViewer\scripts\ folder as the scripts described above.

As a result of running this script, an FRV-backup folder will be created in your Documents folder. This FRV-backup folder will contain three files containing a copy of your program’s settings:

  • Preferences.reg – for the settings which are controlled through the Preferences
  • Shortcuts.reg – the settings for the keyboard shortcuts
  • LastUsedSettings.reg – this contains the automatically-saved settings such as a list of Recent Files/Recent Folders, window position, etc.

To restore settings from the backup copy:

  1. Quit FastRawViewer
  2. Double-click the file with the backup copy of the settings you want to restore – this will import them into the Windows Registry.

Mac OS X: the settings are stored in ~/Library/Preferences/com.libraw-llc.FastRawViewer.plist

All of the standard backup procedures for Macintosh (TimeMachine, etc.) will save and restore those settings without any trouble.