Online Manual / Settings

Here you can find an overview of all the settings, a little explanation, and their respective entries plus possible values in the settings config file. The default value is shown in bold. Note, that the name of a respective entry in the settings config file does not necessary have a clear connection to the actual setting. This is because the settings has evolved over time, usually being more and more generalised.

Look and Feel

Sort Images By
Here you can adjust, how the images in a folder are supposed to be sorted. You can sort them by Filename, Natural Name (e.g., file10.jpg comes after file9.jpg and not after file1.jpg), File Size, and Date. Also, you can reverse the sorting order from ascending to descending if wanted.

Entry in CONFIG_DIR/settings:
  • SortImagesBy={name, naturalname, date, size}
  • SortImagesAscending={0,1}
Window Mode
PhotoQt is designed with the space of a fullscreen app in mind. That's why it by default runs as fullscreen. However, some might prefer to have it as a normal window, e.g. so that they can see the panel.

Entry in CONFIG_DIR/settings:
  • WindowMode={0,1}
  • WindowDecoration={0,1}
Hide to Tray Icon
When started PhotoQt creates a tray icon in the system tray. If desired, you can set PhotoQt to minimise to the tray instead of quitting. This causes PhotoQt to be almost instantaneously available when an image is opened. It is also possible to start PhotoQt already minimised to the tray (e.g. at system startup) when called with "--start-in-tray".

Possible options: No tray icon (0), Hide to tray icon (1), "Show tray icon, but don't hide to it (3)

Entry in CONFIG_DIR/settings:
  • TrayIcon={0,1,2}
Closing 'X' (top right corner)
There are two looks for the closing 'x' at the top right: a plain 'x', or a slightly more fancy 'x'. Here you can switch back and forth between both of them, and also change their size. If you prefer not to have a closing 'x' at all, see further down for an option to hide it completely.

Entry in CONFIG_DIR/settings:
  • FancyX={0,1}
  • CloseXSize={5-25}
Fit in Window
If the image dimensions are smaller than the screen dimensions, PhotoQt can zoom those images to make them fir into the window. However, keep in mind, that such images will look pixelated to a certain degree (depending on each image).

Entry in CONFIG_DIR/settings:
  • FitInWindow={0,1}
Show Quickinfo (Text Labels)
Here you can hide the text labels shown in the main area: The Counter in the top left corner, the file path/name following the counter, and the "X" displayed in the top right corner. The labels can also be hidden by simply right-clicking on them and selecting "Hide".

Entry in CONFIG_DIR/settings:
  • HideCounter={0,1}
  • HideFilepathShowFilename={0,1}
  • HideFilename={0,1}
  • HideX={0,1}
The background of PhotoQt is the part, that is not covered by an image. It can be made either real (half-)transparent (using a compositor), or faked transparent (instead of the actual desktop a screenshot of it is shown), or a custom background image can be set, or none of the above.
Note: Fake transparency currently only really works when PhotoQt is run in fullscreen/maximised!

Entry in CONFIG_DIR/settings:
  • Composite={0,1}
  • BackgroundImageScreenshot={0,1}
  • BackgroundImageUse={0,1}
  • BackgroundImagePath=""
  • BackgroundImageScale={0,1}
  • BackgroundImageScaleCrop={0,1}
  • BackgroundImageStretch={0,1}
  • BackgroundImageCenter={0,1}
  • BackgroundImageTile={0,1}
Overlay Color
Here you can adjust the background colour of PhotoQt (of the part not covered by an image). When using compositing or a background image, then you can also specify an alpha value, i.e. the transparency of the coloured overlay layer. When neither compositing is enabled nor a background image is set, then this colour will be the non-transparent background of PhotoQt.

Entry in CONFIG_DIR/settings:
  • BgColorRed={0-255}
  • BgColorGreen={0-255}
  • BgColorBlue={0-255}
  • BgColorAlpha={0-255}
