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 (transparency-size medium-checks)
496 Sets the size of the checkerboard used to display transparency.
498 Possible values are small-checks, medium-checks and large-
499 checks.
500 (transparency-type gray-checks)
503 Sets the manner in which transparency is displayed in images.
505 Possible values are light-checks, gray-checks, dark-checks,
506 white-only, gray-only and black-only.
507 (snap-distance 8)
510 This is the distance in pixels where Guide and Grid snapping
512 activates. This is an integer value.
513 (marching-ants-speed 200)
516 Speed of marching ants in the selection outline. This value is
518 in milliseconds (less time indicates faster marching). This is
519 an integer value.
520 (resize-windows-on-zoom no)
523 When enabled, the image window will automatically resize itself
525 when zooming into and out of images. This setting only takes
526 effect in multi-window mode. Possible values are yes and no.
527 (resize-windows-on-resize no)
530 When enabled, the image window will automatically resize itself
532 whenever the physical image size changes. This setting only
533 takes effect in multi-window mode. Possible values are yes and
534 no.
535 (default-show-all no)
538 Show full image content by default. Possible values are yes and
540 no.
541 (default-dot-for-dot yes)
544 When enabled, this will ensure that each pixel of an image gets
546 mapped to a pixel on the screen. Possible values are yes and
547 no.
548 (initial-zoom-to-fit yes)
551 When enabled, this will ensure that the full image is visible
553 after a file is opened, otherwise it will be displayed with a
554 scale of 1:1. Possible values are yes and no.
555 (cursor-mode tool-crosshair)
558 Sets the type of mouse pointers to use. Possible values are
560 tool-icon, tool-crosshair and crosshair.
561 (cursor-updating yes)
564 Context-dependent mouse pointers are helpful. They are enabled
566 by default. However, they require overhead that you may want to
567 do without. Possible values are yes and no.
568 (show-brush-outline yes)
571 When enabled, all paint tools will show a preview of the current
573 brush's outline. Possible values are yes and no.
574 (show-paint-tool-cursor yes)
577 When enabled, the mouse pointer will be shown over the image
579 while using a paint tool. Possible values are yes and no.
580 (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
583 Sets the text to appear in image window titles. This is a for‐
585 mat string; certain % character sequences are recognised and
586 expanded as follows:
587 %% literal percent sign
589 %f bare filename, or "Untitled"
590 %F full path to file, or "Untitled"
591 %p PDB image id
592 %i view instance number
593 %t image type (RGB, grayscale, indexed)
594 %z zoom factor as a percentage
595 %s source scale factor
596 %d destination scale factor
597 %Dx expands to x if the image is dirty, the empty string other‐
598 wise
599 %Cx expands to x if the image is clean, the empty string other‐
600 wise
601 %B expands to (modified) if the image is dirty, the empty
602 string otherwise
603 %A expands to (clean) if the image is clean, the empty string
604 otherwise
605 %Nx expands to x if the image is export-dirty, the empty string
606 otherwise
607 %Ex expands to x if the image is export-clean, the empty string
608 otherwise
609 %l the number of layers
610 %L the number of layers (long form)
611 %m memory used by the image
612 %n the name of the active layer/channel
613 %P the PDB id of the active layer/channel
614 %w image width in pixels
615 %W image width in real-world units
616 %h image height in pixels
617 %H image height in real-world units
618 %M the image size expressed in megapixels
619 %u unit symbol
620 %U unit abbreviation
621 %x the width of the active layer/channel in pixels
622 %X the width of the active layer/channel in real-world units
623 %y the height of the active layer/channel in pixels
624 %Y the height of the active layer/channel in real-world units
625 %o the name of the image's color profile
626 (image-status-format "%n (%m)")
630 Sets the text to appear in image window status bars. This is a
632 format string; certain % character sequences are recognised and
633 expanded as follows:
634 %% literal percent sign
636 %f bare filename, or "Untitled"
637 %F full path to file, or "Untitled"
638 %p PDB image id
639 %i view instance number
640 %t image type (RGB, grayscale, indexed)
641 %z zoom factor as a percentage
642 %s source scale factor
643 %d destination scale factor
644 %Dx expands to x if the image is dirty, the empty string other‐
645 wise
646 %Cx expands to x if the image is clean, the empty string other‐
647 wise
648 %B expands to (modified) if the image is dirty, the empty
649 string otherwise
650 %A expands to (clean) if the image is clean, the empty string
651 otherwise
652 %Nx expands to x if the image is export-dirty, the empty string
653 otherwise
654 %Ex expands to x if the image is export-clean, the empty string
655 otherwise
656 %l the number of layers
657 %L the number of layers (long form)
658 %m memory used by the image
659 %n the name of the active layer/channel
660 %P the PDB id of the active layer/channel
661 %w image width in pixels
662 %W image width in real-world units
663 %h image height in pixels
664 %H image height in real-world units
665 %M the image size expressed in megapixels
666 %u unit symbol
667 %U unit abbreviation
668 %x the width of the active layer/channel in pixels
669 %X the width of the active layer/channel in real-world units
670 %y the height of the active layer/channel in pixels
671 %Y the height of the active layer/channel in real-world units
672 %o the name of the image's color profile
673 (monitor-xresolution 96)
677 Sets the monitor's horizontal resolution, in dots per inch. If
679 set to 0, forces the X server to be queried for both horizontal
680 and vertical resolution information. This is a float value.
681 (monitor-yresolution 96)
684 Sets the monitor's vertical resolution, in dots per inch. If
686 set to 0, forces the X server to be queried for both horizontal
687 and vertical resolution information. This is a float value.
688 (monitor-resolution-from-windowing-system yes)
691 When enabled, GIMP will use the monitor resolution from the win‐
693 dowing system. Possible values are yes and no.
694 (navigation-preview-size medium)
697 Sets the size of the navigation preview available in the lower
699 right corner of the image window. Possible values are tiny,
700 extra-small, small, medium, large, extra-large, huge, enormous
701 and gigantic.
702 (default-view
705 (show-menubar yes)
706 (show-statusbar yes)
707 (show-rulers yes)
708 (show-scrollbars yes)
709 (show-selection yes)
710 (show-layer-boundary yes)
711 (show-canvas-boundary yes)
712 (show-guides yes)
713 (show-grid no)
714 (show-sample-points yes)
715 (snap-to-guides yes)
716 (snap-to-grid no)
717 (snap-to-canvas no)
718 (snap-to-path no)
719 (padding-mode default)
720 (padding-color (color-rgb 1 1 1))
721 (padding-in-show-all no))
722 Sets the default settings for the image view. This is a parame‐
724 ter list.
725 (default-fullscreen-view
728 (show-menubar yes)
729 (show-statusbar yes)
730 (show-rulers yes)
731 (show-scrollbars yes)
732 (show-selection yes)
733 (show-layer-boundary yes)
734 (show-canvas-boundary yes)
735 (show-guides yes)
736 (show-grid no)
737 (show-sample-points yes)
738 (snap-to-guides yes)
739 (snap-to-grid no)
740 (snap-to-canvas no)
741 (snap-to-path no)
742 (padding-mode default)
743 (padding-color (color-rgb 1 1 1))
744 (padding-in-show-all no))
745 Sets the default settings used when an image is viewed in
747 fullscreen mode. This is a parameter list.
748 (activate-on-focus yes)
751 When enabled, an image will become the active image when its
753 image window receives the focus. This is useful for window man‐
754 agers using "click to focus".
755 Possible values are yes and no.
756 (space-bar-action pan)
759 What to do when the space bar is pressed in the image window.
761 Possible values are none, pan and move.
762 (zoom-quality high)
765 There's a tradeoff between speed and quality of the zoomed-out
767 display. Possible values are low and high.
768 (use-event-history no)
771 Bugs in event history buffer are frequent so in case of cursor
773 offset problems turning it off helps. Possible values are yes
774 and no.
775 (edit-non-visible no)
778 When enabled, non-visible layers can be edited as normal. Pos‐
780 sible values are yes and no.
781 (move-tool-changes-active no)
784 If enabled, the move tool sets the edited layer or path as
786 active. This used to be the default behaviour in older ver‐
787 sions. Possible values are yes and no.
788 (filter-tool-max-recent 10)
791 How many recent settings to keep around in filter tools. This
793 is an integer value.
794 (filter-tool-use-last-settings no)
797 Default to the last used settings in filter tools. Possible
799 values are yes and no.
800 (filter-tool-show-color-options no)
803 Show advanced color options in filter tools. Possible values
805 are yes and no.
806 (trust-dirty-flag no)
809 When enabled, GIMP will not save an image if it has not been
811 changed since it was opened. Possible values are yes and no.
812 (save-device-status yes)
815 Remember the current tool, pattern, color, and brush across GIMP
817 sessions. Possible values are yes and no.
818 (devices-share-tool no)
821 When enabled, the same tool and tool options will be used for
823 all input devices. No tool switching will occur when the input
824 device changes. Possible values are yes and no.
825 (save-session-info yes)
828 Save the positions and sizes of the main dialogs when GIMP
830 exits. Possible values are yes and no.
831 (restore-session yes)
834 Let GIMP try to restore your last saved session on each startup.
836 Possible values are yes and no.
837 (restore-monitor no)
840 When enabled, GIMP will try to restore windows on the monitor
842 they were open before. When disabled, windows will appear on
843 the currently used monitor. Possible values are yes and no.
844 (save-tool-options yes)
847 Save the tool options when GIMP exits. Possible values are yes
849 and no.
850 (show-tooltips yes)
853 Show a tooltip when the pointer hovers over an item. Possible
855 values are yes and no.
856 (tearoff-menus yes)
859 When enabled, menus can be torn off. Possible values are yes
861 and no.
862 (can-change-accels no)
865 When enabled, you can change keyboard shortcuts for menu items
867 by hitting a key combination while the menu item is highlighted.
868 Possible values are yes and no.
869 (save-accels yes)
872 Save changed keyboard shortcuts when GIMP exits. Possible val‐
874 ues are yes and no.
875 (restore-accels yes)
878 Restore saved keyboard shortcuts on each GIMP startup. Possible
880 values are yes and no.
881 (last-opened-size 10)
884 How many recently opened image filenames to keep on the File
886 menu. This is an integer value.
887 (max-new-image-size 128M)
890 GIMP will warn the user if an attempt is made to create an image
892 that would take more memory than the size specified here. The
893 integer size can contain a suffix of 'B', 'K', 'M' or 'G' which
894 makes GIMP interpret the size as being specified in bytes, kilo‐
895 bytes, megabytes or gigabytes. If no suffix is specified the
896 size defaults to being specified in kilobytes.
897 (toolbox-color-area yes)
900 Show the current foreground and background colors in the tool‐
902 box. Possible values are yes and no.
903 (toolbox-foo-area no)
906 Show the currently selected brush, pattern and gradient in the
908 toolbox. Possible values are yes and no.
909 (toolbox-image-area no)
912 Show the currently active image in the toolbox. Possible values
914 are yes and no.
915 (toolbox-wilber yes)
918 Show the GIMP mascot at the top of the toolbox. Possible values
920 are yes and no.
921 (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
924 Sets the theme search path. This is a colon-separated list of
926 folders to search.
927 (theme "Dark")
930 The name of the theme to use. This is a string value.
932 (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
935 Sets the icon theme search path. This is a colon-separated list
937 of folders to search.
938 (icon-theme "Symbolic")
941 The name of the icon theme to use. This is a string value.
943 (icon-size auto)
946 The size of the icons to use. Possible values are auto, theme,
948 small, medium, large and huge.
949 (use-help yes)
952 When enabled, pressing F1 will open the help browser. Possible
954 values are yes and no.
955 (show-help-button yes)
958 When enabled, dialogs will show a help button that gives access
960 to the related help page. Without this button, the help page
961 can still be reached by pressing F1. Possible values are yes
962 and no.
963 (help-locales "")
966 Specifies the language preferences used by the help system. This
968 is a colon-separated list of language identifiers with decreas‐
969 ing priority. If empty, the language is taken from the user's
970 locale setting. This is a string value.
971 (help-browser gimp)
974 Sets the browser used by the help system. Possible values are
976 gimp and web-browser.
977 (search-show-unavailable-actions no)
980 When enabled, a search of actions will also return inactive
982 actions. Possible values are yes and no.
983 (action-history-size 100)
986 The maximum number of actions saved in history. This is an
988 integer value.
989 (user-manual-online no)
992 When enabled, the online user manual will be used by the help
994 system. Otherwise the locally installed copy is used. Possible
995 values are yes and no.
996 (user-manual-online-uri "https://docs.gimp.org/2.10")
999 The location of the online user manual. This is used if 'user-
1001 manual-online' is enabled. This is a string value.
1002 (dock-window-hint utility)
1005 The window type hint that is set on dock windows and the toolbox
1007 window. This may affect the way your window manager decorates
1008 and handles these windows. Possible values are normal, utility
1009 and keep-above.
1010 (cursor-handedness right)
1013 Sets the handedness for cursor positioning. Possible values are
1015 left and right.
1016 (playground-npd-tool no)
1019 Enable the N-Point Deformation tool. Possible values are yes
1021 and no.
1022 (playground-seamless-clone-tool no)
1025 Enable the Seamless Clone tool. Possible values are yes and no.
1027 (color-profile-policy ask)
1030 How to handle embedded color profiles when opening a file. Pos‐
1032 sible values are ask, keep and convert.
1033 Sets the default folder path for all color profile file dialogs. This
1037 is a
1038 single filename.
1039 (image-convert-profile-intent relative-colorimetric)
1042 Sets the default rendering intent for the 'Convert to Color Pro‐
1044 file' dialog. Possible values are perceptual, relative-colori‐
1045 metric, saturation and absolute-colorimetric.
1046 (image-convert-profile-black-point-compensation yes)
1049 Sets the default 'Black Point Compensation' state for the 'Con‐
1051 vert to Color Profile' dialog. Possible values are yes and no.
1052 (image-convert-precision-layer-dither-method none)
1055 Sets the default layer dithering method for the 'Convert Preci‐
1057 sion' dialog. Possible values are none, floyd-steinberg, bayer,
1058 random, random-covariant, add, add-covariant, xor and xor-
1059 covariant.
1060 (image-convert-precision-text-layer-dither-method none)
1063 Sets the default text layer dithering method for the 'Convert
1065 Precision' dialog. Possible values are none, floyd-steinberg,
1066 bayer, random, random-covariant, add, add-covariant, xor and
1067 xor-covariant.
1068 (image-convert-precision-channel-dither-method none)
1071 Sets the default channel dithering method for the 'Convert Pre‐
1073 cision' dialog. Possible values are none, floyd-steinberg,
1074 bayer, random, random-covariant, add, add-covariant, xor and
1075 xor-covariant.
1076 (image-convert-indexed-palette-type generate)
1079 Sets the default palette type for the 'Convert to Indexed' dia‐
1081 log. Possible values are generate, web, mono and custom.
1082 (image-convert-indexed-max-colors 256)
1085 Sets the default maximum number of colors for the 'Convert to
1087 Indexed' dialog.
1088 This is an integer value.
1089 (image-convert-indexed-remove-duplicates yes)
1092 Sets the default 'Remove duplicate colors' state for the 'Con‐
1094 vert to Indexed' dialog. Possible values are yes and no.
1095 (image-convert-indexed-dither-type none)
1098 Sets the default dithering type for the 'Convert to Indexed'
1100 dialog. Possible values are none, fs, fs-lowbleed and fixed.
1101 (image-convert-indexed-dither-alpha no)
1104 Sets the default 'Dither alpha' state for the 'Convert to
1106 Indexed' dialog. Possible values are yes and no.
1107 (image-convert-indexed-dither-text-layers no)
1110 Sets the default 'Dither text layers' state for the 'Convert to
1112 Indexed' dialog. Possible values are yes and no.
1113 (image-resize-fill-type transparent)
1116 Sets the default fill type for the 'Canvas Size' dialog. Possi‐
1118 ble values are foreground, background, white, transparent and
1119 pattern.
1120 (image-resize-layer-set none)
1123 Sets the default set of layers to resize for the 'Canvas Size'
1125 dialog. Possible values are none, all, image-sized, visible and
1126 linked.
1127 (image-resize-resize-text-layers no)
1130 Sets the default 'Resize text layers' state for the 'Canvas
1132 Size' dialog. Possible values are yes and no.
1133 (layer-new-name "Layer")
1136 Sets the default layer name for the 'New Layer' dialog. This is
1138 a string value.
1139 (layer-new-mode normal)
1142 Sets the default mode for the 'New Layer' dialog. Possible val‐
1144 ues are normal-legacy, dissolve, behind-legacy, multiply-legacy,
1145 screen-legacy, overlay-legacy, difference-legacy, addition-
1146 legacy, subtract-legacy, darken-only-legacy, lighten-only-
1147 legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy,
1148 hsv-value-legacy, divide-legacy, dodge-legacy, burn-legacy,
1149 hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-
1150 merge-legacy, color-erase-legacy, overlay, lch-hue, lch-chroma,
1151 lch-color, lch-lightness, normal, behind, multiply, screen, dif‐
1152 ference, addition, subtract, darken-only, lighten-only, hsv-hue,
1153 hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hard‐
1154 light, softlight, grain-extract, grain-merge, vivid-light, pin-
1155 light, linear-light, hard-mix, exclusion, linear-burn, luma-
1156 darken-only, luma-lighten-only, luminance, color-erase, erase,
1157 merge, split, pass-through, replace and anti-erase.
1158 (layer-new-blend-space auto)
1161 Sets the default blend space for the 'New Layer' dialog. Possi‐
1163 ble values are auto, rgb-linear, rgb-perceptual and lab.
1164 (layer-new-composite-space auto)
1167 Sets the default composite space for the 'New Layer' dialog.
1169 Possible values are auto, rgb-linear, rgb-perceptual and lab.
1170 (layer-new-composite-mode auto)
1173 Sets the default composite mode for the 'New Layer' dialog.
1175 Possible values are auto, union, clip-to-backdrop, clip-to-layer
1176 and intersection.
1177 (layer-new-opacity 1)
1180 Sets the default opacity for the 'New Layer' dialog. This is a
1182 float value.
1183 (layer-new-fill-type transparent)
1186 Sets the default fill type for the 'New Layer' dialog. Possible
1188 values are foreground, background, white, transparent and pat‐
1189 tern.
1190 (layer-resize-fill-type transparent)
1193 Sets the default fill type for the 'Layer Boundary Size' dialog.
1195 Possible values are foreground, background, white, transparent
1196 and pattern.
1197 (layer-add-mask-type white)
1200 Sets the default mask for the 'Add Layer Mask' dialog. Possible
1202 values are white, black, alpha, alpha-transfer, selection, copy
1203 and channel.
1204 (layer-add-mask-invert no)
1207 Sets the default 'invert mask' state for the 'Add Layer Mask'
1209 dialog. Possible values are yes and no.
1210 (layer-merge-type expand-as-necessary)
1213 Sets the default merge type for the 'Merge Visible Layers' dia‐
1215 log. Possible values are expand-as-necessary, clip-to-image,
1216 clip-to-bottom-layer and flatten-image.
1217 (layer-merge-active-group-only yes)
1220 Sets the default 'Active group only' for the 'Merge Visible Lay‐
1222 ers' dialog. Possible values are yes and no.
1223 (layer-merge-discard-invisible no)
1226 Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1228 ers' dialog. Possible values are yes and no.
1229 (channel-new-name "Channel")
1232 Sets the default channel name for the 'New Channel' dialog.
1234 This is a string value.
1235 (channel-new-color (color-rgba 0 0 0 0.5))
1238 Sets the default color and opacity for the 'New Channel' dialog.
1240 The color is specified in the form (color-rgba red green blue
1241 alpha) with channel values as floats in the range of 0.0 to 1.0.
1242 (path-new-name "Path")
1245 Sets the default path name for the 'New Path' dialog. This is a
1247 string value.
1248 Sets the default folder path for the 'Export Path' dialog. This is a
1252 single
1253 filename.
1254 (path-export-active-only yes)
1257 Sets the default 'Export the active path' state for the 'Export
1259 Path' dialog. Possible values are yes and no.
1260 Sets the default folder path for the 'Import Path' dialog. This is a
1264 single
1265 filename.
1266 (path-import-merge no)
1269 Sets the default 'Merge imported paths' state for the 'Import
1271 Path' dialog. Possible values are yes and no.
1272 (path-import-scale no)
1275 Sets the default 'Scale imported paths to fit size' state for
1277 the 'Import Path' dialog. Possible values are yes and no.
1278 (selection-feather-radius 5)
1281 Sets the default feather radius for the 'Feather Selection' dia‐
1283 log. This is a float value.
1284 (selection-feather-edge-lock yes)
1287 Sets the default 'Selected areas continue outside the image'
1289 setting for the 'Feather Selection' dialog. Possible values are
1290 yes and no.
1291 (selection-grow-radius 1)
1294 Sets the default grow radius for the 'Grow Selection' dialog.
1296 This is a float value.
1297 (selection-shrink-radius 1)
1300 Sets the default shrink radius for the 'Shrink Selection' dia‐
1302 log. This is a float value.
1303 (selection-shrink-edge-lock no)
1306 Sets the default 'Selected areas continue outside the image'
1308 setting for the 'Shrink Selection' dialog. Possible values are
1309 yes and no.
1310 (selection-border-radius 5)
1313 Sets the default border radius for the 'Border Selection' dia‐
1315 log. This is a float value.
1316 (selection-border-style smooth)
1319 Sets the default border style for the 'Border Selection' dialog.
1321 Possible values are hard, smooth and feathered.
1322 (selection-border-edge-lock no)
1325 Sets the default 'Selected areas continue outside the image'
1327 setting for the 'Border Selection' dialog. Possible values are
1328 yes and no.
1329 (fill-options
1332 (style solid)
1333 (antialias yes)
1334 (feather no)
1335 (feather-radius 10))
1336 The default fill options for the fill dialogs. This is a param‐
1338 eter list.
1339 (stroke-options
1342 (style solid)
1343 (antialias yes)
1344 (feather no)
1345 (feather-radius 10)
1346 (method line)
1347 (width 6)
1348 (unit pixels)
1349 (cap-style butt)
1350 (join-style miter)
1351 (miter-limit 10)
1352 (dash-offset 0)
1353 (dash-info 0)
1354 (emulate-brush-dynamics no))
1355 The default stroke options for the stroke dialogs. This is a
1357 parameter list.
1358 (fractalexplorer-path "${gimp_dir}/fractalex‐
1361 plorer:${gimp_data_dir}/fractalexplorer")
1362 Where to search for fractals used by the Fractal Explorer plug-
1364 in. This is a colon-separated list of folders to search.
1365 (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1368 Where to search for Gfig figures used by the Gfig plug-in. This
1370 is a colon-separated list of folders to search.
1371 (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1374 Where to search for gflares used by the GFlare plug-in. This is
1376 a colon-separated list of folders to search.
1377 (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1380 pressionist")
1381 Where to search for data used by the Gimpressionist plug-in.
1383 This is a colon-separated list of folders to search.
1384 (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1387 This path will be searched for scripts when the Script-Fu plug-
1389 in is run. This is a colon-separated list of folders to search.
1390
1393 Strings of type PATH are expanded in a manner similar to bash(1).
1394 Specifically: tilde (~) is expanded to the user's home directory. Note
1395 that the bash feature of being able to refer to other user's home
1396 directories by writing ~userid/ is not valid in this file.
1397 ${variable} is expanded to the current value of an environment vari‐
1399 able. There are a few variables that are pre-defined:
1400 gimp_dir
1402 The personal gimp directory which is set to the value of the
1403 environment variable GIMP2_DIRECTORY or to $XDG_CON‐
1404 FIG_HOME/GIMP/2.10.
1405 gimp_data_dir
1407 Base for paths to shareable data, which is set to the value of
1408 the environment variable GIMP2_DATADIR or to the compiled-in
1409 default value /usr/share/gimp/2.0.
1410 gimp_plug_in_dir
1412 Base to paths for architecture-specific plug-ins and modules,
1413 which is set to the value of the environment variable
1414 GIMP2_PLUGINDIR or to the compiled-in default value
1415 /usr/lib64/gimp/2.0.
1416 gimp_sysconf_dir
1418 Path to configuration files, which is set to the value of the
1419 environment variable GIMP2_SYSCONFDIR or to the compiled-in
1420 default value /etc/gimp/2.0.
1421 gimp_cache_dir
1423 Path to cached files, which is set to the value of the environ‐
1424 ment variable GIMP2_CACHEDIR or to the system default for per-
1425 user cached files.
1426 gimp_temp_dir
1428 Path to temporary files, which is set to the value of the envi‐
1429 ronment variable GIMP2_TEMPDIR or to the system default for tem‐
1430 porary files.
1431
1434 /etc/gimp/2.0/gimprc
1435 System-wide configuration file
1436 $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1438 Per-user configuration file
1439
1442 gimp(1)
1443GIMP Manual Pages Version 2.10.14 GIMPRC(5)