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 usually shown in bold. The settings file is located in the CONFIG_DIR which on Linux systems typically is ~/.config/PhotoQt/.

Look and Feel

Sort Images
Images in the current folder can be sorted in various ways. They can be sorted by filename, natural name (e.g., file10.jpg comes after file9.jpg and not after file1.jpg), filesize, and date, all of that both ascending or descending.

Entry in CONFIG_DIR/settings:
  • SortImagesBy={name, naturalname, date, size}
  • SortImagesAscending={0,1}
Window Mode
PhotoQt can be used both in fullscreen mode or as a normal window. It was designed with a fullscreen/maximised application in mind, thus it will look best when used that way, but will work just as well any other way.

Entry in CONFIG_DIR/settings:
  • WindowMode={0,1}
  • WindowDecoration={0,1}
Hide to Tray Icon
PhotoQt can make use of a tray icon in the system tray. It can also hide to the system tray when closing it instead of quitting. It is also possible to start PhotoQt already minimised to the tray (e.g. at system startup) when called with "--start-in-tray".

Entry in CONFIG_DIR/settings:
  • TrayIcon={0,1,2}
Closing 'X'
There are two looks for the exit button: a normal 'x' or a plain text'x'. The normal 'x' fits in better with the overall design of PhotoQt, but the plain text 'x' is smaller and more discreet.

Entry in CONFIG_DIR/settings:
  • QuickInfoFullX={0,1}
  • QuickInfoCloseXSize={5-10-25}
Fit in Window
If the image dimensions are smaller than the screen dimensions, PhotoQt can automatically zoom those images to make them fit into the window.

Entry in CONFIG_DIR/settings:
  • FitInWindow={0,1}
Show Quickinfo (Text Labels)
PhotoQt shows certain information about the current image and the folder in the top left corner of the screen. You can choose which information in particular to show there. This also includes the 'x' for closing PhotoQt in the top right corner.

