1GIMPRC(5) File Formats Manual GIMPRC(5)
3
7 gimprc - gimp configuration file
8
10 The gimprc file is a configuration file read by GIMP when it starts up.
11 There are two of these: one system-wide one stored in
12 /etc/gimp/2.0/gimprc and a per-user $XDG_CONFIG_HOME/GIMP/2.10/gimprc
13 which may override system settings.
14 Comments are introduced by a hash sign (#), and continue until the end
16 of the line. Blank lines are ignored.
17 The gimprc file associates values with properties. These properties
19 may be set by lisp-like assignments of the form:
20 (property-name value)
22 where:
24 property-name
26 is one of the property names described below.
27 value is the value the property is to be set to.
29 Either spaces or tabs may be used to separate the name from the value.
31
33 Valid properties and their default values are:
34 (temp-path "${gimp_temp_dir}")
37 Sets the folder for temporary storage. Files will appear here
39 during the course of running GIMP. Most files will disappear
40 when GIMP exits, but some files are likely to remain, so it is
41 best if this folder not be one that is shared by other users.
42 This is a single folder.
43 (swap-path "${gimp_cache_dir}")
46 Sets the swap file location. GIMP uses a tile based memory allo‐
48 cation scheme. The swap file is used to quickly and easily swap
49 tiles out to disk and back in. Be aware that the swap file can
50 easily get very large if GIMP is used with large images. Also,
51 things can get horribly slow if the swap file is created on a
52 folder that is mounted over NFS. For these reasons, it may be
53 desirable to put your swap file in "/tmp". This is a single
54 folder.
55 (swap-compression "fast")
58 The compression method used for tile data stored in the swap
60 file. This is a string value.
61 (num-processors 1)
64 Sets how many threads GIMP should use for operations that sup‐
66 port it. This is an integer value.
67 (tile-cache-size 2g)
70 When the amount of pixel data exceeds this limit, GIMP will
72 start to swap tiles to disk. This is a lot slower but it makes
73 it possible to work on images that wouldn't fit into memory oth‐
74 erwise. If you have a lot of RAM, you may want to set this to a
75 higher value. The integer size can contain a suffix of 'B',
76 'K', 'M' or 'G' which makes GIMP interpret the size as being
77 specified in bytes, kilobytes, megabytes or gigabytes. If no
78 suffix is specified the size defaults to being specified in
79 kilobytes.
80 (use-opencl no)
83 When enabled, uses OpenCL for some operations. Possible values
85 are yes and no.
86 Specifies the language to use for the user interface. This is a string
90 value.
91 (interpolation-type cubic)
94 Sets the level of interpolation used for scaling and other
96 transformations. Possible values are none, linear, cubic,
97 nohalo and lohalo.
98 (default-threshold 15)
101 Tools such as fuzzy-select and bucket fill find regions based on
103 a seed-fill algorithm. The seed fill starts at the initially
104 selected pixel and progresses in all directions until the dif‐
105 ference of pixel intensity from the original is greater than a
106 specified threshold. This value represents the default thresh‐
107 old. This is an integer value.
108 (plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")
111 Sets the plug-in search path. This is a colon-separated list of
113 folders to search.
114 (module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")
117 Sets the module search path. This is a colon-separated list of
119 folders to search.
120 (interpreter-path "${gimp_dir}/interpreters:${gimp_plug_in_dir}/inter‐
123 preters")
124 Sets the interpreter search path. This is a colon-separated
126 list of folders to search.
127 (environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")
130 Sets the environ search path. This is a colon-separated list of
132 folders to search.
133 (brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")
136 Sets the brush search path. This is a colon-separated list of
138 folders to search.
139 (brush-path-writable "${gimp_dir}/brushes")
142 This is a colon-separated list of folders to search.
144 (dynamics-path "${gimp_dir}/dynamics:${gimp_data_dir}/dynamics")
147 Sets the dynamics search path. This is a colon-separated list
149 of folders to search.
150 (dynamics-path-writable "${gimp_dir}/dynamics")
153 This is a colon-separated list of folders to search.
155 (mypaint-brush-path "/usr/share/mypaint-
158 data/1.0/brushes:~/.mypaint/brushes")
159 Sets the brush search path. This is a colon-separated list of
161 folders to search.
162 (mypaint-brush-path-writable "~/.mypaint/brushes")
165 This is a colon-separated list of folders to search.
167 (pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")
170 Sets the pattern search path. This is a colon-separated list of
172 folders to search.
173 (pattern-path-writable "${gimp_dir}/patterns")
176 This is a colon-separated list of folders to search.
178 (palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")
181 Sets the palette search path. This is a colon-separated list of
183 folders to search.
184 (palette-path-writable "${gimp_dir}/palettes")
187 This is a colon-separated list of folders to search.
189 (gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")
192 Sets the gradient search path. This is a colon-separated list
194 of folders to search.
195 (gradient-path-writable "${gimp_dir}/gradients")
198 This is a colon-separated list of folders to search.
200 (tool-preset-path "${gimp_dir}/tool-presets:${gimp_data_dir}/tool-pre‐
203 sets")
204 Sets the dynamics search path. This is a colon-separated list
206 of folders to search.
207 (tool-preset-path-writable "${gimp_dir}/tool-presets")
210 This is a colon-separated list of folders to search.
212 (font-path "${gimp_dir}/fonts:${gimp_data_dir}/fonts")
215 Where to look for fonts in addition to the system-wide installed
217 fonts. This is a colon-separated list of folders to search.
218 (default-brush "2. Hardness 050")
221 Specify a default brush. The brush is searched for in the spec‐
223 ified brush path. This is a string value.
224 (default-dynamics "Dynamics Off")
227 Specify a default dynamics. The dynamics is searched for in the
229 specified dynamics path. This is a string value.
230 (default-mypaint-brush "Fixme")
233 Specify a default MyPaint brush. This is a string value.
235 (default-pattern "Pine")
238 Specify a default pattern. This is a string value.
240 (default-palette "Default")
243 Specify a default palette. This is a string value.
245 (default-gradient "FG to BG (RGB)")
248 Specify a default gradient. This is a string value.
250 (default-tool-preset "Current Options")
253 Specify a default tool preset. The tool preset is searched for
255 in the specified tool prests path. This is a string value.
256 (default-font "Sans-serif")
259 Specify a default font. This is a string value.
261 (global-brush yes)
264 When enabled, the selected brush will be used for all tools.
266 Possible values are yes and no.
267 (global-dynamics yes)
270 When enabled, the selected dynamics will be used for all tools.
272 Possible values are yes and no.
273 (global-pattern yes)
276 When enabled, the selected pattern will be used for all tools.
278 Possible values are yes and no.
279 (global-palette yes)
282 When enabled, the selected palette will be used for all tools.
284 Possible values are yes and no.
285 (global-gradient yes)
288 When enabled, the selected gradient will be used for all tools.
290 Possible values are yes and no.
291 (global-font yes)
294 When enabled, the selected font will be used for all tools.
296 Possible values are yes and no.
297 (default-image
300 (width 1920)
301 (height 1080)
302 (unit pixels)
303 (xresolution 300)
304 (yresolution 300)
305 (resolution-unit inches)
306 (image-type rgb)
307 (precision u8-gamma)
308 (color-managed yes)
309 (color-profile NULL)
310 (fill-type background)
311 (comment "Created with GIMP"))
312 Sets the default image in the "File/New" dialog. This is a
314 parameter list.
315 (default-grid
318 (style solid)
319 (fgcolor (color-rgba 0 0 0 1))
320 (bgcolor (color-rgba 1 1 1 1))
321 (xspacing 10)
322 (yspacing 10)
323 (spacing-unit inches)
324 (xoffset 0)
325 (yoffset 0)
326 (offset-unit inches))
327 Specify a default image grid. This is a parameter list.
329 (undo-levels 5)
332 Sets the minimal number of operations that can be undone. More
334 undo levels are kept available until the undo-size limit is
335 reached. This is an integer value.
336 (undo-size 1g)
339 Sets an upper limit to the memory that is used per image to keep
341 operations on the undo stack. Regardless of this setting, at
342 least as many undo-levels as configured can be undone. The
343 integer size can contain a suffix of 'B', 'K', 'M' or 'G' which
344 makes GIMP interpret the size as being specified in bytes, kilo‐
345 bytes, megabytes or gigabytes. If no suffix is specified the
346 size defaults to being specified in kilobytes.
347 (undo-preview-size large)
350 Sets the size of the previews in the Undo History. Possible
352 values are tiny, extra-small, small, medium, large, extra-large,
353 huge, enormous and gigantic.
354 (plug-in-history-size 10)
357 How many recently used filters and plug-ins to keep on the Fil‐
359 ters menu. This is an integer value.
360 (pluginrc-path "${gimp_dir}/pluginrc")
363 Sets the pluginrc search path. This is a single filename.
365 (layer-previews yes)
368 Sets whether GIMP should create previews of layers and channels.
370 Previews in the layers and channels dialog are nice to have but
371 they can slow things down when working with large images. Pos‐
372 sible values are yes and no.
373 (group-layer-previews yes)
376 Sets whether GIMP should create previews of layer groups. Layer
378 group previews are more expensive than ordinary layer previews.
379 Possible values are yes and no.
380 (layer-preview-size medium)
383 Sets the preview size used for layers and channel previews in
385 newly created dialogs. Possible values are tiny, extra-small,
386 small, medium, large, extra-large, huge, enormous and gigantic.
387 (thumbnail-size normal)
390 Sets the size of the thumbnail shown in the Open dialog. Possi‐
392 ble values are none, normal and large.
393 (thumbnail-filesize-limit 4M)
396 The thumbnail in the Open dialog will be automatically updated
398 if the file being previewed is smaller than the size set here.
399 The integer size can contain a suffix of 'B', 'K', 'M' or 'G'
400 which makes GIMP interpret the size as being specified in bytes,
401 kilobytes, megabytes or gigabytes. If no suffix is specified the
402 size defaults to being specified in kilobytes.
403 (color-management
406 (mode display)
407 (display-profile-from-gdk no)
408 (display-rendering-intent relative-colorimetric)
409 (display-use-black-point-compensation yes)
410 (display-optimize yes)
411 (simulation-rendering-intent perceptual)
412 (simulation-use-black-point-compensation no)
413 (simulation-optimize yes)
414 (simulation-gamut-check no)
415 (out-of-gamut-color (color-rgb 1 0 1))
416 (display-module "CdisplayLcms"))
417 Defines the color management behavior. This is a parameter
419 list.
420 (save-document-history yes)
423 Keep a permanent record of all opened and saved files in the
425 Recent Documents list. Possible values are yes and no.
426 (quick-mask-color (color-rgba 1 0 0 0.5))
429 Sets the default quick mask color. The color is specified in
431 the form (color-rgba red green blue alpha) with channel values
432 as floats in the range of 0.0 to 1.0.
433 (import-promote-float no)
436 Promote imported images to floating point precision. Does not
438 apply to indexed images. Possible values are yes and no.
439 (import-promote-dither yes)
442 When promoting imported images to floating point precision, also
444 add minimal noise in order to distribute color values a bit.
445 Possible values are yes and no.
446 (import-add-alpha no)
449 Add an alpha channel to all layers of imported images. Possible
451 values are yes and no.
452 (import-raw-plug-in "")
455 Which plug-in to use for importing raw digital camera files.
457 This is a single filename.
458 (export-file-type png)
461 Export file type used by default. Possible values are png, jpg,
463 ora, psd, pdf, tif, bmp and webp.
464 (export-color-profile yes)
467 Export the image's color profile by default. Possible values
469 are yes and no.
470 (export-metadata-exif yes)
473 Export Exif metadata by default. Possible values are yes and
475 no.
476 (export-metadata-xmp yes)
479 Export XMP metadata by default. Possible values are yes and no.
481 (export-metadata-iptc yes)
484 Export IPTC metadata by default. Possible values are yes and
486 no.
487 (debug-policy fatal)
490 Try generating debug data for bug reporting when appropriate.
492 Possible values are warning, critical, fatal and never.
493 (check-updates yes)
496 Check for availability of GIMP updates through background inter‐
498 net queries. Possible values are yes and no.
499 (check-update-timestamp 0)
502 Timestamp of the last update check. (null)
504 (last-release-timestamp 0)
507 The timestamp for the last known release date. (null)
509 (last-revision 0)
512 The timestamp for the last known release date. This is an inte‐
514 ger value.
515 The last known release version of GIMP as queried from official web‐
519 site. This
520 is a string value.
521 (transparency-size medium-checks)
524 Sets the size of the checkerboard used to display transparency.
526 Possible values are small-checks, medium-checks and large-
527 checks.
528 (transparency-type gray-checks)
531 Sets the manner in which transparency is displayed in images.
533 Possible values are light-checks, gray-checks, dark-checks,
534 white-only, gray-only and black-only.
535 (snap-distance 8)
538 This is the distance in pixels where Guide and Grid snapping
540 activates. This is an integer value.
541 (marching-ants-speed 200)
544 Speed of marching ants in the selection outline. This value is
546 in milliseconds (less time indicates faster marching). This is
547 an integer value.
548 (resize-windows-on-zoom no)
551 When enabled, the image window will automatically resize itself
553 when zooming into and out of images. This setting only takes
554 effect in multi-window mode. Possible values are yes and no.
555 (resize-windows-on-resize no)
558 When enabled, the image window will automatically resize itself
560 whenever the physical image size changes. This setting only
561 takes effect in multi-window mode. Possible values are yes and
562 no.
563 (default-show-all no)
566 Show full image content by default. Possible values are yes and
568 no.
569 (default-dot-for-dot yes)
572 When enabled, this will ensure that each pixel of an image gets
574 mapped to a pixel on the screen. Possible values are yes and
575 no.
576 (initial-zoom-to-fit yes)
579 When enabled, this will ensure that the full image is visible
581 after a file is opened, otherwise it will be displayed with a
582 scale of 1:1. Possible values are yes and no.
583 (cursor-mode tool-crosshair)
586 Sets the type of mouse pointers to use. Possible values are
588 tool-icon, tool-crosshair and crosshair.
589 (cursor-updating yes)
592 Context-dependent mouse pointers are helpful. They are enabled
594 by default. However, they require overhead that you may want to
595 do without. Possible values are yes and no.
596 (show-brush-outline yes)
599 When enabled, all paint tools will show a preview of the current
601 brush's outline. Possible values are yes and no.
602 (snap-brush-outline no)
605 When enabled, the brush outline will snap to individual dabs
607 while painting. Possible values are yes and no.
608 (show-paint-tool-cursor yes)
611 When enabled, the mouse pointer will be shown over the image
613 while using a paint tool. Possible values are yes and no.
614 (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
617 Sets the text to appear in image window titles. This is a for‐
619 mat string; certain % character sequences are recognised and
620 expanded as follows:
621 %% literal percent sign
623 %f bare filename, or "Untitled"
624 %F full path to file, or "Untitled"
625 %p PDB image id
626 %i view instance number
627 %t image type (RGB, grayscale, indexed)
628 %z zoom factor as a percentage
629 %s source scale factor
630 %d destination scale factor
631 %Dx expands to x if the image is dirty, the empty string other‐
632 wise
633 %Cx expands to x if the image is clean, the empty string other‐
634 wise
635 %B expands to (modified) if the image is dirty, the empty
636 string otherwise
637 %A expands to (clean) if the image is clean, the empty string
638 otherwise
639 %Nx expands to x if the image is export-dirty, the empty string
640 otherwise
641 %Ex expands to x if the image is export-clean, the empty string
642 otherwise
643 %l the number of layers
644 %L the number of layers (long form)
645 %m memory used by the image
646 %n the name of the active layer/channel
647 %P the PDB id of the active layer/channel
648 %w image width in pixels
649 %W image width in real-world units
650 %h image height in pixels
651 %H image height in real-world units
652 %M the image size expressed in megapixels
653 %u unit symbol
654 %U unit abbreviation
655 %x the width of the active layer/channel in pixels
656 %X the width of the active layer/channel in real-world units
657 %y the height of the active layer/channel in pixels
658 %Y the height of the active layer/channel in real-world units
659 %o the name of the image's color profile
660 (image-status-format "%n (%m)")
664 Sets the text to appear in image window status bars. This is a
666 format string; certain % character sequences are recognised and
667 expanded as follows:
668 %% literal percent sign
670 %f bare filename, or "Untitled"
671 %F full path to file, or "Untitled"
672 %p PDB image id
673 %i view instance number
674 %t image type (RGB, grayscale, indexed)
675 %z zoom factor as a percentage
676 %s source scale factor
677 %d destination scale factor
678 %Dx expands to x if the image is dirty, the empty string other‐
679 wise
680 %Cx expands to x if the image is clean, the empty string other‐
681 wise
682 %B expands to (modified) if the image is dirty, the empty
683 string otherwise
684 %A expands to (clean) if the image is clean, the empty string
685 otherwise
686 %Nx expands to x if the image is export-dirty, the empty string
687 otherwise
688 %Ex expands to x if the image is export-clean, the empty string
689 otherwise
690 %l the number of layers
691 %L the number of layers (long form)
692 %m memory used by the image
693 %n the name of the active layer/channel
694 %P the PDB id of the active layer/channel
695 %w image width in pixels
696 %W image width in real-world units
697 %h image height in pixels
698 %H image height in real-world units
699 %M the image size expressed in megapixels
700 %u unit symbol
701 %U unit abbreviation
702 %x the width of the active layer/channel in pixels
703 %X the width of the active layer/channel in real-world units
704 %y the height of the active layer/channel in pixels
705 %Y the height of the active layer/channel in real-world units
706 %o the name of the image's color profile
707 (monitor-xresolution 96)
711 Sets the monitor's horizontal resolution, in dots per inch. If
713 set to 0, forces the X server to be queried for both horizontal
714 and vertical resolution information. This is a float value.
715 (monitor-yresolution 96)
718 Sets the monitor's vertical resolution, in dots per inch. If
720 set to 0, forces the X server to be queried for both horizontal
721 and vertical resolution information. This is a float value.
722 (monitor-resolution-from-windowing-system yes)
725 When enabled, GIMP will use the monitor resolution from the win‐
727 dowing system. Possible values are yes and no.
728 (navigation-preview-size medium)
731 Sets the size of the navigation preview available in the lower
733 right corner of the image window. Possible values are tiny,
734 extra-small, small, medium, large, extra-large, huge, enormous
735 and gigantic.
736 (default-view
739 (show-menubar yes)
740 (show-statusbar yes)
741 (show-rulers yes)
742 (show-scrollbars yes)
743 (show-selection yes)
744 (show-layer-boundary yes)
745 (show-canvas-boundary yes)
746 (show-guides yes)
747 (show-grid no)
748 (show-sample-points yes)
749 (snap-to-guides yes)
750 (snap-to-grid no)
751 (snap-to-canvas no)
752 (snap-to-path no)
753 (padding-mode default)
754 (padding-color (color-rgb 1 1 1))
755 (padding-in-show-all no))
756 Sets the default settings for the image view. This is a parame‐
758 ter list.
759 (default-fullscreen-view
762 (show-menubar yes)
763 (show-statusbar yes)
764 (show-rulers yes)
765 (show-scrollbars yes)
766 (show-selection yes)
767 (show-layer-boundary yes)
768 (show-canvas-boundary yes)
769 (show-guides yes)
770 (show-grid no)
771 (show-sample-points yes)
772 (snap-to-guides yes)
773 (snap-to-grid no)
774 (snap-to-canvas no)
775 (snap-to-path no)
776 (padding-mode default)
777 (padding-color (color-rgb 1 1 1))
778 (padding-in-show-all no))
779 Sets the default settings used when an image is viewed in
781 fullscreen mode. This is a parameter list.
782 (activate-on-focus yes)
785 When enabled, an image will become the active image when its
787 image window receives the focus. This is useful for window man‐
788 agers using "click to focus".
789 Possible values are yes and no.
790 (space-bar-action pan)
793 What to do when the space bar is pressed in the image window.
795 Possible values are none, pan and move.
796 (zoom-quality high)
799 There's a tradeoff between speed and quality of the zoomed-out
801 display. Possible values are low and high.
802 (use-event-history no)
805 Bugs in event history buffer are frequent so in case of cursor
807 offset problems turning it off helps. Possible values are yes
808 and no.
809 (edit-non-visible no)
812 When enabled, non-visible layers can be edited as normal. Pos‐
814 sible values are yes and no.
815 (move-tool-changes-active no)
818 If enabled, the move tool sets the edited layer or path as
820 active. This used to be the default behaviour in older ver‐
821 sions. Possible values are yes and no.
822 (filter-tool-max-recent 10)
825 How many recent settings to keep around in filter tools. This
827 is an integer value.
828 (filter-tool-use-last-settings no)
831 Default to the last used settings in filter tools. Possible
833 values are yes and no.
834 (filter-tool-show-color-options no)
837 Show advanced color options in filter tools. Possible values
839 are yes and no.
840 (trust-dirty-flag no)
843 When enabled, GIMP will not save an image if it has not been
845 changed since it was opened. Possible values are yes and no.
846 (save-device-status yes)
849 Remember the current tool, pattern, color, and brush across GIMP
851 sessions. Possible values are yes and no.
852 (devices-share-tool no)
855 When enabled, the same tool and tool options will be used for
857 all input devices. No tool switching will occur when the input
858 device changes. Possible values are yes and no.
859 (save-session-info yes)
862 Save the positions and sizes of the main dialogs when GIMP
864 exits. Possible values are yes and no.
865 (restore-session yes)
868 Let GIMP try to restore your last saved session on each startup.
870 Possible values are yes and no.
871 (restore-monitor no)
874 When enabled, GIMP will try to restore windows on the monitor
876 they were open before. When disabled, windows will appear on
877 the currently used monitor. Possible values are yes and no.
878 (save-tool-options yes)
881 Save the tool options when GIMP exits. Possible values are yes
883 and no.
884 (compact-sliders yes)
887 Use compact style for sliders. Possible values are yes and no.
889 (show-tooltips yes)
892 Show a tooltip when the pointer hovers over an item. Possible
894 values are yes and no.
895 (tearoff-menus yes)
898 When enabled, menus can be torn off. Possible values are yes
900 and no.
901 (can-change-accels no)
904 When enabled, you can change keyboard shortcuts for menu items
906 by hitting a key combination while the menu item is highlighted.
907 Possible values are yes and no.
908 (save-accels yes)
911 Save changed keyboard shortcuts when GIMP exits. Possible val‐
913 ues are yes and no.
914 (restore-accels yes)
917 Restore saved keyboard shortcuts on each GIMP startup. Possible
919 values are yes and no.
920 (last-opened-size 10)
923 How many recently opened image filenames to keep on the File
925 menu. This is an integer value.
926 (max-new-image-size 128M)
929 GIMP will warn the user if an attempt is made to create an image
931 that would take more memory than the size specified here. The
932 integer size can contain a suffix of 'B', 'K', 'M' or 'G' which
933 makes GIMP interpret the size as being specified in bytes, kilo‐
934 bytes, megabytes or gigabytes. If no suffix is specified the
935 size defaults to being specified in kilobytes.
936 (toolbox-color-area yes)
939 Show the current foreground and background colors in the tool‐
941 box. Possible values are yes and no.
942 (toolbox-foo-area no)
945 Show the currently selected brush, pattern and gradient in the
947 toolbox. Possible values are yes and no.
948 (toolbox-image-area no)
951 Show the currently active image in the toolbox. Possible values
953 are yes and no.
954 (toolbox-wilber yes)
957 Show the GIMP mascot at the top of the toolbox. Possible values
959 are yes and no.
960 (toolbox-groups yes)
963 Use a single toolbox button for grouped tools. Possible values
965 are yes and no.
966 (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
969 Sets the theme search path. This is a colon-separated list of
971 folders to search.
972 (theme "Dark")
975 The name of the theme to use. This is a string value.
977 (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
980 Sets the icon theme search path. This is a colon-separated list
982 of folders to search.
983 (icon-theme "Symbolic")
986 The name of the icon theme to use. This is a string value.
988 (icon-size auto)
991 The size of the icons to use. Possible values are auto, theme,
993 small, medium, large and huge.
994 (use-help yes)
997 When enabled, pressing F1 will open the help browser. Possible
999 values are yes and no.
1000 (show-help-button yes)
1003 When enabled, dialogs will show a help button that gives access
1005 to the related help page. Without this button, the help page
1006 can still be reached by pressing F1. Possible values are yes
1007 and no.
1008 (help-locales "")
1011 Specifies the language preferences used by the help system. This
1013 is a colon-separated list of language identifiers with decreas‐
1014 ing priority. If empty, the language is taken from the user's
1015 locale setting. This is a string value.
1016 (help-browser gimp)
1019 Sets the browser used by the help system. Possible values are
1021 gimp and web-browser.
1022 (search-show-unavailable-actions no)
1025 When enabled, a search of actions will also return inactive
1027 actions. Possible values are yes and no.
1028 (action-history-size 100)
1031 The maximum number of actions saved in history. This is an
1033 integer value.
1034 (user-manual-online no)
1037 When enabled, the online user manual will be used by the help
1039 system. Otherwise the locally installed copy is used. Possible
1040 values are yes and no.
1041 (user-manual-online-uri "https://docs.gimp.org/2.10")
1044 The location of the online user manual. This is used if 'user-
1046 manual-online' is enabled. This is a string value.
1047 (dock-window-hint utility)
1050 The window type hint that is set on dock windows and the toolbox
1052 window. This may affect the way your window manager decorates
1053 and handles these windows. Possible values are normal, utility
1054 and keep-above.
1055 (cursor-handedness right)
1058 Sets the handedness for cursor positioning. Possible values are
1060 left and right.
1061 (playground-npd-tool no)
1064 Enable the N-Point Deformation tool. Possible values are yes
1066 and no.
1067 (playground-seamless-clone-tool no)
1070 Enable the Seamless Clone tool. Possible values are yes and no.
1072 (color-profile-policy ask)
1075 How to handle embedded color profiles when opening a file. Pos‐
1077 sible values are ask, keep and convert.
1078 Sets the default folder path for all color profile file dialogs. This
1082 is a
1083 single filename.
1084 (image-convert-profile-intent relative-colorimetric)
1087 Sets the default rendering intent for the 'Convert to Color Pro‐
1089 file' dialog. Possible values are perceptual, relative-colori‐
1090 metric, saturation and absolute-colorimetric.
1091 (image-convert-profile-black-point-compensation yes)
1094 Sets the default 'Black Point Compensation' state for the 'Con‐
1096 vert to Color Profile' dialog. Possible values are yes and no.
1097 (image-convert-precision-layer-dither-method none)
1100 Sets the default layer dithering method for the 'Convert Preci‐
1102 sion' dialog. Possible values are none, floyd-steinberg, bayer,
1103 random, random-covariant, add, add-covariant, xor and xor-
1104 covariant.
1105 (image-convert-precision-text-layer-dither-method none)
1108 Sets the default text layer dithering method for the 'Convert
1110 Precision' dialog. Possible values are none, floyd-steinberg,
1111 bayer, random, random-covariant, add, add-covariant, xor and
1112 xor-covariant.
1113 (image-convert-precision-channel-dither-method none)
1116 Sets the default channel dithering method for the 'Convert Pre‐
1118 cision' dialog. Possible values are none, floyd-steinberg,
1119 bayer, random, random-covariant, add, add-covariant, xor and
1120 xor-covariant.
1121 (image-convert-indexed-palette-type generate)
1124 Sets the default palette type for the 'Convert to Indexed' dia‐
1126 log. Possible values are generate, web, mono and custom.
1127 (image-convert-indexed-max-colors 256)
1130 Sets the default maximum number of colors for the 'Convert to
1132 Indexed' dialog.
1133 This is an integer value.
1134 (image-convert-indexed-remove-duplicates yes)
1137 Sets the default 'Remove duplicate colors' state for the 'Con‐
1139 vert to Indexed' dialog. Possible values are yes and no.
1140 (image-convert-indexed-dither-type none)
1143 Sets the default dithering type for the 'Convert to Indexed'
1145 dialog. Possible values are none, fs, fs-lowbleed and fixed.
1146 (image-convert-indexed-dither-alpha no)
1149 Sets the default 'Dither alpha' state for the 'Convert to
1151 Indexed' dialog. Possible values are yes and no.
1152 (image-convert-indexed-dither-text-layers no)
1155 Sets the default 'Dither text layers' state for the 'Convert to
1157 Indexed' dialog. Possible values are yes and no.
1158 (image-resize-fill-type transparent)
1161 Sets the default fill type for the 'Canvas Size' dialog. Possi‐
1163 ble values are foreground, background, white, transparent and
1164 pattern.
1165 (image-resize-layer-set none)
1168 Sets the default set of layers to resize for the 'Canvas Size'
1170 dialog. Possible values are none, all, image-sized, visible and
1171 linked.
1172 (image-resize-resize-text-layers no)
1175 Sets the default 'Resize text layers' state for the 'Canvas
1177 Size' dialog. Possible values are yes and no.
1178 (layer-new-name "Layer")
1181 Sets the default layer name for the 'New Layer' dialog. This is
1183 a string value.
1184 (layer-new-mode normal)
1187 Sets the default mode for the 'New Layer' dialog. Possible val‐
1189 ues are normal-legacy, dissolve, behind-legacy, multiply-legacy,
1190 screen-legacy, overlay-legacy, difference-legacy, addition-
1191 legacy, subtract-legacy, darken-only-legacy, lighten-only-
1192 legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy,
1193 hsv-value-legacy, divide-legacy, dodge-legacy, burn-legacy,
1194 hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-
1195 merge-legacy, color-erase-legacy, overlay, lch-hue, lch-chroma,
1196 lch-color, lch-lightness, normal, behind, multiply, screen, dif‐
1197 ference, addition, subtract, darken-only, lighten-only, hsv-hue,
1198 hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hard‐
1199 light, softlight, grain-extract, grain-merge, vivid-light, pin-
1200 light, linear-light, hard-mix, exclusion, linear-burn, luma-
1201 darken-only, luma-lighten-only, luminance, color-erase, erase,
1202 merge, split, pass-through, replace and anti-erase.
1203 (layer-new-blend-space auto)
1206 Sets the default blend space for the 'New Layer' dialog. Possi‐
1208 ble values are auto, rgb-linear, rgb-perceptual and lab.
1209 (layer-new-composite-space auto)
1212 Sets the default composite space for the 'New Layer' dialog.
1214 Possible values are auto, rgb-linear, rgb-perceptual and lab.
1215 (layer-new-composite-mode auto)
1218 Sets the default composite mode for the 'New Layer' dialog.
1220 Possible values are auto, union, clip-to-backdrop, clip-to-layer
1221 and intersection.
1222 (layer-new-opacity 1)
1225 Sets the default opacity for the 'New Layer' dialog. This is a
1227 float value.
1228 (layer-new-fill-type transparent)
1231 Sets the default fill type for the 'New Layer' dialog. Possible
1233 values are foreground, background, white, transparent and pat‐
1234 tern.
1235 (layer-resize-fill-type transparent)
1238 Sets the default fill type for the 'Layer Boundary Size' dialog.
1240 Possible values are foreground, background, white, transparent
1241 and pattern.
1242 (layer-add-mask-type white)
1245 Sets the default mask for the 'Add Layer Mask' dialog. Possible
1247 values are white, black, alpha, alpha-transfer, selection, copy
1248 and channel.
1249 (layer-add-mask-invert no)
1252 Sets the default 'invert mask' state for the 'Add Layer Mask'
1254 dialog. Possible values are yes and no.
1255 (layer-merge-type expand-as-necessary)
1258 Sets the default merge type for the 'Merge Visible Layers' dia‐
1260 log. Possible values are expand-as-necessary, clip-to-image,
1261 clip-to-bottom-layer and flatten-image.
1262 (layer-merge-active-group-only yes)
1265 Sets the default 'Active group only' for the 'Merge Visible Lay‐
1267 ers' dialog. Possible values are yes and no.
1268 (layer-merge-discard-invisible no)
1271 Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1273 ers' dialog. Possible values are yes and no.
1274 (channel-new-name "Channel")
1277 Sets the default channel name for the 'New Channel' dialog.
1279 This is a string value.
1280 (channel-new-color (color-rgba 0 0 0 0.5))
1283 Sets the default color and opacity for the 'New Channel' dialog.
1285 The color is specified in the form (color-rgba red green blue
1286 alpha) with channel values as floats in the range of 0.0 to 1.0.
1287 (path-new-name "Path")
1290 Sets the default path name for the 'New Path' dialog. This is a
1292 string value.
1293 Sets the default folder path for the 'Export Path' dialog. This is a
1297 single
1298 filename.
1299 (path-export-active-only yes)
1302 Sets the default 'Export the active path' state for the 'Export
1304 Path' dialog. Possible values are yes and no.
1305 Sets the default folder path for the 'Import Path' dialog. This is a
1309 single
1310 filename.
1311 (path-import-merge no)
1314 Sets the default 'Merge imported paths' state for the 'Import
1316 Path' dialog. Possible values are yes and no.
1317 (path-import-scale no)
1320 Sets the default 'Scale imported paths to fit size' state for
1322 the 'Import Path' dialog. Possible values are yes and no.
1323 (selection-feather-radius 5)
1326 Sets the default feather radius for the 'Feather Selection' dia‐
1328 log. This is a float value.
1329 (selection-feather-edge-lock yes)
1332 Sets the default 'Selected areas continue outside the image'
1334 setting for the 'Feather Selection' dialog. Possible values are
1335 yes and no.
1336 (selection-grow-radius 1)
1339 Sets the default grow radius for the 'Grow Selection' dialog.
1341 This is a float value.
1342 (selection-shrink-radius 1)
1345 Sets the default shrink radius for the 'Shrink Selection' dia‐
1347 log. This is a float value.
1348 (selection-shrink-edge-lock no)
1351 Sets the default 'Selected areas continue outside the image'
1353 setting for the 'Shrink Selection' dialog. Possible values are
1354 yes and no.
1355 (selection-border-radius 5)
1358 Sets the default border radius for the 'Border Selection' dia‐
1360 log. This is a float value.
1361 (selection-border-style smooth)
1364 Sets the default border style for the 'Border Selection' dialog.
1366 Possible values are hard, smooth and feathered.
1367 (selection-border-edge-lock no)
1370 Sets the default 'Selected areas continue outside the image'
1372 setting for the 'Border Selection' dialog. Possible values are
1373 yes and no.
1374 (fill-options
1377 (style solid)
1378 (antialias yes)
1379 (feather no)
1380 (feather-radius 10))
1381 The default fill options for the fill dialogs. This is a param‐
1383 eter list.
1384 (stroke-options
1387 (style solid)
1388 (antialias yes)
1389 (feather no)
1390 (feather-radius 10)
1391 (method line)
1392 (width 6)
1393 (unit pixels)
1394 (cap-style butt)
1395 (join-style miter)
1396 (miter-limit 10)
1397 (dash-offset 0)
1398 (dash-info 0)
1399 (emulate-brush-dynamics no))
1400 The default stroke options for the stroke dialogs. This is a
1402 parameter list.
1403 (fractalexplorer-path "${gimp_dir}/fractalex‐
1406 plorer:${gimp_data_dir}/fractalexplorer")
1407 Where to search for fractals used by the Fractal Explorer plug-
1409 in. This is a colon-separated list of folders to search.
1410 (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1413 Where to search for Gfig figures used by the Gfig plug-in. This
1415 is a colon-separated list of folders to search.
1416 (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1419 Where to search for gflares used by the GFlare plug-in. This is
1421 a colon-separated list of folders to search.
1422 (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1425 pressionist")
1426 Where to search for data used by the Gimpressionist plug-in.
1428 This is a colon-separated list of folders to search.
1429 (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1432 This path will be searched for scripts when the Script-Fu plug-
1434 in is run. This is a colon-separated list of folders to search.
1435
1438 Strings of type PATH are expanded in a manner similar to bash(1).
1439 Specifically: tilde (~) is expanded to the user's home directory. Note
1440 that the bash feature of being able to refer to other user's home
1441 directories by writing ~userid/ is not valid in this file.
1442 ${variable} is expanded to the current value of an environment vari‐
1444 able. There are a few variables that are pre-defined:
1445 gimp_dir
1447 The personal gimp directory which is set to the value of the
1448 environment variable GIMP2_DIRECTORY or to $XDG_CON‐
1449 FIG_HOME/GIMP/2.10.
1450 gimp_data_dir
1452 Base for paths to shareable data, which is set to the value of
1453 the environment variable GIMP2_DATADIR or to the compiled-in
1454 default value /usr/share/gimp/2.0.
1455 gimp_plug_in_dir
1457 Base to paths for architecture-specific plug-ins and modules,
1458 which is set to the value of the environment variable
1459 GIMP2_PLUGINDIR or to the compiled-in default value
1460 /usr/lib64/gimp/2.0.
1461 gimp_sysconf_dir
1463 Path to configuration files, which is set to the value of the
1464 environment variable GIMP2_SYSCONFDIR or to the compiled-in
1465 default value /etc/gimp/2.0.
1466 gimp_cache_dir
1468 Path to cached files, which is set to the value of the environ‐
1469 ment variable GIMP2_CACHEDIR or to the system default for per-
1470 user cached files.
1471 gimp_temp_dir
1473 Path to temporary files, which is set to the value of the envi‐
1474 ronment variable GIMP2_TEMPDIR or to the system default for tem‐
1475 porary files.
1476
1479 /etc/gimp/2.0/gimprc
1480 System-wide configuration file
1481 $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1483 Per-user configuration file
1484
1487 gimp(1)
1488GIMP Manual Pages Version 2.10.18 GIMPRC(5)