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 (num-processors 1)
58 Sets how many threads GIMP should use for operations that sup‐
60 port it. This is an integer value.
61 (tile-cache-size 2g)
64 When the amount of pixel data exceeds this limit, GIMP will
66 start to swap tiles to disk. This is a lot slower but it makes
67 it possible to work on images that wouldn't fit into memory oth‐
68 erwise. If you have a lot of RAM, you may want to set this to a
69 higher value. The integer size can contain a suffix of 'B',
70 'K', 'M' or 'G' which makes GIMP interpret the size as being
71 specified in bytes, kilobytes, megabytes or gigabytes. If no
72 suffix is specified the size defaults to being specified in
73 kilobytes.
74 (use-opencl no)
77 When enabled, uses OpenCL for some operations. Possible values
79 are yes and no.
80 Specifies the language to use for the user interface. This is a string
84 value.
85 (interpolation-type cubic)
88 Sets the level of interpolation used for scaling and other
90 transformations. Possible values are none, linear, cubic,
91 nohalo and lohalo.
92 (default-threshold 15)
95 Tools such as fuzzy-select and bucket fill find regions based on
97 a seed-fill algorithm. The seed fill starts at the initially
98 selected pixel and progresses in all directions until the dif‐
99 ference of pixel intensity from the original is greater than a
100 specified threshold. This value represents the default thresh‐
101 old. This is an integer value.
102 (plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")
105 Sets the plug-in search path. This is a colon-separated list of
107 folders to search.
108 (module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")
111 Sets the module search path. This is a colon-separated list of
113 folders to search.
114 (interpreter-path "${gimp_dir}/interpreters:${gimp_plug_in_dir}/inter‐
117 preters")
118 Sets the interpreter search path. This is a colon-separated
120 list of folders to search.
121 (environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")
124 Sets the environ search path. This is a colon-separated list of
126 folders to search.
127 (brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")
130 Sets the brush search path. This is a colon-separated list of
132 folders to search.
133 (brush-path-writable "${gimp_dir}/brushes")
136 This is a colon-separated list of folders to search.
138 (dynamics-path "${gimp_dir}/dynamics:${gimp_data_dir}/dynamics")
141 Sets the dynamics search path. This is a colon-separated list
143 of folders to search.
144 (dynamics-path-writable "${gimp_dir}/dynamics")
147 This is a colon-separated list of folders to search.
149 (mypaint-brush-path "/usr/share/mypaint-
152 data/1.0/brushes:~/.mypaint/brushes")
153 Sets the brush search path. This is a colon-separated list of
155 folders to search.
156 (mypaint-brush-path-writable "~/.mypaint/brushes")
159 This is a colon-separated list of folders to search.
161 (pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")
164 Sets the pattern search path. This is a colon-separated list of
166 folders to search.
167 (pattern-path-writable "${gimp_dir}/patterns")
170 This is a colon-separated list of folders to search.
172 (palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")
175 Sets the palette search path. This is a colon-separated list of
177 folders to search.
178 (palette-path-writable "${gimp_dir}/palettes")
181 This is a colon-separated list of folders to search.
183 (gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")
186 Sets the gradient search path. This is a colon-separated list
188 of folders to search.
189 (gradient-path-writable "${gimp_dir}/gradients")
192 This is a colon-separated list of folders to search.
194 (tool-preset-path "${gimp_dir}/tool-presets:${gimp_data_dir}/tool-pre‐
197 sets")
198 Sets the dynamics search path. This is a colon-separated list
200 of folders to search.
201 (tool-preset-path-writable "${gimp_dir}/tool-presets")
204 This is a colon-separated list of folders to search.
206 (font-path "${gimp_dir}/fonts:${gimp_data_dir}/fonts")
209 Where to look for fonts in addition to the system-wide installed
211 fonts. This is a colon-separated list of folders to search.
212 (default-brush "2. Hardness 050")
215 Specify a default brush. The brush is searched for in the spec‐
217 ified brush path. This is a string value.
218 (default-dynamics "Dynamics Off")
221 Specify a default dynamics. The dynamics is searched for in the
223 specified dynamics path. This is a string value.
224 (default-mypaint-brush "Fixme")
227 Specify a default MyPaint brush. This is a string value.
229 (default-pattern "Pine")
232 Specify a default pattern. This is a string value.
234 (default-palette "Default")
237 Specify a default palette. This is a string value.
239 (default-gradient "FG to BG (RGB)")
242 Specify a default gradient. This is a string value.
244 (default-tool-preset "Current Options")
247 Specify a default tool preset. The tool preset is searched for
249 in the specified tool prests path. This is a string value.
250 (default-font "Sans-serif")
253 Specify a default font. This is a string value.
255 (global-brush yes)
258 When enabled, the selected brush will be used for all tools.
260 Possible values are yes and no.
261 (global-dynamics yes)
264 When enabled, the selected dynamics will be used for all tools.
266 Possible values are yes and no.
267 (global-pattern yes)
270 When enabled, the selected pattern will be used for all tools.
272 Possible values are yes and no.
273 (global-palette yes)
276 When enabled, the selected palette will be used for all tools.
278 Possible values are yes and no.
279 (global-gradient yes)
282 When enabled, the selected gradient will be used for all tools.
284 Possible values are yes and no.
285 (global-font yes)
288 When enabled, the selected font will be used for all tools.
290 Possible values are yes and no.
291 (default-image
294 (width 1920)
295 (height 1080)
296 (unit pixels)
297 (xresolution 300.000000)
298 (yresolution 300.000000)
299 (resolution-unit inches)
300 (image-type rgb)
301 (precision u8-gamma)
302 (color-managed yes)
303 (color-profile NULL)
304 (fill-type background)
305 (comment "Created with GIMP"))
306 Sets the default image in the "File/New" dialog. This is a
308 parameter list.
309 (default-grid
312 (style solid)
313 (fgcolor (color-rgba 0.000000 0.000000 0.000000 1.000000))
314 (bgcolor (color-rgba 1.000000 1.000000 1.000000 1.000000))
315 (xspacing 10.000000)
316 (yspacing 10.000000)
317 (spacing-unit inches)
318 (xoffset 0.000000)
319 (yoffset 0.000000)
320 (offset-unit inches))
321 Specify a default image grid. This is a parameter list.
323 (undo-levels 5)
326 Sets the minimal number of operations that can be undone. More
328 undo levels are kept available until the undo-size limit is
329 reached. This is an integer value.
330 (undo-size 1g)
333 Sets an upper limit to the memory that is used per image to keep
335 operations on the undo stack. Regardless of this setting, at
336 least as many undo-levels as configured can be undone. The
337 integer size can contain a suffix of 'B', 'K', 'M' or 'G' which
338 makes GIMP interpret the size as being specified in bytes, kilo‐
339 bytes, megabytes or gigabytes. If no suffix is specified the
340 size defaults to being specified in kilobytes.
341 (undo-preview-size large)
344 Sets the size of the previews in the Undo History. Possible
346 values are tiny, extra-small, small, medium, large, extra-large,
347 huge, enormous and gigantic.
348 (plug-in-history-size 10)
351 How many recently used filters and plug-ins to keep on the Fil‐
353 ters menu. This is an integer value.
354 (pluginrc-path "${gimp_dir}/pluginrc")
357 Sets the pluginrc search path. This is a single filename.
359 (layer-previews yes)
362 Sets whether GIMP should create previews of layers and channels.
364 Previews in the layers and channels dialog are nice to have but
365 they can slow things down when working with large images. Pos‐
366 sible values are yes and no.
367 (group-layer-previews yes)
370 Sets whether GIMP should create previews of layer groups. Layer
372 group previews are more expensive than ordinary layer previews.
373 Possible values are yes and no.
374 (layer-preview-size medium)
377 Sets the preview size used for layers and channel previews in
379 newly created dialogs. Possible values are tiny, extra-small,
380 small, medium, large, extra-large, huge, enormous and gigantic.
381 (thumbnail-size normal)
384 Sets the size of the thumbnail shown in the Open dialog. Possi‐
386 ble values are none, normal and large.
387 (thumbnail-filesize-limit 4M)
390 The thumbnail in the Open dialog will be automatically updated
392 if the file being previewed is smaller than the size set here.
393 The integer size can contain a suffix of 'B', 'K', 'M' or 'G'
394 which makes GIMP interpret the size as being specified in bytes,
395 kilobytes, megabytes or gigabytes. If no suffix is specified the
396 size defaults to being specified in kilobytes.
397 (color-management
400 (mode display)
401 (display-profile-from-gdk no)
402 (display-rendering-intent relative-colorimetric)
403 (display-use-black-point-compensation yes)
404 (display-optimize yes)
405 (simulation-rendering-intent perceptual)
406 (simulation-use-black-point-compensation no)
407 (simulation-optimize yes)
408 (simulation-gamut-check no)
409 (out-of-gamut-color (color-rgb 1.000000 0.000000 1.000000))
410 (display-module "CdisplayLcms"))
411 Defines the color management behavior. This is a parameter
413 list.
414 (save-document-history yes)
417 Keep a permanent record of all opened and saved files in the
419 Recent Documents list. Possible values are yes and no.
420 (quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000))
423 Sets the default quick mask color. The color is specified in
425 the form (color-rgba red green blue alpha) with channel values
426 as floats in the range of 0.0 to 1.0.
427 (import-promote-float no)
430 Promote imported images to floating point precision. Does not
432 apply to indexed images. Possible values are yes and no.
433 (import-promote-dither yes)
436 When promoting imported images to floating point precision, also
438 add minimal noise in order to distribute color values a bit.
439 Possible values are yes and no.
440 (import-add-alpha no)
443 Add an alpha channel to all layers of imported images. Possible
445 values are yes and no.
446 (import-raw-plug-in "")
449 Which plug-in to use for importing raw digital camera files.
451 This is a single filename.
452 (export-file-type png)
455 Export file type used by default. Possible values are png, jpg,
457 ora, psd, pdf, tif, bmp and webp.
458 (export-color-profile yes)
461 Export the image's color profile by default. Possible values
463 are yes and no.
464 (export-metadata-exif yes)
467 Export Exif metadata by default. Possible values are yes and
469 no.
470 (export-metadata-xmp yes)
473 Export XMP metadata by default. Possible values are yes and no.
475 (export-metadata-iptc yes)
478 Export IPTC metadata by default. Possible values are yes and
480 no.
481 (debug-policy fatal)
484 Try generating debug data for bug reporting when appropriate.
486 Possible values are warning, critical, fatal and never.
487 (transparency-size medium-checks)
490 Sets the size of the checkerboard used to display transparency.
492 Possible values are small-checks, medium-checks and large-
493 checks.
494 (transparency-type gray-checks)
497 Sets the manner in which transparency is displayed in images.
499 Possible values are light-checks, gray-checks, dark-checks,
500 white-only, gray-only and black-only.
501 (snap-distance 8)
504 This is the distance in pixels where Guide and Grid snapping
506 activates. This is an integer value.
507 (marching-ants-speed 200)
510 Speed of marching ants in the selection outline. This value is
512 in milliseconds (less time indicates faster marching). This is
513 an integer value.
514 (resize-windows-on-zoom no)
517 When enabled, the image window will automatically resize itself
519 when zooming into and out of images. This setting only takes
520 effect in multi-window mode. Possible values are yes and no.
521 (resize-windows-on-resize no)
524 When enabled, the image window will automatically resize itself
526 whenever the physical image size changes. This setting only
527 takes effect in multi-window mode. Possible values are yes and
528 no.
529 (default-dot-for-dot yes)
532 When enabled, this will ensure that each pixel of an image gets
534 mapped to a pixel on the screen. Possible values are yes and
535 no.
536 (initial-zoom-to-fit yes)
539 When enabled, this will ensure that the full image is visible
541 after a file is opened, otherwise it will be displayed with a
542 scale of 1:1. Possible values are yes and no.
543 (cursor-mode tool-crosshair)
546 Sets the type of mouse pointers to use. Possible values are
548 tool-icon, tool-crosshair and crosshair.
549 (cursor-updating yes)
552 Context-dependent mouse pointers are helpful. They are enabled
554 by default. However, they require overhead that you may want to
555 do without. Possible values are yes and no.
556 (show-brush-outline yes)
559 When enabled, all paint tools will show a preview of the current
561 brush's outline. Possible values are yes and no.
562 (show-paint-tool-cursor yes)
565 When enabled, the mouse pointer will be shown over the image
567 while using a paint tool. Possible values are yes and no.
568 (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
571 Sets the text to appear in image window titles. This is a for‐
573 mat string; certain % character sequences are recognised and
574 expanded as follows:
575 %% literal percent sign
577 %f bare filename, or "Untitled"
578 %F full path to file, or "Untitled"
579 %p PDB image id
580 %i view instance number
581 %t image type (RGB, grayscale, indexed)
582 %z zoom factor as a percentage
583 %s source scale factor
584 %d destination scale factor
585 %Dx expands to x if the image is dirty, the empty string other‐
586 wise
587 %Cx expands to x if the image is clean, the empty string other‐
588 wise
589 %B expands to (modified) if the image is dirty, the empty
590 string otherwise
591 %A expands to (clean) if the image is clean, the empty string
592 otherwise
593 %Nx expands to x if the image is export-dirty, the empty string
594 otherwise
595 %Ex expands to x if the image is export-clean, the empty string
596 otherwise
597 %l the number of layers
598 %L the number of layers (long form)
599 %m memory used by the image
600 %n the name of the active layer/channel
601 %P the PDB id of the active layer/channel
602 %w image width in pixels
603 %W image width in real-world units
604 %h image height in pixels
605 %H image height in real-world units
606 %M the image size expressed in megapixels
607 %u unit symbol
608 %U unit abbreviation
609 %x the width of the active layer/channel in pixels
610 %X the width of the active layer/channel in real-world units
611 %y the height of the active layer/channel in pixels
612 %Y the height of the active layer/channel in real-world units
613 %o the name of the image's color profile
614 (image-status-format "%n (%m)")
618 Sets the text to appear in image window status bars. This is a
620 format string; certain % character sequences are recognised and
621 expanded as follows:
622 %% literal percent sign
624 %f bare filename, or "Untitled"
625 %F full path to file, or "Untitled"
626 %p PDB image id
627 %i view instance number
628 %t image type (RGB, grayscale, indexed)
629 %z zoom factor as a percentage
630 %s source scale factor
631 %d destination scale factor
632 %Dx expands to x if the image is dirty, the empty string other‐
633 wise
634 %Cx expands to x if the image is clean, the empty string other‐
635 wise
636 %B expands to (modified) if the image is dirty, the empty
637 string otherwise
638 %A expands to (clean) if the image is clean, the empty string
639 otherwise
640 %Nx expands to x if the image is export-dirty, the empty string
641 otherwise
642 %Ex expands to x if the image is export-clean, the empty string
643 otherwise
644 %l the number of layers
645 %L the number of layers (long form)
646 %m memory used by the image
647 %n the name of the active layer/channel
648 %P the PDB id of the active layer/channel
649 %w image width in pixels
650 %W image width in real-world units
651 %h image height in pixels
652 %H image height in real-world units
653 %M the image size expressed in megapixels
654 %u unit symbol
655 %U unit abbreviation
656 %x the width of the active layer/channel in pixels
657 %X the width of the active layer/channel in real-world units
658 %y the height of the active layer/channel in pixels
659 %Y the height of the active layer/channel in real-world units
660 %o the name of the image's color profile
661 (monitor-xresolution 96.000000)
665 Sets the monitor's horizontal resolution, in dots per inch. If
667 set to 0, forces the X server to be queried for both horizontal
668 and vertical resolution information. This is a float value.
669 (monitor-yresolution 96.000000)
672 Sets the monitor's vertical resolution, in dots per inch. If
674 set to 0, forces the X server to be queried for both horizontal
675 and vertical resolution information. This is a float value.
676 (monitor-resolution-from-windowing-system yes)
679 When enabled, GIMP will use the monitor resolution from the win‐
681 dowing system. Possible values are yes and no.
682 (navigation-preview-size medium)
685 Sets the size of the navigation preview available in the lower
687 right corner of the image window. Possible values are tiny,
688 extra-small, small, medium, large, extra-large, huge, enormous
689 and gigantic.
690 (default-view
693 (show-menubar yes)
694 (show-statusbar yes)
695 (show-rulers yes)
696 (show-scrollbars yes)
697 (show-selection yes)
698 (show-layer-boundary yes)
699 (show-guides yes)
700 (show-grid no)
701 (show-sample-points yes)
702 (snap-to-guides yes)
703 (snap-to-grid no)
704 (snap-to-canvas no)
705 (snap-to-path no)
706 (padding-mode default)
707 (padding-color (color-rgb 1.000000 1.000000 1.000000)))
708 Sets the default settings for the image view. This is a parame‐
710 ter list.
711 (default-fullscreen-view
714 (show-menubar yes)
715 (show-statusbar yes)
716 (show-rulers yes)
717 (show-scrollbars yes)
718 (show-selection yes)
719 (show-layer-boundary yes)
720 (show-guides yes)
721 (show-grid no)
722 (show-sample-points yes)
723 (snap-to-guides yes)
724 (snap-to-grid no)
725 (snap-to-canvas no)
726 (snap-to-path no)
727 (padding-mode default)
728 (padding-color (color-rgb 1.000000 1.000000 1.000000)))
729 Sets the default settings used when an image is viewed in
731 fullscreen mode. This is a parameter list.
732 (activate-on-focus yes)
735 When enabled, an image will become the active image when its
737 image window receives the focus. This is useful for window man‐
738 agers using "click to focus".
739 Possible values are yes and no.
740 (space-bar-action pan)
743 What to do when the space bar is pressed in the image window.
745 Possible values are none, pan and move.
746 (zoom-quality high)
749 There's a tradeoff between speed and quality of the zoomed-out
751 display. Possible values are low and high.
752 (use-event-history no)
755 Bugs in event history buffer are frequent so in case of cursor
757 offset problems turning it off helps. Possible values are yes
758 and no.
759 (move-tool-changes-active no)
762 If enabled, the move tool sets the edited layer or path as
764 active. This used to be the default behaviour in older ver‐
765 sions. Possible values are yes and no.
766 (filter-tool-max-recent 10)
769 How many recent settings to keep around in filter tools. This
771 is an integer value.
772 (filter-tool-use-last-settings no)
775 Default to the last used settings in filter tools. Possible
777 values are yes and no.
778 (filter-tool-show-color-options no)
781 Show advanced color options in filter tools. Possible values
783 are yes and no.
784 (trust-dirty-flag no)
787 When enabled, GIMP will not save an image if it has not been
789 changed since it was opened. Possible values are yes and no.
790 (save-device-status yes)
793 Remember the current tool, pattern, color, and brush across GIMP
795 sessions. Possible values are yes and no.
796 (devices-share-tool no)
799 When enabled, the same tool and tool options will be used for
801 all input devices. No tool switching will occur when the input
802 device changes. Possible values are yes and no.
803 (save-session-info yes)
806 Save the positions and sizes of the main dialogs when GIMP
808 exits. Possible values are yes and no.
809 (restore-session yes)
812 Let GIMP try to restore your last saved session on each startup.
814 Possible values are yes and no.
815 (restore-monitor no)
818 When enabled, GIMP will try to restore windows on the monitor
820 they were open before. When disabled, windows will appear on
821 the currently used monitor. Possible values are yes and no.
822 (save-tool-options yes)
825 Save the tool options when GIMP exits. Possible values are yes
827 and no.
828 (show-tooltips yes)
831 Show a tooltip when the pointer hovers over an item. Possible
833 values are yes and no.
834 (tearoff-menus yes)
837 When enabled, menus can be torn off. Possible values are yes
839 and no.
840 (can-change-accels no)
843 When enabled, you can change keyboard shortcuts for menu items
845 by hitting a key combination while the menu item is highlighted.
846 Possible values are yes and no.
847 (save-accels yes)
850 Save changed keyboard shortcuts when GIMP exits. Possible val‐
852 ues are yes and no.
853 (restore-accels yes)
856 Restore saved keyboard shortcuts on each GIMP startup. Possible
858 values are yes and no.
859 (last-opened-size 10)
862 How many recently opened image filenames to keep on the File
864 menu. This is an integer value.
865 (max-new-image-size 128M)
868 GIMP will warn the user if an attempt is made to create an image
870 that would take more memory than the size specified here. The
871 integer size can contain a suffix of 'B', 'K', 'M' or 'G' which
872 makes GIMP interpret the size as being specified in bytes, kilo‐
873 bytes, megabytes or gigabytes. If no suffix is specified the
874 size defaults to being specified in kilobytes.
875 (toolbox-color-area yes)
878 Show the current foreground and background colors in the tool‐
880 box. Possible values are yes and no.
881 (toolbox-foo-area no)
884 Show the currently selected brush, pattern and gradient in the
886 toolbox. Possible values are yes and no.
887 (toolbox-image-area no)
890 Show the currently active image in the toolbox. Possible values
892 are yes and no.
893 (toolbox-wilber yes)
896 Show the GIMP mascot at the top of the toolbox. Possible values
898 are yes and no.
899 (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
902 Sets the theme search path. This is a colon-separated list of
904 folders to search.
905 (theme "Dark")
908 The name of the theme to use. This is a string value.
910 (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
913 Sets the icon theme search path. This is a colon-separated list
915 of folders to search.
916 (icon-theme "Symbolic")
919 The name of the icon theme to use. This is a string value.
921 (icon-size auto)
924 The size of the icons to use. Possible values are auto, theme,
926 small, medium, large and huge.
927 (use-help yes)
930 When enabled, pressing F1 will open the help browser. Possible
932 values are yes and no.
933 (show-help-button yes)
936 When enabled, dialogs will show a help button that gives access
938 to the related help page. Without this button, the help page
939 can still be reached by pressing F1. Possible values are yes
940 and no.
941 (help-locales "")
944 Specifies the language preferences used by the help system. This
946 is a colon-separated list of language identifiers with decreas‐
947 ing priority. If empty, the language is taken from the user's
948 locale setting. This is a string value.
949 (help-browser gimp)
952 Sets the browser used by the help system. Possible values are
954 gimp and web-browser.
955 (search-show-unavailable-actions no)
958 When enabled, a search of actions will also return inactive
960 actions. Possible values are yes and no.
961 (action-history-size 100)
964 The maximum number of actions saved in history. This is an
966 integer value.
967 (user-manual-online no)
970 When enabled, the online user manual will be used by the help
972 system. Otherwise the locally installed copy is used. Possible
973 values are yes and no.
974 (user-manual-online-uri "https://docs.gimp.org/2.10")
977 The location of the online user manual. This is used if 'user-
979 manual-online' is enabled. This is a string value.
980 (dock-window-hint utility)
983 The window type hint that is set on dock windows and the toolbox
985 window. This may affect the way your window manager decorates
986 and handles these windows. Possible values are normal, utility
987 and keep-above.
988 (cursor-handedness right)
991 Sets the handedness for cursor positioning. Possible values are
993 left and right.
994 (playground-npd-tool no)
997 Enable the N-Point Deformation tool. Possible values are yes
999 and no.
1000 (playground-seamless-clone-tool no)
1003 Enable the Seamless Clone tool. Possible values are yes and no.
1005 (color-profile-policy ask)
1008 How to handle embedded color profiles when opening a file. Pos‐
1010 sible values are ask, keep and convert.
1011 Sets the default folder path for all color profile file dialogs. This
1015 is a
1016 single filename.
1017 (image-convert-profile-intent relative-colorimetric)
1020 Sets the default rendering intent for the 'Convert to Color Pro‐
1022 file' dialog. Possible values are perceptual, relative-colori‐
1023 metric, saturation and absolute-colorimetric.
1024 (image-convert-profile-black-point-compensation yes)
1027 Sets the default 'Black Point Compensation' state for the 'Con‐
1029 vert to Color Profile' dialog. Possible values are yes and no.
1030 (image-convert-precision-layer-dither-method none)
1033 Sets the default layer dithering method for the 'Convert Preci‐
1035 sion' dialog. Possible values are none, floyd-steinberg, bayer,
1036 random, random-covariant, add, add-covariant, xor and xor-
1037 covariant.
1038 (image-convert-precision-text-layer-dither-method none)
1041 Sets the default text layer dithering method for the 'Convert
1043 Precision' dialog. Possible values are none, floyd-steinberg,
1044 bayer, random, random-covariant, add, add-covariant, xor and
1045 xor-covariant.
1046 (image-convert-precision-channel-dither-method none)
1049 Sets the default channel dithering method for the 'Convert Pre‐
1051 cision' dialog. Possible values are none, floyd-steinberg,
1052 bayer, random, random-covariant, add, add-covariant, xor and
1053 xor-covariant.
1054 (image-convert-indexed-palette-type generate)
1057 Sets the default palette type for the 'Convert to Indexed' dia‐
1059 log. Possible values are generate, web, mono and custom.
1060 (image-convert-indexed-max-colors 256)
1063 Sets the default maximum number of colors for the 'Convert to
1065 Indexed' dialog.
1066 This is an integer value.
1067 (image-convert-indexed-remove-duplicates yes)
1070 Sets the default 'Remove duplicate colors' state for the 'Con‐
1072 vert to Indexed' dialog. Possible values are yes and no.
1073 (image-convert-indexed-dither-type none)
1076 Sets the default dithering type for the 'Convert to Indexed'
1078 dialog. Possible values are none, fs, fs-lowbleed and fixed.
1079 (image-convert-indexed-dither-alpha no)
1082 Sets the default 'Dither alpha' state for the 'Convert to
1084 Indexed' dialog. Possible values are yes and no.
1085 (image-convert-indexed-dither-text-layers no)
1088 Sets the default 'Dither text layers' state for the 'Convert to
1090 Indexed' dialog. Possible values are yes and no.
1091 (image-resize-fill-type transparent)
1094 Sets the default fill type for the 'Canvas Size' dialog. Possi‐
1096 ble values are foreground, background, white, transparent and
1097 pattern.
1098 (image-resize-layer-set none)
1101 Sets the default set of layers to resize for the 'Canvas Size'
1103 dialog. Possible values are none, all, image-sized, visible and
1104 linked.
1105 (image-resize-resize-text-layers no)
1108 Sets the default 'Resize text layers' state for the 'Canvas
1110 Size' dialog. Possible values are yes and no.
1111 (layer-new-name "Layer")
1114 Sets the default layer name for the 'New Layer' dialog. This is
1116 a string value.
1117 (layer-new-mode normal)
1120 Sets the default mode for the 'New Layer' dialog. Possible val‐
1122 ues are normal-legacy, dissolve, behind-legacy, multiply-legacy,
1123 screen-legacy, overlay-legacy, difference-legacy, addition-
1124 legacy, subtract-legacy, darken-only-legacy, lighten-only-
1125 legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy,
1126 hsv-value-legacy, divide-legacy, dodge-legacy, burn-legacy,
1127 hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-
1128 merge-legacy, color-erase-legacy, overlay, lch-hue, lch-chroma,
1129 lch-color, lch-lightness, normal, behind, multiply, screen, dif‐
1130 ference, addition, subtract, darken-only, lighten-only, hsv-hue,
1131 hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hard‐
1132 light, softlight, grain-extract, grain-merge, vivid-light, pin-
1133 light, linear-light, hard-mix, exclusion, linear-burn, luma-
1134 darken-only, luma-lighten-only, luminance, color-erase, erase,
1135 merge, split, pass-through, replace and anti-erase.
1136 (layer-new-blend-space auto)
1139 Sets the default blend space for the 'New Layer' dialog. Possi‐
1141 ble values are auto, rgb-linear, rgb-perceptual and lab.
1142 (layer-new-composite-space auto)
1145 Sets the default composite space for the 'New Layer' dialog.
1147 Possible values are auto, rgb-linear, rgb-perceptual and lab.
1148 (layer-new-composite-mode auto)
1151 Sets the default composite mode for the 'New Layer' dialog.
1153 Possible values are auto, union, clip-to-backdrop, clip-to-layer
1154 and intersection.
1155 (layer-new-opacity 1.000000)
1158 Sets the default opacity for the 'New Layer' dialog. This is a
1160 float value.
1161 (layer-new-fill-type transparent)
1164 Sets the default fill type for the 'New Layer' dialog. Possible
1166 values are foreground, background, white, transparent and pat‐
1167 tern.
1168 (layer-resize-fill-type transparent)
1171 Sets the default fill type for the 'Layer Boundary Size' dialog.
1173 Possible values are foreground, background, white, transparent
1174 and pattern.
1175 (layer-add-mask-type white)
1178 Sets the default mask for the 'Add Layer Mask' dialog. Possible
1180 values are white, black, alpha, alpha-transfer, selection, copy
1181 and channel.
1182 (layer-add-mask-invert no)
1185 Sets the default 'invert mask' state for the 'Add Layer Mask'
1187 dialog. Possible values are yes and no.
1188 (layer-merge-type expand-as-necessary)
1191 Sets the default merge type for the 'Merge Visible Layers' dia‐
1193 log. Possible values are expand-as-necessary, clip-to-image,
1194 clip-to-bottom-layer and flatten-image.
1195 (layer-merge-active-group-only yes)
1198 Sets the default 'Active group only' for the 'Merge Visible Lay‐
1200 ers' dialog. Possible values are yes and no.
1201 (layer-merge-discard-invisible no)
1204 Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1206 ers' dialog. Possible values are yes and no.
1207 (channel-new-name "Channel")
1210 Sets the default channel name for the 'New Channel' dialog.
1212 This is a string value.
1213 (channel-new-color (color-rgba 0.000000 0.000000 0.000000 0.500000))
1216 Sets the default color and opacity for the 'New Channel' dialog.
1218 The color is specified in the form (color-rgba red green blue
1219 alpha) with channel values as floats in the range of 0.0 to 1.0.
1220 (path-new-name "Path")
1223 Sets the default path name for the 'New Path' dialog. This is a
1225 string value.
1226 Sets the default folder path for the 'Export Path' dialog. This is a
1230 single
1231 filename.
1232 (path-export-active-only yes)
1235 Sets the default 'Export the active path' state for the 'Export
1237 Path' dialog. Possible values are yes and no.
1238 Sets the default folder path for the 'Import Path' dialog. This is a
1242 single
1243 filename.
1244 (path-import-merge no)
1247 Sets the default 'Merge imported paths' state for the 'Import
1249 Path' dialog. Possible values are yes and no.
1250 (path-import-scale no)
1253 Sets the default 'Scale imported paths to fit size' state for
1255 the 'Import Path' dialog. Possible values are yes and no.
1256 (selection-feather-radius 5.000000)
1259 Sets the default feather radius for the 'Feather Selection' dia‐
1261 log. This is a float value.
1262 (selection-grow-radius 1.000000)
1265 Sets the default grow radius for the 'Grow Selection' dialog.
1267 This is a float value.
1268 (selection-shrink-radius 1.000000)
1271 Sets the default shrink radius for the 'Shrink Selection' dia‐
1273 log. This is a float value.
1274 (selection-shrink-edge-lock no)
1277 Sets the default 'Selected areas continue outside the image'
1279 setting for the 'Shrink Selection' dialog. Possible values are
1280 yes and no.
1281 (selection-border-radius 5.000000)
1284 Sets the default border radius for the 'Border Selection' dia‐
1286 log. This is a float value.
1287 (selection-border-style smooth)
1290 Sets the default border style for the 'Border Selection' dialog.
1292 Possible values are hard, smooth and feathered.
1293 (selection-border-edge-lock no)
1296 Sets the default 'Selected areas continue outside the image'
1298 setting for the 'Border Selection' dialog. Possible values are
1299 yes and no.
1300 (fill-options
1303 (style solid)
1304 (antialias yes)
1305 (feather no)
1306 (feather-radius 10.000000))
1307 The default fill options for the fill dialogs. This is a param‐
1309 eter list.
1310 (stroke-options
1313 (style solid)
1314 (antialias yes)
1315 (feather no)
1316 (feather-radius 10.000000)
1317 (method line)
1318 (width 6.000000)
1319 (unit pixels)
1320 (cap-style butt)
1321 (join-style miter)
1322 (miter-limit 10.000000)
1323 (dash-offset 0.000000)
1324 (dash-info 0)
1325 (emulate-brush-dynamics no))
1326 The default stroke options for the stroke dialogs. This is a
1328 parameter list.
1329 (fractalexplorer-path "${gimp_dir}/fractalex‐
1332 plorer:${gimp_data_dir}/fractalexplorer")
1333 Where to search for fractals used by the Fractal Explorer plug-
1335 in. This is a colon-separated list of folders to search.
1336 (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1339 Where to search for Gfig figures used by the Gfig plug-in. This
1341 is a colon-separated list of folders to search.
1342 (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1345 Where to search for gflares used by the GFlare plug-in. This is
1347 a colon-separated list of folders to search.
1348 (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1351 pressionist")
1352 Where to search for data used by the Gimpressionist plug-in.
1354 This is a colon-separated list of folders to search.
1355 (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1358 This path will be searched for scripts when the Script-Fu plug-
1360 in is run. This is a colon-separated list of folders to search.
1361
1364 Strings of type PATH are expanded in a manner similar to bash(1).
1365 Specifically: tilde (~) is expanded to the user's home directory. Note
1366 that the bash feature of being able to refer to other user's home
1367 directories by writing ~userid/ is not valid in this file.
1368 ${variable} is expanded to the current value of an environment vari‐
1370 able. There are a few variables that are pre-defined:
1371 gimp_dir
1373 The personal gimp directory which is set to the value of the
1374 environment variable GIMP2_DIRECTORY or to $XDG_CON‐
1375 FIG_HOME/GIMP/2.10.
1376 gimp_data_dir
1378 Base for paths to shareable data, which is set to the value of
1379 the environment variable GIMP2_DATADIR or to the compiled-in
1380 default value /usr/share/gimp/2.0.
1381 gimp_plug_in_dir
1383 Base to paths for architecture-specific plug-ins and modules,
1384 which is set to the value of the environment variable
1385 GIMP2_PLUGINDIR or to the compiled-in default value
1386 /usr/lib64/gimp/2.0.
1387 gimp_sysconf_dir
1389 Path to configuration files, which is set to the value of the
1390 environment variable GIMP2_SYSCONFDIR or to the compiled-in
1391 default value /etc/gimp/2.0.
1392 gimp_cache_dir
1394 Path to cached files, which is set to the value of the environ‐
1395 ment variable GIMP2_CACHEDIR or to the system default for per-
1396 user cached files.
1397 gimp_temp_dir
1399 Path to temporary files, which is set to the value of the envi‐
1400 ronment variable GIMP2_TEMPDIR or to the system default for tem‐
1401 porary files.
1402
1405 /etc/gimp/2.0/gimprc
1406 System-wide configuration file
1407 $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1409 Per-user configuration file
1410
1413 gimp(1)
1414GIMP Manual Pages Version 2.10.12 GIMPRC(5)