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 (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 Re‐
425 cent 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 The last known release version of GIMP as queried from official web‐
513 site. This
514 is a string value.
515 (last-revision 0)
518 The timestamp for the last known release date. This is an inte‐
520 ger value.
521 The last known release version of GIMP as queried from official web‐
525 site. This
526 is a string value.
527 (transparency-size medium-checks)
530 Sets the size of the checkerboard used to display transparency.
532 Possible values are small-checks, medium-checks and large-
533 checks.
534 (transparency-type gray-checks)
537 Sets the manner in which transparency is displayed in images.
539 Possible values are light-checks, gray-checks, dark-checks,
540 white-only, gray-only and black-only.
541 (snap-distance 8)
544 This is the distance in pixels where Guide and Grid snapping ac‐
546 tivates. This is an integer value.
547 (marching-ants-speed 200)
550 Speed of marching ants in the selection outline. This value is
552 in milliseconds (less time indicates faster marching). This is
553 an integer value.
554 (resize-windows-on-zoom no)
557 When enabled, the image window will automatically resize itself
559 when zooming into and out of images. This setting only takes ef‐
560 fect in multi-window mode. Possible values are yes and no.
561 (resize-windows-on-resize no)
564 When enabled, the image window will automatically resize itself
566 whenever the physical image size changes. This setting only
567 takes effect in multi-window mode. Possible values are yes and
568 no.
569 (default-show-all no)
572 Show full image content by default. Possible values are yes and
574 no.
575 (default-dot-for-dot yes)
578 When enabled, this will ensure that each pixel of an image gets
580 mapped to a pixel on the screen. Possible values are yes and
581 no.
582 (initial-zoom-to-fit yes)
585 When enabled, this will ensure that the full image is visible
587 after a file is opened, otherwise it will be displayed with a
588 scale of 1:1. Possible values are yes and no.
589 (cursor-mode tool-crosshair)
592 Sets the type of mouse pointers to use. Possible values are
594 tool-icon, tool-crosshair and crosshair.
595 (cursor-updating yes)
598 Context-dependent mouse pointers are helpful. They are enabled
600 by default. However, they require overhead that you may want to
601 do without. Possible values are yes and no.
602 (show-brush-outline yes)
605 When enabled, all paint tools will show a preview of the current
607 brush's outline. Possible values are yes and no.
608 (snap-brush-outline no)
611 When enabled, the brush outline will snap to individual dabs
613 while painting. Possible values are yes and no.
614 (show-paint-tool-cursor yes)
617 When enabled, the mouse pointer will be shown over the image
619 while using a paint tool. Possible values are yes and no.
620 (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
623 Sets the text to appear in image window titles. This is a for‐
625 mat string; certain % character sequences are recognised and ex‐
626 panded as follows:
627 %% literal percent sign
629 %f bare filename, or "Untitled"
630 %F full path to file, or "Untitled"
631 %p PDB image id
632 %i view instance number
633 %t image type (RGB, grayscale, indexed)
634 %z zoom factor as a percentage
635 %s source scale factor
636 %d destination scale factor
637 %Dx expands to x if the image is dirty, the empty string other‐
638 wise
639 %Cx expands to x if the image is clean, the empty string other‐
640 wise
641 %B expands to (modified) if the image is dirty, the empty
642 string otherwise
643 %A expands to (clean) if the image is clean, the empty string
644 otherwise
645 %Nx expands to x if the image is export-dirty, the empty string
646 otherwise
647 %Ex expands to x if the image is export-clean, the empty string
648 otherwise
649 %l the number of layers
650 %L the number of layers (long form)
651 %m memory used by the image
652 %n the name of the active layer/channel
653 %P the PDB id of the active layer/channel
654 %w image width in pixels
655 %W image width in real-world units
656 %h image height in pixels
657 %H image height in real-world units
658 %M the image size expressed in megapixels
659 %u unit symbol
660 %U unit abbreviation
661 %x the width of the active layer/channel in pixels
662 %X the width of the active layer/channel in real-world units
663 %y the height of the active layer/channel in pixels
664 %Y the height of the active layer/channel in real-world units
665 %o the name of the image's color profile
666 (image-status-format "%n (%m)")
670 Sets the text to appear in image window status bars. This is a
672 format string; certain % character sequences are recognised and
673 expanded as follows:
674 %% literal percent sign
676 %f bare filename, or "Untitled"
677 %F full path to file, or "Untitled"
678 %p PDB image id
679 %i view instance number
680 %t image type (RGB, grayscale, indexed)
681 %z zoom factor as a percentage
682 %s source scale factor
683 %d destination scale factor
684 %Dx expands to x if the image is dirty, the empty string other‐
685 wise
686 %Cx expands to x if the image is clean, the empty string other‐
687 wise
688 %B expands to (modified) if the image is dirty, the empty
689 string otherwise
690 %A expands to (clean) if the image is clean, the empty string
691 otherwise
692 %Nx expands to x if the image is export-dirty, the empty string
693 otherwise
694 %Ex expands to x if the image is export-clean, the empty string
695 otherwise
696 %l the number of layers
697 %L the number of layers (long form)
698 %m memory used by the image
699 %n the name of the active layer/channel
700 %P the PDB id of the active layer/channel
701 %w image width in pixels
702 %W image width in real-world units
703 %h image height in pixels
704 %H image height in real-world units
705 %M the image size expressed in megapixels
706 %u unit symbol
707 %U unit abbreviation
708 %x the width of the active layer/channel in pixels
709 %X the width of the active layer/channel in real-world units
710 %y the height of the active layer/channel in pixels
711 %Y the height of the active layer/channel in real-world units
712 %o the name of the image's color profile
713 (monitor-xresolution 96)
717 Sets the monitor's horizontal resolution, in dots per inch. If
719 set to 0, forces the X server to be queried for both horizontal
720 and vertical resolution information. This is a float value.
721 (monitor-yresolution 96)
724 Sets the monitor's vertical resolution, in dots per inch. If
726 set to 0, forces the X server to be queried for both horizontal
727 and vertical resolution information. This is a float value.
728 (monitor-resolution-from-windowing-system yes)
731 When enabled, GIMP will use the monitor resolution from the win‐
733 dowing system. Possible values are yes and no.
734 (navigation-preview-size medium)
737 Sets the size of the navigation preview available in the lower
739 right corner of the image window. Possible values are tiny, ex‐
740 tra-small, small, medium, large, extra-large, huge, enormous and
741 gigantic.
742 (default-view
745 (show-menubar yes)
746 (show-statusbar yes)
747 (show-rulers yes)
748 (show-scrollbars yes)
749 (show-selection yes)
750 (show-layer-boundary yes)
751 (show-canvas-boundary yes)
752 (show-guides yes)
753 (show-grid no)
754 (show-sample-points yes)
755 (snap-to-guides yes)
756 (snap-to-grid no)
757 (snap-to-canvas no)
758 (snap-to-path no)
759 (padding-mode default)
760 (padding-color (color-rgb 1 1 1))
761 (padding-in-show-all no))
762 Sets the default settings for the image view. This is a parame‐
764 ter list.
765 (default-fullscreen-view
768 (show-menubar yes)
769 (show-statusbar yes)
770 (show-rulers yes)
771 (show-scrollbars yes)
772 (show-selection yes)
773 (show-layer-boundary yes)
774 (show-canvas-boundary yes)
775 (show-guides yes)
776 (show-grid no)
777 (show-sample-points yes)
778 (snap-to-guides yes)
779 (snap-to-grid no)
780 (snap-to-canvas no)
781 (snap-to-path no)
782 (padding-mode default)
783 (padding-color (color-rgb 1 1 1))
784 (padding-in-show-all no))
785 Sets the default settings used when an image is viewed in
787 fullscreen mode. This is a parameter list.
788 (activate-on-focus yes)
791 When enabled, an image will become the active image when its im‐
793 age window receives the focus. This is useful for window man‐
794 agers using "click to focus".
795 Possible values are yes and no.
796 (space-bar-action pan)
799 What to do when the space bar is pressed in the image window.
801 Possible values are none, pan and move.
802 (zoom-quality high)
805 There's a tradeoff between speed and quality of the zoomed-out
807 display. Possible values are low and high.
808 (use-event-history no)
811 Bugs in event history buffer are frequent so in case of cursor
813 offset problems turning it off helps. Possible values are yes
814 and no.
815 (edit-non-visible no)
818 When enabled, non-visible layers can be edited as normal. Pos‐
820 sible values are yes and no.
821 (move-tool-changes-active no)
824 If enabled, the move tool sets the edited layer or path as ac‐
826 tive. This used to be the default behaviour in older versions.
827 Possible values are yes and no.
828 (filter-tool-max-recent 10)
831 How many recent settings to keep around in filter tools. This
833 is an integer value.
834 (filter-tool-use-last-settings no)
837 Default to the last used settings in filter tools. Possible
839 values are yes and no.
840 (filter-tool-show-color-options no)
843 Show advanced color options in filter tools. Possible values
845 are yes and no.
846 (trust-dirty-flag no)
849 When enabled, GIMP will not save an image if it has not been
851 changed since it was opened. Possible values are yes and no.
852 (save-device-status yes)
855 Remember the current tool, pattern, color, and brush across GIMP
857 sessions. Possible values are yes and no.
858 (devices-share-tool no)
861 When enabled, the same tool and tool options will be used for
863 all input devices. No tool switching will occur when the input
864 device changes. Possible values are yes and no.
865 (save-session-info yes)
868 Save the positions and sizes of the main dialogs when GIMP ex‐
870 its. Possible values are yes and no.
871 (restore-session yes)
874 Let GIMP try to restore your last saved session on each startup.
876 Possible values are yes and no.
877 (restore-monitor no)
880 When enabled, GIMP will try to restore windows on the monitor
882 they were open before. When disabled, windows will appear on
883 the currently used monitor. Possible values are yes and no.
884 (save-tool-options yes)
887 Save the tool options when GIMP exits. Possible values are yes
889 and no.
890 (compact-sliders yes)
893 Use compact style for sliders. Possible values are yes and no.
895 (show-tooltips yes)
898 Show a tooltip when the pointer hovers over an item. Possible
900 values are yes and no.
901 (tearoff-menus yes)
904 When enabled, menus can be torn off. Possible values are yes
906 and no.
907 (can-change-accels no)
910 When enabled, you can change keyboard shortcuts for menu items
912 by hitting a key combination while the menu item is highlighted.
913 Possible values are yes and no.
914 (save-accels yes)
917 Save changed keyboard shortcuts when GIMP exits. Possible val‐
919 ues are yes and no.
920 (restore-accels yes)
923 Restore saved keyboard shortcuts on each GIMP startup. Possible
925 values are yes and no.
926 (last-opened-size 10)
929 How many recently opened image filenames to keep on the File
931 menu. This is an integer value.
932 (max-new-image-size 128M)
935 GIMP will warn the user if an attempt is made to create an image
937 that would take more memory than the size specified here. The
938 integer size can contain a suffix of 'B', 'K', 'M' or 'G' which
939 makes GIMP interpret the size as being specified in bytes, kilo‐
940 bytes, megabytes or gigabytes. If no suffix is specified the
941 size defaults to being specified in kilobytes.
942 (toolbox-color-area yes)
945 Show the current foreground and background colors in the tool‐
947 box. Possible values are yes and no.
948 (toolbox-foo-area no)
951 Show the currently selected brush, pattern and gradient in the
953 toolbox. Possible values are yes and no.
954 (toolbox-image-area no)
957 Show the currently active image in the toolbox. Possible values
959 are yes and no.
960 (toolbox-wilber yes)
963 Show the GIMP mascot at the top of the toolbox. Possible values
965 are yes and no.
966 (toolbox-groups yes)
969 Use a single toolbox button for grouped tools. Possible values
971 are yes and no.
972 (toolbox-group-menu-mode hover-single-column)
975 Menu mode of grouped tools. Possible values are click, hover
977 and hover-single-column.
978 (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
981 Sets the theme search path. This is a colon-separated list of
983 folders to search.
984 (theme "Dark")
987 The name of the theme to use. This is a string value.
989 (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
992 Sets the icon theme search path. This is a colon-separated list
994 of folders to search.
995 (icon-theme "Symbolic")
998 The name of the icon theme to use. This is a string value.
1000 (icon-size auto)
1003 The size of the icons to use. Possible values are auto, theme,
1005 small, medium, large and huge.
1006 (use-help yes)
1009 When enabled, pressing F1 will open the help browser. Possible
1011 values are yes and no.
1012 (show-help-button yes)
1015 When enabled, dialogs will show a help button that gives access
1017 to the related help page. Without this button, the help page
1018 can still be reached by pressing F1. Possible values are yes
1019 and no.
1020 (help-locales "")
1023 Specifies the language preferences used by the help system. This
1025 is a colon-separated list of language identifiers with decreas‐
1026 ing priority. If empty, the language is taken from the user's
1027 locale setting. This is a string value.
1028 (help-browser web-browser)
1031 Sets the browser used by the help system. Possible values are
1033 gimp and web-browser.
1034 (search-show-unavailable-actions no)
1037 When enabled, a search of actions will also return inactive ac‐
1039 tions. Possible values are yes and no.
1040 (action-history-size 100)
1043 The maximum number of actions saved in history. This is an in‐
1045 teger value.
1046 (user-manual-online no)
1049 When enabled, the online user manual will be used by the help
1051 system. Otherwise the locally installed copy is used. Possible
1052 values are yes and no.
1053 (user-manual-online-uri "https://docs.gimp.org/2.10")
1056 The location of the online user manual. This is used if 'user-
1058 manual-online' is enabled. This is a string value.
1059 (dock-window-hint utility)
1062 The window type hint that is set on dock windows and the toolbox
1064 window. This may affect the way your window manager decorates
1065 and handles these windows. Possible values are normal, utility
1066 and keep-above.
1067 (cursor-handedness right)
1070 Sets the handedness for cursor positioning. Possible values are
1072 left and right.
1073 (playground-npd-tool no)
1076 Enable the N-Point Deformation tool. Possible values are yes
1078 and no.
1079 (playground-seamless-clone-tool no)
1082 Enable the Seamless Clone tool. Possible values are yes and no.
1084 (color-profile-policy ask)
1087 How to handle embedded color profiles when opening a file. Pos‐
1089 sible values are ask, keep and convert.
1090 Sets the default folder path for all color profile file dialogs. This
1094 is a
1095 single filename.
1096 (image-convert-profile-intent relative-colorimetric)
1099 Sets the default rendering intent for the 'Convert to Color Pro‐
1101 file' dialog. Possible values are perceptual, relative-colori‐
1102 metric, saturation and absolute-colorimetric.
1103 (image-convert-profile-black-point-compensation yes)
1106 Sets the default 'Black Point Compensation' state for the 'Con‐
1108 vert to Color Profile' dialog. Possible values are yes and no.
1109 (image-convert-precision-layer-dither-method none)
1112 Sets the default layer dithering method for the 'Convert Preci‐
1114 sion' dialog. Possible values are none, floyd-steinberg, bayer,
1115 random, random-covariant, add, add-covariant, xor, xor-covari‐
1116 ant, blue-noise and blue-noise-covariant.
1117 (image-convert-precision-text-layer-dither-method none)
1120 Sets the default text layer dithering method for the 'Convert
1122 Precision' dialog. Possible values are none, floyd-steinberg,
1123 bayer, random, random-covariant, add, add-covariant, xor, xor-
1124 covariant, blue-noise and blue-noise-covariant.
1125 (image-convert-precision-channel-dither-method none)
1128 Sets the default channel dithering method for the 'Convert Pre‐
1130 cision' dialog. Possible values are none, floyd-steinberg,
1131 bayer, random, random-covariant, add, add-covariant, xor, xor-
1132 covariant, blue-noise and blue-noise-covariant.
1133 (image-convert-indexed-palette-type generate)
1136 Sets the default palette type for the 'Convert to Indexed' dia‐
1138 log. Possible values are generate, web, mono and custom.
1139 (image-convert-indexed-max-colors 256)
1142 Sets the default maximum number of colors for the 'Convert to
1144 Indexed' dialog.
1145 This is an integer value.
1146 (image-convert-indexed-remove-duplicates yes)
1149 Sets the default 'Remove duplicate colors' state for the 'Con‐
1151 vert to Indexed' dialog. Possible values are yes and no.
1152 (image-convert-indexed-dither-type none)
1155 Sets the default dithering type for the 'Convert to Indexed' di‐
1157 alog. Possible values are none, fs, fs-lowbleed and fixed.
1158 (image-convert-indexed-dither-alpha no)
1161 Sets the default 'Dither alpha' state for the 'Convert to In‐
1163 dexed' dialog. Possible values are yes and no.
1164 (image-convert-indexed-dither-text-layers no)
1167 Sets the default 'Dither text layers' state for the 'Convert to
1169 Indexed' dialog. Possible values are yes and no.
1170 (image-resize-fill-type transparent)
1173 Sets the default fill type for the 'Canvas Size' dialog. Possi‐
1175 ble values are foreground, background, white, transparent and
1176 pattern.
1177 (image-resize-layer-set none)
1180 Sets the default set of layers to resize for the 'Canvas Size'
1182 dialog. Possible values are none, all, image-sized, visible and
1183 linked.
1184 (image-resize-resize-text-layers no)
1187 Sets the default 'Resize text layers' state for the 'Canvas
1189 Size' dialog. Possible values are yes and no.
1190 (layer-new-name "Layer")
1193 Sets the default layer name for the 'New Layer' dialog. This is
1195 a string value.
1196 (layer-new-mode normal)
1199 Sets the default mode for the 'New Layer' dialog. Possible val‐
1201 ues are normal-legacy, dissolve, behind-legacy, multiply-legacy,
1202 screen-legacy, overlay-legacy, difference-legacy, addition-
1203 legacy, subtract-legacy, darken-only-legacy, lighten-only-
1204 legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy,
1205 hsv-value-legacy, divide-legacy, dodge-legacy, burn-legacy,
1206 hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-
1207 merge-legacy, color-erase-legacy, overlay, lch-hue, lch-chroma,
1208 lch-color, lch-lightness, normal, behind, multiply, screen, dif‐
1209 ference, addition, subtract, darken-only, lighten-only, hsv-hue,
1210 hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hard‐
1211 light, softlight, grain-extract, grain-merge, vivid-light, pin-
1212 light, linear-light, hard-mix, exclusion, linear-burn, luma-
1213 darken-only, luma-lighten-only, luminance, color-erase, erase,
1214 merge, split, pass-through, replace and anti-erase.
1215 (layer-new-blend-space auto)
1218 Sets the default blend space for the 'New Layer' dialog. Possi‐
1220 ble values are auto, rgb-linear, rgb-perceptual and lab.
1221 (layer-new-composite-space auto)
1224 Sets the default composite space for the 'New Layer' dialog.
1226 Possible values are auto, rgb-linear, rgb-perceptual and lab.
1227 (layer-new-composite-mode auto)
1230 Sets the default composite mode for the 'New Layer' dialog.
1232 Possible values are auto, union, clip-to-backdrop, clip-to-layer
1233 and intersection.
1234 (layer-new-opacity 1)
1237 Sets the default opacity for the 'New Layer' dialog. This is a
1239 float value.
1240 (layer-new-fill-type transparent)
1243 Sets the default fill type for the 'New Layer' dialog. Possible
1245 values are foreground, background, white, transparent and pat‐
1246 tern.
1247 (layer-resize-fill-type transparent)
1250 Sets the default fill type for the 'Layer Boundary Size' dialog.
1252 Possible values are foreground, background, white, transparent
1253 and pattern.
1254 (layer-add-mask-type white)
1257 Sets the default mask for the 'Add Layer Mask' dialog. Possible
1259 values are white, black, alpha, alpha-transfer, selection, copy
1260 and channel.
1261 (layer-add-mask-invert no)
1264 Sets the default 'invert mask' state for the 'Add Layer Mask'
1266 dialog. Possible values are yes and no.
1267 (layer-merge-type expand-as-necessary)
1270 Sets the default merge type for the 'Merge Visible Layers' dia‐
1272 log. Possible values are expand-as-necessary, clip-to-image,
1273 clip-to-bottom-layer and flatten-image.
1274 (layer-merge-active-group-only yes)
1277 Sets the default 'Active group only' for the 'Merge Visible Lay‐
1279 ers' dialog. Possible values are yes and no.
1280 (layer-merge-discard-invisible no)
1283 Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1285 ers' dialog. Possible values are yes and no.
1286 (channel-new-name "Channel")
1289 Sets the default channel name for the 'New Channel' dialog.
1291 This is a string value.
1292 (channel-new-color (color-rgba 0 0 0 0.5))
1295 Sets the default color and opacity for the 'New Channel' dialog.
1297 The color is specified in the form (color-rgba red green blue
1298 alpha) with channel values as floats in the range of 0.0 to 1.0.
1299 (path-new-name "Path")
1302 Sets the default path name for the 'New Path' dialog. This is a
1304 string value.
1305 Sets the default folder path for the 'Export Path' dialog. This is a
1309 single
1310 filename.
1311 (path-export-active-only yes)
1314 Sets the default 'Export the active path' state for the 'Export
1316 Path' dialog. Possible values are yes and no.
1317 Sets the default folder path for the 'Import Path' dialog. This is a
1321 single
1322 filename.
1323 (path-import-merge no)
1326 Sets the default 'Merge imported paths' state for the 'Import
1328 Path' dialog. Possible values are yes and no.
1329 (path-import-scale no)
1332 Sets the default 'Scale imported paths to fit size' state for
1334 the 'Import Path' dialog. Possible values are yes and no.
1335 (selection-feather-radius 5)
1338 Sets the default feather radius for the 'Feather Selection' dia‐
1340 log. This is a float value.
1341 (selection-feather-edge-lock yes)
1344 Sets the default 'Selected areas continue outside the image'
1346 setting for the 'Feather Selection' dialog. Possible values are
1347 yes and no.
1348 (selection-grow-radius 1)
1351 Sets the default grow radius for the 'Grow Selection' dialog.
1353 This is a float value.
1354 (selection-shrink-radius 1)
1357 Sets the default shrink radius for the 'Shrink Selection' dia‐
1359 log. This is a float value.
1360 (selection-shrink-edge-lock no)
1363 Sets the default 'Selected areas continue outside the image'
1365 setting for the 'Shrink Selection' dialog. Possible values are
1366 yes and no.
1367 (selection-border-radius 5)
1370 Sets the default border radius for the 'Border Selection' dia‐
1372 log. This is a float value.
1373 (selection-border-style smooth)
1376 Sets the default border style for the 'Border Selection' dialog.
1378 Possible values are hard, smooth and feathered.
1379 (selection-border-edge-lock no)
1382 Sets the default 'Selected areas continue outside the image'
1384 setting for the 'Border Selection' dialog. Possible values are
1385 yes and no.
1386 (fill-options
1389 (style solid)
1390 (antialias yes)
1391 (feather no)
1392 (feather-radius 10))
1393 The default fill options for the fill dialogs. This is a param‐
1395 eter list.
1396 (stroke-options
1399 (style solid)
1400 (antialias yes)
1401 (feather no)
1402 (feather-radius 10)
1403 (method line)
1404 (width 6)
1405 (unit pixels)
1406 (cap-style butt)
1407 (join-style miter)
1408 (miter-limit 10)
1409 (dash-offset 0)
1410 (dash-info 0)
1411 (emulate-brush-dynamics no))
1412 The default stroke options for the stroke dialogs. This is a
1414 parameter list.
1415 (fractalexplorer-path "${gimp_dir}/fractalex‐
1418 plorer:${gimp_data_dir}/fractalexplorer")
1419 Where to search for fractals used by the Fractal Explorer plug-
1421 in. This is a colon-separated list of folders to search.
1422 (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1425 Where to search for Gfig figures used by the Gfig plug-in. This
1427 is a colon-separated list of folders to search.
1428 (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1431 Where to search for gflares used by the GFlare plug-in. This is
1433 a colon-separated list of folders to search.
1434 (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1437 pressionist")
1438 Where to search for data used by the Gimpressionist plug-in.
1440 This is a colon-separated list of folders to search.
1441 (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1444 This path will be searched for scripts when the Script-Fu plug-
1446 in is run. This is a colon-separated list of folders to search.
1447
1450 Strings of type PATH are expanded in a manner similar to bash(1).
1451 Specifically: tilde (~) is expanded to the user's home directory. Note
1452 that the bash feature of being able to refer to other user's home di‐
1453 rectories by writing ~userid/ is not valid in this file.
1454 ${variable} is expanded to the current value of an environment vari‐
1456 able. There are a few variables that are pre-defined:
1457 gimp_dir
1459 The personal gimp directory which is set to the value of the en‐
1460 vironment variable GIMP2_DIRECTORY or to $XDG_CON‐
1461 FIG_HOME/GIMP/2.10.
1462 gimp_data_dir
1464 Base for paths to shareable data, which is set to the value of
1465 the environment variable GIMP2_DATADIR or to the compiled-in de‐
1466 fault value /usr/share/gimp/2.0.
1467 gimp_plug_in_dir
1469 Base to paths for architecture-specific plug-ins and modules,
1470 which is set to the value of the environment variable
1471 GIMP2_PLUGINDIR or to the compiled-in default value
1472 /usr/lib64/gimp/2.0.
1473 gimp_sysconf_dir
1475 Path to configuration files, which is set to the value of the
1476 environment variable GIMP2_SYSCONFDIR or to the compiled-in de‐
1477 fault value /etc/gimp/2.0.
1478 gimp_cache_dir
1480 Path to cached files, which is set to the value of the environ‐
1481 ment variable GIMP2_CACHEDIR or to the system default for per-
1482 user cached files.
1483 gimp_temp_dir
1485 Path to temporary files, which is set to the value of the envi‐
1486 ronment variable GIMP2_TEMPDIR or to the system default for tem‐
1487 porary files.
1488
1491 /etc/gimp/2.0/gimprc
1492 System-wide configuration file
1493 $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1495 Per-user configuration file
1496
1499 gimp(1)
1500GIMP Manual Pages Version 2.10.32 GIMPRC(5)