Gwenview/Hidden Configuration Options/en: Difference between revisions

From KDE UserBase Wiki
(Updating to match new version of source page)
 
(Updating to match new version of source page)
 
(4 intermediate revisions by the same user not shown)
Line 3: Line 3:
== Disclaimer ==
== Disclaimer ==


This page lists hidden configuration options provided by Gwenview: they may help you tune Gwenview for specific needs, but please keep in mind there is no warranty they will continue working from one version to another.
This page lists hidden configuration options provided by '''Gwenview''': they may help you tune '''Gwenview''' for specific needs, but please keep in mind there is no warranty they will continue working from one version to another.


== Setting these options ==
== Setting these options ==
Line 9: Line 9:
To set these options you need to be familiar with editing KDE configuration files by hand.
To set these options you need to be familiar with editing KDE configuration files by hand.


Gwenview configuration file is named <code>gwenviewrc</code>. It is usually located in <code>~/.kde/share/config/</code>.
'''Gwenview''' configuration file is named <tt>gwenviewrc</tt>. It is usually located in <tt>~/.config/</tt>.


== "General" group ==
== "General" group ==
Line 15: Line 15:
=== PercentageOfMemoryUsageWarning ===
=== PercentageOfMemoryUsageWarning ===


The percentage of memory used by Gwenview before it warns the user and suggest saving changes.
The percentage of memory used by '''Gwenview''' before it warns the user and suggest saving changes.


Default value: <code>0.5</code> (50%)
Default value: <code>0.5</code> (50%)
Line 21: Line 21:
=== BlackListedExtensions ===
=== BlackListedExtensions ===


A comma-separated list of filename extensions Gwenview should not try to load. This is useful to exclude raw files which are recognized as TIFF or JPEG.
A comma-separated list of filename extensions '''Gwenview''' should not try to load. This is useful to exclude raw files which are recognized as TIFF or JPEG.


Default value: <code>nef,cr2,new</code>
Default value: <code>nef,cr2,new</code>


If you change this value, be sure to keep "new" in the list. This is necessary because this extension is used by Gwenview when it saves temporary files.
If you change this value, be sure to keep "new" in the list. This is necessary because this extension is used by '''Gwenview''' when it saves temporary files.
 
{{Note|1=It seems that this option is no longer present by default. You can still create it; it should work as expected. As to default values: If you have information about that please share {{Smiley}}}}


== "FullScreen" group ==
== "FullScreen" group ==
Line 31: Line 33:
=== FullScreenColorScheme ===
=== FullScreenColorScheme ===


Since Gwenview 2.9.
Since '''Gwenview''' 2.9.


Name of a KDE colorscheme to use when running in Fullscreen mode.
Name of a KDE colorscheme to use when running in Fullscreen mode.


The name of installed color schemes can be found in <code>$KDEDIR/share/apps/color-schemes/</code>. You can also use the full path of a color scheme.
The name of installed color schemes can be found in <tt>/usr/share/color-schemes/</tt>. You can also use the full path of a color scheme.
 
Default value: empty string, which means to use the colorscheme shipped with Gwenview.
 
== "ImageView" group ==
 
=== ShowLockZoomButton ===
 
Since Gwenview 2.9.
 
Set this to <code>true</code> to show a "lock" icon next to the zoom slider. When this icon is clicked, Gwenview keeps the current zoom when going from one image to another.


Default value: <code>false</code>
Default value: empty string, which means to use the colorscheme shipped with '''Gwenview'''.


== "ThumbnailView" group ==
== "ThumbnailView" group ==
Line 53: Line 45:
=== ThumbnailAspectRatio ===
=== ThumbnailAspectRatio ===


Since Gwenview 2.10.
Since '''Gwenview''' 2.10.


Defines the aspect ratio used for thumbnail cells. The default value gives cells which are a bit wider than taller, reducing empty space between rows.
Defines the aspect ratio used for thumbnail cells. The default value gives cells which are a bit wider than taller, reducing empty space between rows.

Latest revision as of 23:02, 23 September 2022

Disclaimer

This page lists hidden configuration options provided by Gwenview: they may help you tune Gwenview for specific needs, but please keep in mind there is no warranty they will continue working from one version to another.

Setting these options

To set these options you need to be familiar with editing KDE configuration files by hand.

Gwenview configuration file is named gwenviewrc. It is usually located in ~/.config/.

"General" group

PercentageOfMemoryUsageWarning

The percentage of memory used by Gwenview before it warns the user and suggest saving changes.

Default value: 0.5 (50%)

BlackListedExtensions

A comma-separated list of filename extensions Gwenview should not try to load. This is useful to exclude raw files which are recognized as TIFF or JPEG.

Default value: nef,cr2,new

If you change this value, be sure to keep "new" in the list. This is necessary because this extension is used by Gwenview when it saves temporary files.

Note

It seems that this option is no longer present by default. You can still create it; it should work as expected. As to default values: If you have information about that please share


"FullScreen" group

FullScreenColorScheme

Since Gwenview 2.9.

Name of a KDE colorscheme to use when running in Fullscreen mode.

The name of installed color schemes can be found in /usr/share/color-schemes/. You can also use the full path of a color scheme.

Default value: empty string, which means to use the colorscheme shipped with Gwenview.

"ThumbnailView" group

ThumbnailAspectRatio

Since Gwenview 2.10.

Defines the aspect ratio used for thumbnail cells. The default value gives cells which are a bit wider than taller, reducing empty space between rows.

Default value: 1.5