1
2GIMPRC(5)                     File Formats Manual                    GIMPRC(5)
3
4
5

NAME

7       gimprc - gimp configuration file
8

DESCRIPTION

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
15       Comments are introduced by a hash sign (#), and continue until the  end
16       of the line.  Blank lines are ignored.
17
18       The  gimprc  file  associates values with properties.  These properties
19       may be set by lisp-like assignments of the form:
20
21              (property-name value)
22
23       where:
24
25       property-name
26                 is one of the property names described below.
27
28       value     is the value the property is to be set to.
29
30       Either spaces or tabs may be used to separate the name from the value.
31

PROPERTIES

33       Valid properties and their default values are:
34
35
36       (temp-path "${gimp_temp_dir}")
37
38              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
44
45       (swap-path "${gimp_cache_dir}")
46
47              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
56
57       (swap-compression "fast")
58
59              The  compression  method  used  for tile data stored in the swap
60              file.  This is a string value.
61
62
63       (num-processors 1)
64
65              Sets how many threads GIMP should use for operations  that  sup‐
66              port it.  This is an integer value.
67
68
69       (tile-cache-size 2g)
70
71              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
81
82       (use-opencl no)
83
84              When  enabled, uses OpenCL for some operations.  Possible values
85              are yes and no.
86
87
88
89       Specifies the language to use for the user interface.  This is a string
90       value.
91
92
93       (interpolation-type cubic)
94
95              Sets  the  level  of  interpolation  used  for scaling and other
96              transformations.   Possible  values  are  none,  linear,  cubic,
97              nohalo and lohalo.
98
99
100       (default-threshold 15)
101
102              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
109
110       (plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")
111
112              Sets the plug-in search path.  This is a colon-separated list of
113              folders to search.
114
115
116       (module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")
117
118              Sets  the module search path.  This is a colon-separated list of
119              folders to search.
120
121
122       (interpreter-path  "${gimp_dir}/interpreters:${gimp_plug_in_dir}/inter‐
123       preters")
124
125              Sets  the  interpreter  search  path.  This is a colon-separated
126              list of folders to search.
127
128
129       (environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")
130
131              Sets the environ search path.  This is a colon-separated list of
132              folders to search.
133
134
135       (brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")
136
137              Sets  the  brush search path.  This is a colon-separated list of
138              folders to search.
139
140
141       (brush-path-writable "${gimp_dir}/brushes")
142
143              This is a colon-separated list of folders to search.
144
145
146       (dynamics-path "${gimp_dir}/dynamics:${gimp_data_dir}/dynamics")
147
148              Sets the dynamics search path.  This is a  colon-separated  list
149              of folders to search.
150
151
152       (dynamics-path-writable "${gimp_dir}/dynamics")
153
154              This is a colon-separated list of folders to search.
155
156
157       (mypaint-brush-path                                "/usr/share/mypaint-
158       data/1.0/brushes:~/.mypaint/brushes")
159
160              Sets the brush search path.  This is a colon-separated  list  of
161              folders to search.
162
163
164       (mypaint-brush-path-writable "~/.mypaint/brushes")
165
166              This is a colon-separated list of folders to search.
167
168
169       (pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")
170
171              Sets the pattern search path.  This is a colon-separated list of
172              folders to search.
173
174
175       (pattern-path-writable "${gimp_dir}/patterns")
176
177              This is a colon-separated list of folders to search.
178
179
180       (palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")
181
182              Sets the palette search path.  This is a colon-separated list of
183              folders to search.
184
185
186       (palette-path-writable "${gimp_dir}/palettes")
187
188              This is a colon-separated list of folders to search.
189
190
191       (gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")
192
193              Sets  the  gradient search path.  This is a colon-separated list
194              of folders to search.
195
196
197       (gradient-path-writable "${gimp_dir}/gradients")
198
199              This is a colon-separated list of folders to search.
200
201
202       (tool-preset-path  "${gimp_dir}/tool-presets:${gimp_data_dir}/tool-pre‐
203       sets")
204
205              Sets  the  dynamics search path.  This is a colon-separated list
206              of folders to search.
207
208
209       (tool-preset-path-writable "${gimp_dir}/tool-presets")
210
211              This is a colon-separated list of folders to search.
212
213
214       (font-path "${gimp_dir}/fonts:${gimp_data_dir}/fonts")
215
216              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
219
220       (default-brush "2. Hardness 050")
221
222              Specify a default brush.  The brush is searched for in the spec‐
223              ified brush path.  This is a string value.
224
225
226       (default-dynamics "Dynamics Off")
227
228              Specify a default dynamics.  The dynamics is searched for in the
229              specified dynamics path.  This is a string value.
230
231
232       (default-mypaint-brush "Fixme")
233
234              Specify a default MyPaint brush.  This is a string value.
235
236
237       (default-pattern "Pine")
238
239              Specify a default pattern.  This is a string value.
240
241
242       (default-palette "Default")
243
244              Specify a default palette.  This is a string value.
245
246
247       (default-gradient "FG to BG (RGB)")
248
249              Specify a default gradient.  This is a string value.
250
251
252       (default-tool-preset "Current Options")
253
254              Specify  a default tool preset.  The tool preset is searched for
255              in the specified tool prests path.  This is a string value.
256
257
258       (default-font "Sans-serif")
259
260              Specify a default font.  This is a string value.
261
262
263       (global-brush yes)
264
265              When enabled, the selected brush will be  used  for  all  tools.
266              Possible values are yes and no.
267
268
269       (global-dynamics yes)
270
271              When  enabled, the selected dynamics will be used for all tools.
272              Possible values are yes and no.
273
274
275       (global-pattern yes)
276
277              When enabled, the selected pattern will be used for  all  tools.
278              Possible values are yes and no.
279
280
281       (global-palette yes)
282
283              When  enabled,  the selected palette will be used for all tools.
284              Possible values are yes and no.
285
286
287       (global-gradient yes)
288
289              When enabled, the selected gradient will be used for all  tools.
290              Possible values are yes and no.
291
292
293       (global-font yes)
294
295              When  enabled,  the  selected  font  will be used for all tools.
296              Possible values are yes and no.
297
298
299       (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
313              Sets the default image in the  "File/New"  dialog.   This  is  a
314              parameter list.
315
316
317       (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
328              Specify a default image grid.  This is a parameter list.
329
330
331       (undo-levels 5)
332
333              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
337
338       (undo-size 1g)
339
340              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
348
349       (undo-preview-size large)
350
351              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
355
356       (plug-in-history-size 10)
357
358              How  many recently used filters and plug-ins to keep on the Fil‐
359              ters menu.  This is an integer value.
360
361
362       (pluginrc-path "${gimp_dir}/pluginrc")
363
364              Sets the pluginrc search path.  This is a single filename.
365
366
367       (layer-previews yes)
368
369              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
374
375       (group-layer-previews yes)
376
377              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
381
382       (layer-preview-size medium)
383
384              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
388
389       (thumbnail-size normal)
390
391              Sets the size of the thumbnail shown in the Open dialog.  Possi‐
392              ble values are none, normal and large.
393
394
395       (thumbnail-filesize-limit 4M)
396
397              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
404
405       (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
418              Defines  the  color  management  behavior.   This is a parameter
419              list.
420
421
422       (save-document-history yes)
423
424              Keep a permanent record of all opened and  saved  files  in  the
425              Recent Documents list.  Possible values are yes and no.
426
427
428       (quick-mask-color (color-rgba 1 0 0 0.5))
429
430              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
434
435       (import-promote-float no)
436
437              Promote  imported  images  to floating point precision. Does not
438              apply to indexed images.  Possible values are yes and no.
439
440
441       (import-promote-dither yes)
442
443              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
447
448       (import-add-alpha no)
449
450              Add an alpha channel to all layers of imported images.  Possible
451              values are yes and no.
452
453
454       (import-raw-plug-in "")
455
456              Which  plug-in  to  use  for importing raw digital camera files.
457              This is a single filename.
458
459
460       (export-file-type png)
461
462              Export file type used by default.  Possible values are png, jpg,
463              ora, psd, pdf, tif, bmp and webp.
464
465
466       (export-color-profile yes)
467
468              Export  the  image's  color profile by default.  Possible values
469              are yes and no.
470
471
472       (export-metadata-exif yes)
473
474              Export Exif metadata by default.  Possible values  are  yes  and
475              no.
476
477
478       (export-metadata-xmp yes)
479
480              Export XMP metadata by default.  Possible values are yes and no.
481
482
483       (export-metadata-iptc yes)
484
485              Export  IPTC  metadata  by default.  Possible values are yes and
486              no.
487
488
489       (debug-policy fatal)
490
491              Try generating debug data for bug  reporting  when  appropriate.
492              Possible values are warning, critical, fatal and never.
493
494
495       (transparency-size medium-checks)
496
497              Sets  the size of the checkerboard used to display transparency.
498              Possible  values  are  small-checks,  medium-checks  and  large-
499              checks.
500
501
502       (transparency-type gray-checks)
503
504              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
508
509       (snap-distance 8)
510
511              This  is  the  distance  in pixels where Guide and Grid snapping
512              activates.  This is an integer value.
513
514
515       (marching-ants-speed 200)
516
517              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
521
522       (resize-windows-on-zoom no)
523
524              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
528
529       (resize-windows-on-resize no)
530
531              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
536
537       (default-show-all no)
538
539              Show full image content by default.  Possible values are yes and
540              no.
541
542
543       (default-dot-for-dot yes)
544
545              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
549
550       (initial-zoom-to-fit yes)
551
552              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
556
557       (cursor-mode tool-crosshair)
558
559              Sets the type of mouse pointers to  use.   Possible  values  are
560              tool-icon, tool-crosshair and crosshair.
561
562
563       (cursor-updating yes)
564
565              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
569
570       (show-brush-outline yes)
571
572              When enabled, all paint tools will show a preview of the current
573              brush's outline.  Possible values are yes and no.
574
575
576       (show-paint-tool-cursor yes)
577
578              When enabled, the mouse pointer will be  shown  over  the  image
579              while using a paint tool.  Possible values are yes and no.
580
581
582       (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
583
584              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
588              %%  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
627
628
629       (image-status-format "%n (%m)")
630
631              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
635              %%  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
674
675
676       (monitor-xresolution 96)
677
678              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
682
683       (monitor-yresolution 96)
684
685              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
689
690       (monitor-resolution-from-windowing-system yes)
691
692              When enabled, GIMP will use the monitor resolution from the win‐
693              dowing system.  Possible values are yes and no.
694
695
696       (navigation-preview-size medium)
697
698              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
703
704       (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
723              Sets the default settings for the image view.  This is a parame‐
724              ter list.
725
726
727       (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
746              Sets the default settings  used  when  an  image  is  viewed  in
747              fullscreen mode.  This is a parameter list.
748
749
750       (activate-on-focus yes)
751
752              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
757
758       (space-bar-action pan)
759
760              What  to  do  when the space bar is pressed in the image window.
761              Possible values are none, pan and move.
762
763
764       (zoom-quality high)
765
766              There's a tradeoff between speed and quality of  the  zoomed-out
767              display.  Possible values are low and high.
768
769
770       (use-event-history no)
771
772              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
776
777       (edit-non-visible no)
778
779              When  enabled, non-visible layers can be edited as normal.  Pos‐
780              sible values are yes and no.
781
782
783       (move-tool-changes-active no)
784
785              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
789
790       (filter-tool-max-recent 10)
791
792              How many recent settings to keep around in filter  tools.   This
793              is an integer value.
794
795
796       (filter-tool-use-last-settings no)
797
798              Default  to  the  last  used settings in filter tools.  Possible
799              values are yes and no.
800
801
802       (filter-tool-show-color-options no)
803
804              Show advanced color options in filter  tools.   Possible  values
805              are yes and no.
806
807
808       (trust-dirty-flag no)
809
810              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
813
814       (save-device-status yes)
815
816              Remember the current tool, pattern, color, and brush across GIMP
817              sessions.  Possible values are yes and no.
818
819
820       (devices-share-tool no)
821
822              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
826
827       (save-session-info yes)
828
829              Save  the  positions  and  sizes  of  the main dialogs when GIMP
830              exits.  Possible values are yes and no.
831
832
833       (restore-session yes)
834
835              Let GIMP try to restore your last saved session on each startup.
836              Possible values are yes and no.
837
838
839       (restore-monitor no)
840
841              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
845
846       (save-tool-options yes)
847
848              Save  the tool options when GIMP exits.  Possible values are yes
849              and no.
850
851
852       (show-tooltips yes)
853
854              Show a tooltip when the pointer hovers over an  item.   Possible
855              values are yes and no.
856
857
858       (tearoff-menus yes)
859
860              When  enabled,  menus  can be torn off.  Possible values are yes
861              and no.
862
863
864       (can-change-accels no)
865
866              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
870
871       (save-accels yes)
872
873              Save changed keyboard shortcuts when GIMP exits.  Possible  val‐
874              ues are yes and no.
875
876
877       (restore-accels yes)
878
879              Restore saved keyboard shortcuts on each GIMP startup.  Possible
880              values are yes and no.
881
882
883       (last-opened-size 10)
884
885              How many recently opened image filenames to  keep  on  the  File
886              menu.  This is an integer value.
887
888
889       (max-new-image-size 128M)
890
891              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
898
899       (toolbox-color-area yes)
900
901              Show the current foreground and background colors in  the  tool‐
902              box.  Possible values are yes and no.
903
904
905       (toolbox-foo-area no)
906
907              Show  the  currently selected brush, pattern and gradient in the
908              toolbox.  Possible values are yes and no.
909
910
911       (toolbox-image-area no)
912
913              Show the currently active image in the toolbox.  Possible values
914              are yes and no.
915
916
917       (toolbox-wilber yes)
918
919              Show the GIMP mascot at the top of the toolbox.  Possible values
920              are yes and no.
921
922
923       (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
924
925              Sets the theme search path.  This is a colon-separated  list  of
926              folders to search.
927
928
929       (theme "Dark")
930
931              The name of the theme to use.  This is a string value.
932
933
934       (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
935
936              Sets the icon theme search path.  This is a colon-separated list
937              of folders to search.
938
939
940       (icon-theme "Symbolic")
941
942              The name of the icon theme to use.  This is a string value.
943
944
945       (icon-size auto)
946
947              The size of the icons to use.  Possible values are auto,  theme,
948              small, medium, large and huge.
949
950
951       (use-help yes)
952
953              When  enabled, pressing F1 will open the help browser.  Possible
954              values are yes and no.
955
956
957       (show-help-button yes)
958
959              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
964
965       (help-locales "")
966
967              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
972
973       (help-browser gimp)
974
975              Sets the browser used by the help system.  Possible  values  are
976              gimp and web-browser.
977
978
979       (search-show-unavailable-actions no)
980
981              When  enabled,  a  search  of  actions will also return inactive
982              actions.  Possible values are yes and no.
983
984
985       (action-history-size 100)
986
987              The maximum number of actions saved  in  history.   This  is  an
988              integer value.
989
990
991       (user-manual-online no)
992
993              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
997
998       (user-manual-online-uri "https://docs.gimp.org/2.10")
999
1000              The  location  of the online user manual. This is used if 'user-
1001              manual-online' is enabled.  This is a string value.
1002
1003
1004       (dock-window-hint utility)
1005
1006              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
1011
1012       (cursor-handedness right)
1013
1014              Sets the handedness for cursor positioning.  Possible values are
1015              left and right.
1016
1017
1018       (playground-npd-tool no)
1019
1020              Enable the N-Point Deformation tool.  Possible  values  are  yes
1021              and no.
1022
1023
1024       (playground-seamless-clone-tool no)
1025
1026              Enable the Seamless Clone tool.  Possible values are yes and no.
1027
1028
1029       (color-profile-policy ask)
1030
1031              How to handle embedded color profiles when opening a file.  Pos‐
1032              sible values are ask, keep and convert.
1033
1034
1035
1036       Sets the default folder path for all color profile file dialogs.   This
1037       is a
1038              single filename.
1039
1040
1041       (image-convert-profile-intent relative-colorimetric)
1042
1043              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
1047
1048       (image-convert-profile-black-point-compensation yes)
1049
1050              Sets  the default 'Black Point Compensation' state for the 'Con‐
1051              vert to Color Profile' dialog.  Possible values are yes and no.
1052
1053
1054       (image-convert-precision-layer-dither-method none)
1055
1056              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
1061
1062       (image-convert-precision-text-layer-dither-method none)
1063
1064              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
1069
1070       (image-convert-precision-channel-dither-method none)
1071
1072              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
1077
1078       (image-convert-indexed-palette-type generate)
1079
1080              Sets  the default palette type for the 'Convert to Indexed' dia‐
1081              log.  Possible values are generate, web, mono and custom.
1082
1083
1084       (image-convert-indexed-max-colors 256)
1085
1086              Sets the default maximum number of colors for  the  'Convert  to
1087              Indexed' dialog.
1088               This is an integer value.
1089
1090
1091       (image-convert-indexed-remove-duplicates yes)
1092
1093              Sets  the  default 'Remove duplicate colors' state for the 'Con‐
1094              vert to Indexed' dialog.  Possible values are yes and no.
1095
1096
1097       (image-convert-indexed-dither-type none)
1098
1099              Sets the default dithering type for  the  'Convert  to  Indexed'
1100              dialog.  Possible values are none, fs, fs-lowbleed and fixed.
1101
1102
1103       (image-convert-indexed-dither-alpha no)
1104
1105              Sets  the  default  'Dither  alpha'  state  for  the 'Convert to
1106              Indexed' dialog.  Possible values are yes and no.
1107
1108
1109       (image-convert-indexed-dither-text-layers no)
1110
1111              Sets the default 'Dither text layers' state for the 'Convert  to
1112              Indexed' dialog.  Possible values are yes and no.
1113
1114
1115       (image-resize-fill-type transparent)
1116
1117              Sets the default fill type for the 'Canvas Size' dialog.  Possi‐
1118              ble values are foreground, background,  white,  transparent  and
1119              pattern.
1120
1121
1122       (image-resize-layer-set none)
1123
1124              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
1128
1129       (image-resize-resize-text-layers no)
1130
1131              Sets  the  default  'Resize  text  layers' state for the 'Canvas
1132              Size' dialog.  Possible values are yes and no.
1133
1134
1135       (layer-new-name "Layer")
1136
1137              Sets the default layer name for the 'New Layer' dialog.  This is
1138              a string value.
1139
1140
1141       (layer-new-mode normal)
1142
1143              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
1159
1160       (layer-new-blend-space auto)
1161
1162              Sets the default blend space for the 'New Layer' dialog.  Possi‐
1163              ble values are auto, rgb-linear, rgb-perceptual and lab.
1164
1165
1166       (layer-new-composite-space auto)
1167
1168              Sets the default composite space for  the  'New  Layer'  dialog.
1169              Possible values are auto, rgb-linear, rgb-perceptual and lab.
1170
1171
1172       (layer-new-composite-mode auto)
1173
1174              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
1178
1179       (layer-new-opacity 1)
1180
1181              Sets  the default opacity for the 'New Layer' dialog.  This is a
1182              float value.
1183
1184
1185       (layer-new-fill-type transparent)
1186
1187              Sets the default fill type for the 'New Layer' dialog.  Possible
1188              values  are  foreground, background, white, transparent and pat‐
1189              tern.
1190
1191
1192       (layer-resize-fill-type transparent)
1193
1194              Sets the default fill type for the 'Layer Boundary Size' dialog.
1195              Possible  values  are foreground, background, white, transparent
1196              and pattern.
1197
1198
1199       (layer-add-mask-type white)
1200
1201              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
1205
1206       (layer-add-mask-invert no)
1207
1208              Sets the default 'invert mask' state for the  'Add  Layer  Mask'
1209              dialog.  Possible values are yes and no.
1210
1211
1212       (layer-merge-type expand-as-necessary)
1213
1214              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
1218
1219       (layer-merge-active-group-only yes)
1220
1221              Sets the default 'Active group only' for the 'Merge Visible Lay‐
1222              ers' dialog.  Possible values are yes and no.
1223
1224
1225       (layer-merge-discard-invisible no)
1226
1227              Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1228              ers' dialog.  Possible values are yes and no.
1229
1230
1231       (channel-new-name "Channel")
1232
1233              Sets  the  default  channel  name  for the 'New Channel' dialog.
1234              This is a string value.
1235
1236
1237       (channel-new-color (color-rgba 0 0 0 0.5))
1238
1239              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
1243
1244       (path-new-name "Path")
1245
1246              Sets the default path name for the 'New Path' dialog.  This is a
1247              string value.
1248
1249
1250
1251       Sets  the  default folder path for the 'Export Path' dialog.  This is a
1252       single
1253              filename.
1254
1255
1256       (path-export-active-only yes)
1257
1258              Sets the default 'Export the active path' state for the  'Export
1259              Path' dialog.  Possible values are yes and no.
1260
1261
1262
1263       Sets  the  default folder path for the 'Import Path' dialog.  This is a
1264       single
1265              filename.
1266
1267
1268       (path-import-merge no)
1269
1270              Sets the default 'Merge imported paths' state  for  the  'Import
1271              Path' dialog.  Possible values are yes and no.
1272
1273
1274       (path-import-scale no)
1275
1276              Sets  the  default  'Scale imported paths to fit size' state for
1277              the 'Import Path' dialog.  Possible values are yes and no.
1278
1279
1280       (selection-feather-radius 5)
1281
1282              Sets the default feather radius for the 'Feather Selection' dia‐
1283              log.  This is a float value.
1284
1285
1286       (selection-feather-edge-lock yes)
1287
1288              Sets  the  default  'Selected  areas continue outside the image'
1289              setting for the 'Feather Selection' dialog.  Possible values are
1290              yes and no.
1291
1292
1293       (selection-grow-radius 1)
1294
1295              Sets  the  default  grow radius for the 'Grow Selection' dialog.
1296              This is a float value.
1297
1298
1299       (selection-shrink-radius 1)
1300
1301              Sets the default shrink radius for the 'Shrink  Selection'  dia‐
1302              log.  This is a float value.
1303
1304
1305       (selection-shrink-edge-lock no)
1306
1307              Sets  the  default  'Selected  areas continue outside the image'
1308              setting for the 'Shrink Selection' dialog.  Possible values  are
1309              yes and no.
1310
1311
1312       (selection-border-radius 5)
1313
1314              Sets  the  default border radius for the 'Border Selection' dia‐
1315              log.  This is a float value.
1316
1317
1318       (selection-border-style smooth)
1319
1320              Sets the default border style for the 'Border Selection' dialog.
1321              Possible values are hard, smooth and feathered.
1322
1323
1324       (selection-border-edge-lock no)
1325
1326              Sets  the  default  'Selected  areas continue outside the image'
1327              setting for the 'Border Selection' dialog.  Possible values  are
1328              yes and no.
1329
1330
1331       (fill-options
1332                  (style solid)
1333                  (antialias yes)
1334                  (feather no)
1335                  (feather-radius 10))
1336
1337              The default fill options for the fill dialogs.  This is a param‐
1338              eter list.
1339
1340
1341       (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
1356              The default stroke options for the stroke dialogs.   This  is  a
1357              parameter list.
1358
1359
1360       (fractalexplorer-path                           "${gimp_dir}/fractalex‐
1361       plorer:${gimp_data_dir}/fractalexplorer")
1362
1363              Where to search for fractals used by the Fractal Explorer  plug-
1364              in.  This is a colon-separated list of folders to search.
1365
1366
1367       (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1368
1369              Where to search for Gfig figures used by the Gfig plug-in.  This
1370              is a colon-separated list of folders to search.
1371
1372
1373       (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1374
1375              Where to search for gflares used by the GFlare plug-in.  This is
1376              a colon-separated list of folders to search.
1377
1378
1379       (gimpressionist-path  "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1380       pressionist")
1381
1382              Where to search for data used  by  the  Gimpressionist  plug-in.
1383              This is a colon-separated list of folders to search.
1384
1385
1386       (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1387
1388              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
1391

PATH EXPANSION

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
1398       ${variable}  is  expanded  to the current value of an environment vari‐
1399       able.  There are a few variables that are pre-defined:
1400
1401       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
1406       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
1411       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
1417       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
1422       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
1427       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
1432

FILES

1434       /etc/gimp/2.0/gimprc
1435              System-wide configuration file
1436
1437       $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1438              Per-user configuration file
1439
1440

SEE ALSO

1442       gimp(1)
1443
1444
1445
1446GIMP Manual Pages               Version 2.10.14                      GIMPRC(5)
Impressum