Blur Intensity
The background elements are blurred out, when a widget like the Settings Manager or the About widget is opened. Here you can adjust the intensity of the blur.

Note: This does NOT affect the blur of the desktop BEHIND PhotoQt (when transparency is enabled).

Entry in CONFIG_DIR/settings:
  • BlurIntensity={0-10}
Border Around Image
Whenever you load an image, the image is per default not shown completely in fullscreen, i.e. it's not stretching from screen edge to screen edge. Instead there is a small margin around the image of a couple pixels (looks better). Here you can adjust the width of this margin (set to 0 to disable it).

Entry in CONFIG_DIR/settings:
  • BorderAroundImg={0-50}
Click on Empty Area
This option makes PhotoQt behave a bit like the JavaScript image viewers you find on many websites. A click outside of the image on the empty background will close the application. It can be a nice feature, PhotoQt will feel even more like a "floating layer". However, you might at times close PhotoQt accidentally.

Note: If you use a mouse click for a shortcut already, then this option wont have any effect!

Entry in CONFIG_DIR/settings:
  • CloseOnGrey={0,1}
When you load the last image in a directory and select 'Next', PhotoQt automatically jumps to the first image (and vice versa: if you select 'Previous' while having the first image loaded, PhotoQt jumps to the last image). Disabling this option makes PhotoQt stop at the first/last image (i.e. selecting 'Next'/'Previous' will have no effect in these two special cases).

Entry in CONFIG_DIR/settings:
  • LoopThroughFolder={0,1}
Smooth Transition
Switching between images can be done smoothly, the new image can be set to fade into the old image. 'No transition' means, that the previous image is simply replaced by the new image.

Entry in CONFIG_DIR/settings:
  • Transition={0-10}
Size of 'Hot Edge'
Here you can adjust the sensitivity of the drop-down menu. The menu opens when your mouse cursor gets close to the right side of the upper edge. Here you can adjust how close you need to get for it to open.

Entry in CONFIG_DIR/settings:
  • MenuSensitivity={1-10}
Mouse Wheel Sensitivity
Here you can adjust the sensitivity of the mouse wheel. For example, if you have set the mouse wheel up/down for switching back and forth between images, then a lower sensitivity means that you will have to scroll further for triggering a shortcut. Per default it is set to the highest sensitivity, i.e. every single wheel movement is evaluated.

Entry in CONFIG_DIR/settings:
  • MouseWheelSensitivity={1-10}
There are many different interpolation algorithms out there. Depending on the choice of interpolation algorithm, the image (when zoomed in) will look slightly differently. PhotoQt uses mipmaps to get the best quality for images. However, for very small images, that might lead to too much blurring causing them to look rather ugly. For those images, the 'Nearest Neighbour' algorithm tend to be a better choise. Here you can adjust the size threshold below which PhotoQt applies the 'Nearest Neighbour' algorithm.

Entry in CONFIG_DIR/settings:
  • InterpolationNearestNeighbourThreshold={09-99999}
  • InterpolationNearestNeighbourUpscale={0,1}
Pixmap Cache
Here you can adjust the size of the pixmap cache. This cache holds the loaded image elements that have been displayed. This doesn't help when first displaying an image, but can speed up its second display significantly. On the other hand, it does increase the memory in use, up to the limit set here. If you disable the cache altogether (value of 0), then each time an image is displayed, it is loaded fresh from the harddrive.

Note: Any change will only take effect after you restart PhotoQt!

Entry in CONFIG_DIR/settings:
  • PixmapCache={0-1000}
Touchscreen Gestures
PhotoQt has some very basic support for touchscreen gestures. This feature is currently still in an experimental state. As of right now, it isn't possible to adjust the gestures. In the near future, support for touchscreen gestures will be extended.

Entry in CONFIG_DIR/settings:
  • ExperimentalTouchscreenSupport={0,1}
