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, no‐
97 halo 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-data/1.0/brushes:~/.my‐
158 paint/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 pa‐
314 rameter 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 in‐
343 teger 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 (show-rgb-u8 no)
417 (show-hsv no)
418 (display-module "CdisplayLcms"))
419 Defines the color management behavior. This is a parameter
421 list.
422 (save-document-history yes)
425 Keep a permanent record of all opened and saved files in the Re‐
427 cent Documents list. Possible values are yes and no.
428 (quick-mask-color (color-rgba 1 0 0 0.5))
431 Sets the default quick mask color. The color is specified in
433 the form (color-rgba red green blue alpha) with channel values
434 as floats in the range of 0.0 to 1.0.
435 (import-promote-float no)
438 Promote imported images to floating point precision. Does not
440 apply to indexed images. Possible values are yes and no.
441 (import-promote-dither yes)
444 When promoting imported images to floating point precision, also
446 add minimal noise in order to distribute color values a bit.
447 Possible values are yes and no.
448 (import-add-alpha no)
451 Add an alpha channel to all layers of imported images. Possible
453 values are yes and no.
454 (import-raw-plug-in "")
457 Which plug-in to use for importing raw digital camera files.
459 This is a single filename.
460 (export-file-type png)
463 Export file type used by default. Possible values are png, jpg,
465 ora, psd, pdf, tif, bmp and webp.
466 (export-color-profile yes)
469 Export the image's color profile by default. Possible values
471 are yes and no.
472 (export-metadata-exif yes)
475 Export Exif metadata by default. Possible values are yes and
477 no.
478 (export-metadata-xmp yes)
481 Export XMP metadata by default. Possible values are yes and no.
483 (export-metadata-iptc yes)
486 Export IPTC metadata by default. Possible values are yes and
488 no.
489 (debug-policy fatal)
492 Try generating debug data for bug reporting when appropriate.
494 Possible values are warning, critical, fatal and never.
495 (check-updates yes)
498 Check for availability of GIMP updates through background inter‐
500 net queries. Possible values are yes and no.
501 (check-update-timestamp 0)
504 Timestamp of the last update check. (null)
506 (last-release-timestamp 0)
509 The timestamp for the last known release date. (null)
511 The last known release version of GIMP as queried from official web‐
515 site. This
516 is a string value.
517 (last-revision 0)
520 The timestamp for the last known release date. This is an inte‐
522 ger value.
523 The last known release version of GIMP as queried from official web‐
527 site. This
528 is a string value.
529 (transparency-size medium-checks)
532 Sets the size of the checkerboard used to display transparency.
534 Possible values are small-checks, medium-checks and large-
535 checks.
536 (transparency-type gray-checks)
539 Sets the manner in which transparency is displayed in images.
541 Possible values are light-checks, gray-checks, dark-checks,
542 white-only, gray-only and black-only.
543 (snap-distance 8)
546 This is the distance in pixels where Guide and Grid snapping ac‐
548 tivates. This is an integer value.
549 (marching-ants-speed 200)
552 Speed of marching ants in the selection outline. This value is
554 in milliseconds (less time indicates faster marching). This is
555 an integer value.
556 (resize-windows-on-zoom no)
559 When enabled, the image window will automatically resize itself
561 when zooming into and out of images. This setting only takes ef‐
562 fect in multi-window mode. Possible values are yes and no.
563 (resize-windows-on-resize no)
566 When enabled, the image window will automatically resize itself
568 whenever the physical image size changes. This setting only
569 takes effect in multi-window mode. Possible values are yes and
570 no.
571 (default-show-all no)
574 Show full image content by default. Possible values are yes and
576 no.
577 (default-dot-for-dot yes)
580 When enabled, this will ensure that each pixel of an image gets
582 mapped to a pixel on the screen. Possible values are yes and
583 no.
584 (initial-zoom-to-fit yes)
587 When enabled, this will ensure that the full image is visible
589 after a file is opened, otherwise it will be displayed with a
590 scale of 1:1. Possible values are yes and no.
591 (cursor-mode tool-crosshair)
594 Sets the type of mouse pointers to use. Possible values are
596 tool-icon, tool-crosshair and crosshair.
597 (cursor-updating yes)
600 Context-dependent mouse pointers are helpful. They are enabled
602 by default. However, they require overhead that you may want to
603 do without. Possible values are yes and no.
604 (show-brush-outline yes)
607 When enabled, all paint tools will show a preview of the current
609 brush's outline. Possible values are yes and no.
610 (snap-brush-outline no)
613 When enabled, the brush outline will snap to individual dabs
615 while painting. Possible values are yes and no.
616 (show-paint-tool-cursor yes)
619 When enabled, the mouse pointer will be shown over the image
621 while using a paint tool. Possible values are yes and no.
622 (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
625 Sets the text to appear in image window titles. This is a for‐
627 mat string; certain % character sequences are recognised and ex‐
628 panded as follows:
629 %% literal percent sign
631 %f bare filename, or "Untitled"
632 %F full path to file, or "Untitled"
633 %p PDB image id
634 %i view instance number
635 %t image type (RGB, grayscale, indexed)
636 %z zoom factor as a percentage
637 %s source scale factor
638 %d destination scale factor
639 %Dx expands to x if the image is dirty, the empty string other‐
640 wise
641 %Cx expands to x if the image is clean, the empty string other‐
642 wise
643 %B expands to (modified) if the image is dirty, the empty
644 string otherwise
645 %A expands to (clean) if the image is clean, the empty string
646 otherwise
647 %Nx expands to x if the image is export-dirty, the empty string
648 otherwise
649 %Ex expands to x if the image is export-clean, the empty string
650 otherwise
651 %l the number of layers
652 %L the number of layers (long form)
653 %m memory used by the image
654 %n the name of the active layer/channel
655 %P the PDB id of the active layer/channel
656 %w image width in pixels
657 %W image width in real-world units
658 %h image height in pixels
659 %H image height in real-world units
660 %M the image size expressed in megapixels
661 %u unit symbol
662 %U unit abbreviation
663 %x the width of the active layer/channel in pixels
664 %X the width of the active layer/channel in real-world units
665 %y the height of the active layer/channel in pixels
666 %Y the height of the active layer/channel in real-world units
667 %o the name of the image's color profile
668 (image-status-format "%n (%m)")
672 Sets the text to appear in image window status bars. This is a
674 format string; certain % character sequences are recognised and
675 expanded as follows:
676 %% literal percent sign
678 %f bare filename, or "Untitled"
679 %F full path to file, or "Untitled"
680 %p PDB image id
681 %i view instance number
682 %t image type (RGB, grayscale, indexed)
683 %z zoom factor as a percentage
684 %s source scale factor
685 %d destination scale factor
686 %Dx expands to x if the image is dirty, the empty string other‐
687 wise
688 %Cx expands to x if the image is clean, the empty string other‐
689 wise
690 %B expands to (modified) if the image is dirty, the empty
691 string otherwise
692 %A expands to (clean) if the image is clean, the empty string
693 otherwise
694 %Nx expands to x if the image is export-dirty, the empty string
695 otherwise
696 %Ex expands to x if the image is export-clean, the empty string
697 otherwise
698 %l the number of layers
699 %L the number of layers (long form)
700 %m memory used by the image
701 %n the name of the active layer/channel
702 %P the PDB id of the active layer/channel
703 %w image width in pixels
704 %W image width in real-world units
705 %h image height in pixels
706 %H image height in real-world units
707 %M the image size expressed in megapixels
708 %u unit symbol
709 %U unit abbreviation
710 %x the width of the active layer/channel in pixels
711 %X the width of the active layer/channel in real-world units
712 %y the height of the active layer/channel in pixels
713 %Y the height of the active layer/channel in real-world units
714 %o the name of the image's color profile
715 (monitor-xresolution 96)
719 Sets the monitor's horizontal resolution, in dots per inch. If
721 set to 0, forces the X server to be queried for both horizontal
722 and vertical resolution information. This is a float value.
723 (monitor-yresolution 96)
726 Sets the monitor's vertical resolution, in dots per inch. If
728 set to 0, forces the X server to be queried for both horizontal
729 and vertical resolution information. This is a float value.
730 (monitor-resolution-from-windowing-system yes)
733 When enabled, GIMP will use the monitor resolution from the win‐
735 dowing system. Possible values are yes and no.
736 (navigation-preview-size medium)
739 Sets the size of the navigation preview available in the lower
741 right corner of the image window. Possible values are tiny, ex‐
742 tra-small, small, medium, large, extra-large, huge, enormous and
743 gigantic.
744 (default-view
747 (show-menubar yes)
748 (show-statusbar yes)
749 (show-rulers yes)
750 (show-scrollbars yes)
751 (show-selection yes)
752 (show-layer-boundary yes)
753 (show-canvas-boundary yes)
754 (show-guides yes)
755 (show-grid no)
756 (show-sample-points yes)
757 (snap-to-guides yes)
758 (snap-to-grid no)
759 (snap-to-canvas no)
760 (snap-to-path no)
761 (padding-mode default)
762 (padding-color (color-rgb 1 1 1))
763 (padding-in-show-all no))
764 Sets the default settings for the image view. This is a parame‐
766 ter list.
767 (default-fullscreen-view
770 (show-menubar yes)
771 (show-statusbar yes)
772 (show-rulers yes)
773 (show-scrollbars yes)
774 (show-selection yes)
775 (show-layer-boundary yes)
776 (show-canvas-boundary yes)
777 (show-guides yes)
778 (show-grid no)
779 (show-sample-points yes)
780 (snap-to-guides yes)
781 (snap-to-grid no)
782 (snap-to-canvas no)
783 (snap-to-path no)
784 (padding-mode default)
785 (padding-color (color-rgb 1 1 1))
786 (padding-in-show-all no))
787 Sets the default settings used when an image is viewed in
789 fullscreen mode. This is a parameter list.
790 (activate-on-focus yes)
793 When enabled, an image will become the active image when its im‐
795 age window receives the focus. This is useful for window man‐
796 agers using "click to focus".
797 Possible values are yes and no.
798 (space-bar-action pan)
801 What to do when the space bar is pressed in the image window.
803 Possible values are none, pan and move.
804 (zoom-quality high)
807 There's a tradeoff between speed and quality of the zoomed-out
809 display. Possible values are low and high.
810 (use-event-history no)
813 Bugs in event history buffer are frequent so in case of cursor
815 offset problems turning it off helps. Possible values are yes
816 and no.
817 (edit-non-visible no)
820 When enabled, non-visible layers can be edited as normal. Pos‐
822 sible values are yes and no.
823 (move-tool-changes-active no)
826 If enabled, the move tool sets the edited layer or path as ac‐
828 tive. This used to be the default behaviour in older versions.
829 Possible values are yes and no.
830 (filter-tool-max-recent 10)
833 How many recent settings to keep around in filter tools. This
835 is an integer value.
836 (filter-tool-use-last-settings no)
839 Default to the last used settings in filter tools. Possible
841 values are yes and no.
842 (filter-tool-show-color-options no)
845 Show advanced color options in filter tools. Possible values
847 are yes and no.
848 (trust-dirty-flag no)
851 When enabled, GIMP will not save an image if it has not been
853 changed since it was opened. Possible values are yes and no.
854 (save-device-status yes)
857 Remember the current tool, pattern, color, and brush across GIMP
859 sessions. Possible values are yes and no.
860 (devices-share-tool no)
863 When enabled, the same tool and tool options will be used for
865 all input devices. No tool switching will occur when the input
866 device changes. Possible values are yes and no.
867 (save-session-info yes)
870 Save the positions and sizes of the main dialogs when GIMP ex‐
872 its. Possible values are yes and no.
873 (restore-session yes)
876 Let GIMP try to restore your last saved session on each startup.
878 Possible values are yes and no.
879 (restore-monitor no)
882 When enabled, GIMP will try to restore windows on the monitor
884 they were open before. When disabled, windows will appear on
885 the currently used monitor. Possible values are yes and no.
886 (save-tool-options yes)
889 Save the tool options when GIMP exits. Possible values are yes
891 and no.
892 (compact-sliders yes)
895 Use compact style for sliders. Possible values are yes and no.
897 (show-tooltips yes)
900 Show a tooltip when the pointer hovers over an item. Possible
902 values are yes and no.
903 (tearoff-menus yes)
906 When enabled, menus can be torn off. Possible values are yes
908 and no.
909 (can-change-accels no)
912 When enabled, you can change keyboard shortcuts for menu items
914 by hitting a key combination while the menu item is highlighted.
915 Possible values are yes and no.
916 (save-accels yes)
919 Save changed keyboard shortcuts when GIMP exits. Possible val‐
921 ues are yes and no.
922 (restore-accels yes)
925 Restore saved keyboard shortcuts on each GIMP startup. Possible
927 values are yes and no.
928 (last-opened-size 10)
931 How many recently opened image filenames to keep on the File
933 menu. This is an integer value.
934 (max-new-image-size 128M)
937 GIMP will warn the user if an attempt is made to create an image
939 that would take more memory than the size specified here. The
940 integer size can contain a suffix of 'B', 'K', 'M' or 'G' which
941 makes GIMP interpret the size as being specified in bytes, kilo‐
942 bytes, megabytes or gigabytes. If no suffix is specified the
943 size defaults to being specified in kilobytes.
944 (toolbox-color-area yes)
947 Show the current foreground and background colors in the tool‐
949 box. Possible values are yes and no.
950 (toolbox-foo-area no)
953 Show the currently selected brush, pattern and gradient in the
955 toolbox. Possible values are yes and no.
956 (toolbox-image-area no)
959 Show the currently active image in the toolbox. Possible values
961 are yes and no.
962 (toolbox-wilber yes)
965 Show the GIMP mascot at the top of the toolbox. Possible values
967 are yes and no.
968 (toolbox-groups yes)
971 Use a single toolbox button for grouped tools. Possible values
973 are yes and no.
974 (toolbox-group-menu-mode hover-single-column)
977 Menu mode of grouped tools. Possible values are click, hover
979 and hover-single-column.
980 (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
983 Sets the theme search path. This is a colon-separated list of
985 folders to search.
986 (theme "Dark")
989 The name of the theme to use. This is a string value.
991 (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
994 Sets the icon theme search path. This is a colon-separated list
996 of folders to search.
997 (icon-theme "Symbolic")
1000 The name of the icon theme to use. This is a string value.
1002 (icon-size auto)
1005 The size of the icons to use. Possible values are auto, theme,
1007 small, medium, large and huge.
1008 (use-help yes)
1011 When enabled, pressing F1 will open the help browser. Possible
1013 values are yes and no.
1014 (show-help-button yes)
1017 When enabled, dialogs will show a help button that gives access
1019 to the related help page. Without this button, the help page
1020 can still be reached by pressing F1. Possible values are yes
1021 and no.
1022 (help-locales "")
1025 Specifies the language preferences used by the help system. This
1027 is a colon-separated list of language identifiers with decreas‐
1028 ing priority. If empty, the language is taken from the user's
1029 locale setting. This is a string value.
1030 (help-browser web-browser)
1033 Sets the browser used by the help system. Possible values are
1035 gimp and web-browser.
1036 (search-show-unavailable-actions no)
1039 When enabled, a search of actions will also return inactive ac‐
1041 tions. Possible values are yes and no.
1042 (action-history-size 100)
1045 The maximum number of actions saved in history. This is an in‐
1047 teger value.
1048 (user-manual-online no)
1051 When enabled, the online user manual will be used by the help
1053 system. Otherwise the locally installed copy is used. Possible
1054 values are yes and no.
1055 (user-manual-online-uri "https://docs.gimp.org/2.10")
1058 The location of the online user manual. This is used if 'user-
1060 manual-online' is enabled. This is a string value.
1061 (dock-window-hint utility)
1064 The window type hint that is set on dock windows and the toolbox
1066 window. This may affect the way your window manager decorates
1067 and handles these windows. Possible values are normal, utility
1068 and keep-above.
1069 (cursor-handedness right)
1072 Sets the handedness for cursor positioning. Possible values are
1074 left and right.
1075 (playground-npd-tool no)
1078 Enable the N-Point Deformation tool. Possible values are yes
1080 and no.
1081 (playground-seamless-clone-tool no)
1084 Enable the Seamless Clone tool. Possible values are yes and no.
1086 (color-profile-policy ask)
1089 How to handle embedded color profiles when opening a file. Pos‐
1091 sible values are ask, keep and convert.
1092 Sets the default folder path for all color profile file dialogs. This
1096 is a
1097 single filename.
1098 (image-convert-profile-intent relative-colorimetric)
1101 Sets the default rendering intent for the 'Convert to Color Pro‐
1103 file' dialog. Possible values are perceptual, relative-colori‐
1104 metric, saturation and absolute-colorimetric.
1105 (image-convert-profile-black-point-compensation yes)
1108 Sets the default 'Black Point Compensation' state for the 'Con‐
1110 vert to Color Profile' dialog. Possible values are yes and no.
1111 (image-convert-precision-layer-dither-method none)
1114 Sets the default layer dithering method for the 'Convert Preci‐
1116 sion' dialog. Possible values are none, floyd-steinberg, bayer,
1117 random, random-covariant, add, add-covariant, xor, xor-covari‐
1118 ant, blue-noise and blue-noise-covariant.
1119 (image-convert-precision-text-layer-dither-method none)
1122 Sets the default text layer dithering method for the 'Convert
1124 Precision' dialog. Possible values are none, floyd-steinberg,
1125 bayer, random, random-covariant, add, add-covariant, xor, xor-
1126 covariant, blue-noise and blue-noise-covariant.
1127 (image-convert-precision-channel-dither-method none)
1130 Sets the default channel dithering method for the 'Convert Pre‐
1132 cision' dialog. Possible values are none, floyd-steinberg,
1133 bayer, random, random-covariant, add, add-covariant, xor, xor-
1134 covariant, blue-noise and blue-noise-covariant.
1135 (image-convert-indexed-palette-type generate)
1138 Sets the default palette type for the 'Convert to Indexed' dia‐
1140 log. Possible values are generate, web, mono and custom.
1141 (image-convert-indexed-max-colors 256)
1144 Sets the default maximum number of colors for the 'Convert to
1146 Indexed' dialog.
1147 This is an integer value.
1148 (image-convert-indexed-remove-duplicates yes)
1151 Sets the default 'Remove duplicate colors' state for the 'Con‐
1153 vert to Indexed' dialog. Possible values are yes and no.
1154 (image-convert-indexed-dither-type none)
1157 Sets the default dithering type for the 'Convert to Indexed' di‐
1159 alog. Possible values are none, fs, fs-lowbleed and fixed.
1160 (image-convert-indexed-dither-alpha no)
1163 Sets the default 'Dither alpha' state for the 'Convert to In‐
1165 dexed' dialog. Possible values are yes and no.
1166 (image-convert-indexed-dither-text-layers no)
1169 Sets the default 'Dither text layers' state for the 'Convert to
1171 Indexed' dialog. Possible values are yes and no.
1172 (image-resize-fill-type transparent)
1175 Sets the default fill type for the 'Canvas Size' dialog. Possi‐
1177 ble values are foreground, background, white, transparent and
1178 pattern.
1179 (image-resize-layer-set none)
1182 Sets the default set of layers to resize for the 'Canvas Size'
1184 dialog. Possible values are none, all, image-sized, visible and
1185 linked.
1186 (image-resize-resize-text-layers no)
1189 Sets the default 'Resize text layers' state for the 'Canvas
1191 Size' dialog. Possible values are yes and no.
1192 (layer-new-name "Layer")
1195 Sets the default layer name for the 'New Layer' dialog. This is
1197 a string value.
1198 (layer-new-mode normal)
1201 Sets the default mode for the 'New Layer' dialog. Possible val‐
1203 ues are normal-legacy, dissolve, behind-legacy, multiply-legacy,
1204 screen-legacy, overlay-legacy, difference-legacy, addition-
1205 legacy, subtract-legacy, darken-only-legacy, lighten-only-
1206 legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy,
1207 hsv-value-legacy, divide-legacy, dodge-legacy, burn-legacy,
1208 hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-
1209 merge-legacy, color-erase-legacy, overlay, lch-hue, lch-chroma,
1210 lch-color, lch-lightness, normal, behind, multiply, screen, dif‐
1211 ference, addition, subtract, darken-only, lighten-only, hsv-hue,
1212 hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hard‐
1213 light, softlight, grain-extract, grain-merge, vivid-light, pin-
1214 light, linear-light, hard-mix, exclusion, linear-burn, luma-
1215 darken-only, luma-lighten-only, luminance, color-erase, erase,
1216 merge, split, pass-through, replace and anti-erase.
1217 (layer-new-blend-space auto)
1220 Sets the default blend space for the 'New Layer' dialog. Possi‐
1222 ble values are auto, rgb-linear, rgb-perceptual and lab.
1223 (layer-new-composite-space auto)
1226 Sets the default composite space for the 'New Layer' dialog.
1228 Possible values are auto, rgb-linear, rgb-perceptual and lab.
1229 (layer-new-composite-mode auto)
1232 Sets the default composite mode for the 'New Layer' dialog.
1234 Possible values are auto, union, clip-to-backdrop, clip-to-layer
1235 and intersection.
1236 (layer-new-opacity 1)
1239 Sets the default opacity for the 'New Layer' dialog. This is a
1241 float value.
1242 (layer-new-fill-type transparent)
1245 Sets the default fill type for the 'New Layer' dialog. Possible
1247 values are foreground, background, white, transparent and pat‐
1248 tern.
1249 (layer-resize-fill-type transparent)
1252 Sets the default fill type for the 'Layer Boundary Size' dialog.
1254 Possible values are foreground, background, white, transparent
1255 and pattern.
1256 (layer-add-mask-type white)
1259 Sets the default mask for the 'Add Layer Mask' dialog. Possible
1261 values are white, black, alpha, alpha-transfer, selection, copy
1262 and channel.
1263 (layer-add-mask-invert no)
1266 Sets the default 'invert mask' state for the 'Add Layer Mask'
1268 dialog. Possible values are yes and no.
1269 (layer-merge-type expand-as-necessary)
1272 Sets the default merge type for the 'Merge Visible Layers' dia‐
1274 log. Possible values are expand-as-necessary, clip-to-image,
1275 clip-to-bottom-layer and flatten-image.
1276 (layer-merge-active-group-only yes)
1279 Sets the default 'Active group only' for the 'Merge Visible Lay‐
1281 ers' dialog. Possible values are yes and no.
1282 (layer-merge-discard-invisible no)
1285 Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1287 ers' dialog. Possible values are yes and no.
1288 (channel-new-name "Channel")
1291 Sets the default channel name for the 'New Channel' dialog.
1293 This is a string value.
1294 (channel-new-color (color-rgba 0 0 0 0.5))
1297 Sets the default color and opacity for the 'New Channel' dialog.
1299 The color is specified in the form (color-rgba red green blue
1300 alpha) with channel values as floats in the range of 0.0 to 1.0.
1301 (path-new-name "Path")
1304 Sets the default path name for the 'New Path' dialog. This is a
1306 string value.
1307 Sets the default folder path for the 'Export Path' dialog. This is a
1311 single
1312 filename.
1313 (path-export-active-only yes)
1316 Sets the default 'Export the active path' state for the 'Export
1318 Path' dialog. Possible values are yes and no.
1319 Sets the default folder path for the 'Import Path' dialog. This is a
1323 single
1324 filename.
1325 (path-import-merge no)
1328 Sets the default 'Merge imported paths' state for the 'Import
1330 Path' dialog. Possible values are yes and no.
1331 (path-import-scale no)
1334 Sets the default 'Scale imported paths to fit size' state for
1336 the 'Import Path' dialog. Possible values are yes and no.
1337 (selection-feather-radius 5)
1340 Sets the default feather radius for the 'Feather Selection' dia‐
1342 log. This is a float value.
1343 (selection-feather-edge-lock yes)
1346 Sets the default 'Selected areas continue outside the image'
1348 setting for the 'Feather Selection' dialog. Possible values are
1349 yes and no.
1350 (selection-grow-radius 1)
1353 Sets the default grow radius for the 'Grow Selection' dialog.
1355 This is a float value.
1356 (selection-shrink-radius 1)
1359 Sets the default shrink radius for the 'Shrink Selection' dia‐
1361 log. This is a float value.
1362 (selection-shrink-edge-lock no)
1365 Sets the default 'Selected areas continue outside the image'
1367 setting for the 'Shrink Selection' dialog. Possible values are
1368 yes and no.
1369 (selection-border-radius 5)
1372 Sets the default border radius for the 'Border Selection' dia‐
1374 log. This is a float value.
1375 (selection-border-style smooth)
1378 Sets the default border style for the 'Border Selection' dialog.
1380 Possible values are hard, smooth and feathered.
1381 (selection-border-edge-lock no)
1384 Sets the default 'Selected areas continue outside the image'
1386 setting for the 'Border Selection' dialog. Possible values are
1387 yes and no.
1388 (fill-options
1391 (style solid)
1392 (antialias yes)
1393 (feather no)
1394 (feather-radius 10))
1395 The default fill options for the fill dialogs. This is a param‐
1397 eter list.
1398 (stroke-options
1401 (style solid)
1402 (antialias yes)
1403 (feather no)
1404 (feather-radius 10)
1405 (method line)
1406 (width 6)
1407 (unit pixels)
1408 (cap-style butt)
1409 (join-style miter)
1410 (miter-limit 10)
1411 (dash-offset 0)
1412 (dash-info 0)
1413 (emulate-brush-dynamics no))
1414 The default stroke options for the stroke dialogs. This is a
1416 parameter list.
1417 (fractalexplorer-path "${gimp_dir}/fractalex‐
1420 plorer:${gimp_data_dir}/fractalexplorer")
1421 Where to search for fractals used by the Fractal Explorer plug-
1423 in. This is a colon-separated list of folders to search.
1424 (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1427 Where to search for Gfig figures used by the Gfig plug-in. This
1429 is a colon-separated list of folders to search.
1430 (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1433 Where to search for gflares used by the GFlare plug-in. This is
1435 a colon-separated list of folders to search.
1436 (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1439 pressionist")
1440 Where to search for data used by the Gimpressionist plug-in.
1442 This is a colon-separated list of folders to search.
1443 (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1446 This path will be searched for scripts when the Script-Fu plug-
1448 in is run. This is a colon-separated list of folders to search.
1449
1452 Strings of type PATH are expanded in a manner similar to bash(1).
1453 Specifically: tilde (~) is expanded to the user's home directory. Note
1454 that the bash feature of being able to refer to other user's home di‐
1455 rectories by writing ~userid/ is not valid in this file.
1456 ${variable} is expanded to the current value of an environment vari‐
1458 able. There are a few variables that are pre-defined:
1459 gimp_dir
1461 The personal gimp directory which is set to the value of the en‐
1462 vironment variable GIMP2_DIRECTORY or to $XDG_CON‐
1463 FIG_HOME/GIMP/2.10.
1464 gimp_data_dir
1466 Base for paths to shareable data, which is set to the value of
1467 the environment variable GIMP2_DATADIR or to the compiled-in de‐
1468 fault value /usr/share/gimp/2.0.
1469 gimp_plug_in_dir
1471 Base to paths for architecture-specific plug-ins and modules,
1472 which is set to the value of the environment variable
1473 GIMP2_PLUGINDIR or to the compiled-in default value
1474 /usr/lib64/gimp/2.0.
1475 gimp_sysconf_dir
1477 Path to configuration files, which is set to the value of the
1478 environment variable GIMP2_SYSCONFDIR or to the compiled-in de‐
1479 fault value /etc/gimp/2.0.
1480 gimp_cache_dir
1482 Path to cached files, which is set to the value of the environ‐
1483 ment variable GIMP2_CACHEDIR or to the system default for per-
1484 user cached files.
1485 gimp_temp_dir
1487 Path to temporary files, which is set to the value of the envi‐
1488 ronment variable GIMP2_TEMPDIR or to the system default for tem‐
1489 porary files.
1490
1493 /etc/gimp/2.0/gimprc
1494 System-wide configuration file
1495 $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1497 Per-user configuration file
1498
1501 gimp(1)
1502GIMP Manual Pages Version 2.10.36 GIMPRC(5)