Entry in CONFIG_DIR/settings:
  • QuickInfoHideCounter={0,1}
  • QuickInfoHideFilepath={0,1}
  • QuickInfoHideFilename={0,1}
  • QuickInfoHideX={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. Please 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:
  • BackgroundColorRed={0-255}
  • BackgroundColorGreen={0-255}
  • BackgroundColorBlue={0-255}
  • BackgroundColorAlpha={0-10-255}
Margin 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. Here you can adjust the width of this margin (set to 0 to disable it).

Entry in CONFIG_DIR/settings:
  • MarginAroundImage={0-5-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. This way PhotoQt will feel even more like a 'floating layer', however, this can easily be triggered accidentally. Note that if you use a mouse click for a shortcut already, then this option wont have any effect!

Entry in CONFIG_DIR/settings:
  • CloseOnEmptyBackground={0,1}
PhotoQt can loop over the images in the folder, i.e., when reaching the last image it continues to the first one and vice versa. If disabled, it will stop at the first/last image.

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 instantly by the new image.

Entry in CONFIG_DIR/settings:
  • ImageTransition={0-1-15}
Transparency Marker
Transparency in image viewers is often signalled by displaying a pattern of light and dark grey squares. PhotoQt can do the same, by default it will, however, show transparent areas as transparent.

Entry in CONFIG_DIR/settings:
  • ShowTransparencyMarkerBackground={0,1}
Size of 'Hot Edge'
Here you can adjust the sensitivity of the metadata and main menu elements. The main menu opens when your mouse cursor gets close to the right screen edge, the metadata element when you go to the left screen edge. This setting controls how close to the screen edge you have to get before they are shown.

Entry in CONFIG_DIR/settings:
  • HotEdgeWidth={1-4-20}
Mouse Wheel Sensitivity
The mouse can be used for various things, including many types of shortcuts. The sensitivity of the mouse wheel defines the distance the wheel has to be moved before triggering a shortcut.

Entry in CONFIG_DIR/settings:
  • MouseWheelSensitivity={0-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 tends to be a better choice. The threshold defines for which images to use which algorithm.

Entry in CONFIG_DIR/settings:
  • InterpolationNearestNeighbourThreshold={0-100-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.

Entry in CONFIG_DIR/settings:
  • PixmapCache={0-128-1000}
Re-open last used image at startup
At startup, you can set PhotoQt to re-open the last used image and directory. This doesn't keep any zooming/scaling/mirroring from before. If you pass an image to PhotoQt on the command line, it will always favor the passed-on image.

Entry in CONFIG_DIR/settings:
  • StartupLoadLastLoadedImage={0,1}
Keep between images
By default, PhotoQt resets the zoom, rotation, flipping/mirroring and position when switching to a different image. For certain tasks, for example for comparing two images, it can be helpful to keep these properties.

Entry in CONFIG_DIR/settings:
  • KeepZoomRotationMirror={0,1}
Animation and Window Geometry
There are three things that can be adjusted here:
  1. Animations of elements and items (like fade-in, etc.)
  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:
  • Animations={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 the optimal size depends on the screen resolution.

Entry in CONFIG_DIR/settings:
  • ThumbnailSize={20-80-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.

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

Entry in CONFIG_DIR/settings:
  • ThumbnailLiftUp={0-6-40}
The thumbnails normally fade out when not needed, however, they can be set to stay visible. The main image is shrunk to fit into the free space. When it is zoomed in the thumbnails can be set to fade out automatically.

Entry in CONFIG_DIR/settings:
  • ThumbnailKeepVisible={0,1}
  • ThumbnailKeepVisibleWhenNotZoomedIn={0,1}
Keep in Center
If this option is set, then the current 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 screen edge. However, some might find it nice and handy to have the thumbnail bar at the upper edge.

Entry in CONFIG_DIR/settings:
  • ThumbnailPosition={Top,Bottom}
Label on Thumbnails
PhotoQt can write a label with some information on the thumbnails. Currently, only the filename is available. The slider adjusts the fontsize of the text for the filename.

Entry in CONFIG_DIR/settings:
  • ThumbnailWriteFilename={0,1}
  • ThumbnailFontSize={5-7-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 filename-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-8-20}
Disable thumbnails
If you just don't need or don't want any thumbnails whatsoever, then you can disable them here completely. This will increase the speed of PhotoQt, but will make navigating with the mouse harder.

Entry in CONFIG_DIR/settings:
  • ThumbnailDisable={0,1}
Thumbnail Cache
"Thumbnails can be cached in two different ways:
1) File Caching (following the standard)
2) Database Caching

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.
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 allows PhotoQt to have more control over existing thumbnails and works better on systems like Windows. PhotoQt works with either option, though the first way is set as default and strongly recommended.

Although everybody is encouraged to use at least one of the two options, caching can be completely disabled altogether. However, this means that each thumbnail has to be recreated everytime it is needed.

Entry in CONFIG_DIR/settings:
  • ThumbnailCache={0,1}
  • ThumbnailCacheFile={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:
  • MetadataEnableHotEdge={0,1}
Meta Information
PhotoQt can display a number of meta information about the image. Here you can choose which ones to show and which ones to hide.

Entry in CONFIG_DIR/settings:
  • MetaFilename={0,1}
  • MetaImageNumber={0,1}
  • MetaFileSize={0,1}
  • MetaDimensions={0,1}
  • MetaMake={0,1}
  • MetaModel={0,1}
  • MetaSoftware={0,1}
  • MetaTimePhotoTaken={0,1}
  • MetaExposureTime={0,1}
  • MetaFlash={0,1}
  • MetaIso={0,1}
  • MetaSceneType={0,1}
  • MetaFLength={0,1}
  • MetaFNumber={0,1}
  • MetaLightSource={0,1}
  • MetaKeywords={0,1}
  • MetaLocation={0,1}
  • MetaCopyright={0,1}
  • MetaGps={0,1}
Font Size
The fontsize of the metadata element can be adjusted independently of the rest of the application.

Entry in CONFIG_DIR/settings:
  • MetadataFontSize={5-10-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. Values can be in the range of 0-255.

Entry in CONFIG_DIR/settings:
  • MetadataOpacity={0-220-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 or simply ignore that information.

Entry in CONFIG_DIR/settings:
  • MetaApplyRotation={Never, Always}
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:
  • MetaGpsMapService={,,}