Remember per session
If you would like PhotoQt to remember the rotation/flipping and/or zoom level per session (not permanent), then you can enable it here. If not set, then every time a new image is displayed, it is displayed neither zoomed nor rotated nor flipped (one could say, it is displayed 'normal').

Entry in CONFIG_DIR/settings:
  • RememberRotation={0,1}
  • RememberZoom={0,1}
Animation and Window Geometry
There are three things that can be adjusted here:
  1. Animation of fade-in widgets (like, e.g., Settings or About Widget)
  2. Save and restore of Window Geometry: On quitting PhotoQt, it stores the size and position of the window and can restore it the next time started.
  3. Keep PhotoQt above all other windows at all time

Entry in CONFIG_DIR/settings:
  • MyWidgetAnimated={0,1}
  • SaveWindowGeometry={0,1}
  • KeepOnTop={0,1}


Thumbnail Size
Here you can adjust the thumbnail size. You can set it to any size between 20 and 256 pixel. Per default it is set to 80 pixel, but with different screen resolutions it might be nice to have them larger/smaller.

Entry in CONFIG_DIR/settings:
  • ThumbnailSize={20-256}
Spacing Between Thumbnails
The thumbnails are shown in a row at the lower or upper edge (depending on your setup). They are lined up side by side. Per default, there's no empty space between them, however exactly that can be changed here.

Entry in CONFIG_DIR/settings:
  • ThumbnailSpacingBetween={0-30}
Lift-Up of Thumbnails
When a thumbnail is hovered, it is lifted up some pixels (default 10). Here you can increase/decrease this value according to your personal preference.

Entry in CONFIG_DIR/settings:
  • ThumbnailLiftUp={0-40}
Per default the Thumbnails slide out over the edge of the screen. Here you can force them to stay visible. The big image is shrunk to fit into the empty space. Note, that the thumbnails will be hidden (and only shown on mouse hovering) once you zoomed the image in/out. Resetting the zoom restores the original visibility of the thumbnails.

Entry in CONFIG_DIR/settings:
  • ThumbnailKeepVisible={0,1}
Dynamic Thumbnails
Dynamic thumbnail creation (1) means, that PhotoQt only sets up those thumbnail images that are actually needed, i.e. it stops once it reaches the end of the visible area and sits idle until you scroll left/right.
Smart thumbnails (2) are similar in nature. However, they make use of the fast, that once a thumbnail has been created, it can be loaded very quickly and efficiently. It also first loads all of the currently visible thumbnails, but it doesn't stop there: Any thumbnails (even if invisible at the moment) that once have been created are loaded. This is a nice compromise between efficiency and usability.

Enabling either the smart or dynamic option is recommended, as it increases the performance of PhotoQt significantly, while preserving the usability.

Entry in CONFIG_DIR/settings:
  • ThumbnailDynamic={0,1,2}
Keep in Center
If this option is set, then the active thumbnail (i.e., the thumbnail of the currently displayed image) will always be kept in the center of the thumbnail bar (if possible). If this option is not set, then the active thumbnail will simply be kept visible, but not necessarily in the center.

Entry in CONFIG_DIR/settings:
  • ThumbnailCenterActive={0,1}
Top or Bottom
Per default the bar with the thumbnails is shown at the lower edge. However, some might find it nice and handy to have the thumbnail bar at the upper edge, so that's what can be changed here.

Entry in CONFIG_DIR/settings:
  • ThumbnailPosition={Top,Bottom}
Label on Thumbnails
When thumbnails are displayed at the top/bottom, PhotoQt usually writes the filename on them (if not disabled). You can also use the slider below to adjust the font size.

Entry in CONFIG_DIR/settings:
  • ThumbnailWriteFilename={0,1}
  • ThumbnailWriteFilename={5-20}
Filename Thumbnail
If you don't want PhotoQt to always load the actual image thumbnail in the background, but you still want to have something for better navigating, then you can set a file-name-only thumbnail, i.e. PhotoQt wont load any thumbnail images but simply puts the file name into the box. You can also adjust the font size of this text.

Entry in CONFIG_DIR/settings:
  • ThumbnailFilenameInstead={0,1}
  • ThumbnailFilenameInsteadFontSize={5-20}
Disable thumbnails
If you just don't need or don't want any thumbnails whatsoever, then you can disable them here completely. This option can also be toggled remotely via command line (run 'photoqt --help' for more information on that). This might increase the speed of PhotoQt a good bit, however, navigating through a folder might be a little harder without thumbnails.

Entry in CONFIG_DIR/settings:
  • ThumbnailDisable={0,1}
Thumbnail Cache
Thumbnails can be cached in two different ways:
1) File Caching (following the standard) or
2) Database Caching (better performance and management, default option).

Both ways have their advantages and disadvantages:
File Caching is done according to the standard and thus different applications can share the same thumbnail for the same image file. However, it's not possible to check for obsolete thumbnails (thus this may lead to many unneeded thumbnail files).
Database Caching doesn't have the advantage of sharing thumbnails with other applications (and thus every thumbnails has to be newly created for PhotoQt), but it brings a slightly better performance, and it allows a better handling of existing thumbnails (e.g. deleting obsolete thumbnails).

PhotoQt works with either option, though the second way is set as default.

Although everybody is encouraged to use at least one of the two options, caching can be completely disabled altogether. However, that does affect the performance and usability of PhotoQt, since thumbnails have to be newly re-created every time they are needed.

Entry in CONFIG_DIR/settings:
  • ThumbnailCache={0,1}
  • ThbCacheFile={0,1}


Enable 'Hot Edge'
Per default the info widget can be shown two ways: Moving the mouse cursor to the left screen edge to fade it in temporarily (as long as the mouse is hovering it), or permanently by clicking the checkbox (checkbox only stored per session, can't be saved permanently!). Alternatively the widget can also be triggered by shortcut or main menu item. On demand the mouse triggering can be disabled, so that the widget would only show on shortcut/menu item.

Entry in CONFIG_DIR/settings:
  • ExifEnableMouseTriggering={0,1}
Meta Information
PhotoQt can display a number of information about the image (often called 'Exif data'). However, you might not be interested in all of them, hence you can choose to disable some of them here.

Entry in CONFIG_DIR/settings:
  • ExifFilename={0,1}
  • ExifFiletype={0,1}
  • ExifFilesize={0,1}
  • ExifDimensions={0,1}
  • ExifMake={0,1}
  • ExifModel={0,1}
  • ExifSoftware={0,1}
  • ExifPhotoTaken={0,1}
  • ExifExposureTime={0,1}
  • ExifFlash={0,1}
  • ExifIso={0,1}
  • ExifSceneType={0,1}
  • ExifFLength={0,1}
  • ExifFNumber={0,1}
  • ExifLightSource={0,1}
  • ExifGps={0,1}
Font Size
Computers can have very different resolutions. On some of them, it might be nice to increase the font size of the labels to have them easier readable. Often, a size of 8 or 9 should be working quite well...

Entry in CONFIG_DIR/settings:
  • ExifFontSize={5-20}
By default, the metadata widget is overlapping the main image, thus you might prefer a different alpha value for opacity to increase/decrease readability.

Entry in CONFIG_DIR/settings:
  • ExifOpacity={0-255}
Automatic Rotate/Flip
Some cameras can detect - while taking the photo - whether the camera was turned and might store this information in the image exif data. If PhotoQt finds this information, it can rotate the image accordingly. When asking PhotoQt to always rotate images automatically without asking, it already does so at image load (including thumbnails).

Entry in CONFIG_DIR/settings:
  • ExifRotation={Never, Always, Ask}
Online Map for GPS
If your image includes a GPS location, then a click on the location text will load this location in an online map using your default external browser. Here you can choose which online service to use (suggestions for other online maps always welcome).

Entry in CONFIG_DIR/settings:
  • ExifGPSMapService={,,}