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       (check-updates yes)
496
497              Check for availability of GIMP updates through background inter‐
498              net queries.  Possible values are yes and no.
499
500
501       (check-update-timestamp 0)
502
503              Timestamp of the last update check.  (null)
504
505
506       (last-release-timestamp 0)
507
508              The timestamp for the last known release date.  (null)
509
510
511       (last-revision 0)
512
513              The timestamp for the last known release date.  This is an inte‐
514              ger value.
515
516
517
518       The  last  known  release version of GIMP as queried from official web‐
519       site.  This
520              is a string value.
521
522
523       (transparency-size medium-checks)
524
525              Sets the size of the checkerboard used to display  transparency.
526              Possible  values  are  small-checks,  medium-checks  and  large-
527              checks.
528
529
530       (transparency-type gray-checks)
531
532              Sets the manner in which transparency is  displayed  in  images.
533              Possible  values  are  light-checks,  gray-checks,  dark-checks,
534              white-only, gray-only and black-only.
535
536
537       (snap-distance 8)
538
539              This is the distance in pixels where  Guide  and  Grid  snapping
540              activates.  This is an integer value.
541
542
543       (marching-ants-speed 200)
544
545              Speed  of marching ants in the selection outline.  This value is
546              in milliseconds (less time indicates faster marching).  This  is
547              an integer value.
548
549
550       (resize-windows-on-zoom no)
551
552              When  enabled, the image window will automatically resize itself
553              when zooming into and out of images.  This  setting  only  takes
554              effect in multi-window mode.  Possible values are yes and no.
555
556
557       (resize-windows-on-resize no)
558
559              When  enabled, the image window will automatically resize itself
560              whenever the physical image  size  changes.  This  setting  only
561              takes  effect in multi-window mode.  Possible values are yes and
562              no.
563
564
565       (default-show-all no)
566
567              Show full image content by default.  Possible values are yes and
568              no.
569
570
571       (default-dot-for-dot yes)
572
573              When  enabled, this will ensure that each pixel of an image gets
574              mapped to a pixel on the screen.  Possible values  are  yes  and
575              no.
576
577
578       (initial-zoom-to-fit yes)
579
580              When  enabled,  this  will ensure that the full image is visible
581              after a file is opened, otherwise it will be  displayed  with  a
582              scale of 1:1.  Possible values are yes and no.
583
584
585       (cursor-mode tool-crosshair)
586
587              Sets  the  type  of  mouse pointers to use.  Possible values are
588              tool-icon, tool-crosshair and crosshair.
589
590
591       (cursor-updating yes)
592
593              Context-dependent mouse pointers are helpful.  They are  enabled
594              by default.  However, they require overhead that you may want to
595              do without.  Possible values are yes and no.
596
597
598       (show-brush-outline yes)
599
600              When enabled, all paint tools will show a preview of the current
601              brush's outline.  Possible values are yes and no.
602
603
604       (snap-brush-outline no)
605
606              When  enabled,  the  brush  outline will snap to individual dabs
607              while painting.  Possible values are yes and no.
608
609
610       (show-paint-tool-cursor yes)
611
612              When enabled, the mouse pointer will be  shown  over  the  image
613              while using a paint tool.  Possible values are yes and no.
614
615
616       (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
617
618              Sets  the text to appear in image window titles.  This is a for‐
619              mat string; certain % character  sequences  are  recognised  and
620              expanded as follows:
621
622              %%  literal percent sign
623              %f  bare filename, or "Untitled"
624              %F  full path to file, or "Untitled"
625              %p  PDB image id
626              %i  view instance number
627              %t  image type (RGB, grayscale, indexed)
628              %z  zoom factor as a percentage
629              %s  source scale factor
630              %d  destination scale factor
631              %Dx  expands to x if the image is dirty, the empty string other‐
632              wise
633              %Cx expands to x if the image is clean, the empty string  other‐
634              wise
635              %B   expands  to  (modified)  if  the  image is dirty, the empty
636              string otherwise
637              %A  expands to (clean) if the image is clean, the  empty  string
638              otherwise
639              %Nx  expands to x if the image is export-dirty, the empty string
640              otherwise
641              %Ex expands to x if the image is export-clean, the empty  string
642              otherwise
643              %l  the number of layers
644              %L  the number of layers (long form)
645              %m  memory used by the image
646              %n  the name of the active layer/channel
647              %P  the PDB id of the active layer/channel
648              %w  image width in pixels
649              %W  image width in real-world units
650              %h  image height in pixels
651              %H  image height in real-world units
652              %M  the image size expressed in megapixels
653              %u  unit symbol
654              %U  unit abbreviation
655              %x  the width of the active layer/channel in pixels
656              %X  the width of the active layer/channel in real-world units
657              %y  the height of the active layer/channel in pixels
658              %Y  the height of the active layer/channel in real-world units
659              %o  the name of the image's color profile
660
661
662
663       (image-status-format "%n (%m)")
664
665              Sets  the text to appear in image window status bars.  This is a
666              format string; certain % character sequences are recognised  and
667              expanded as follows:
668
669              %%  literal percent sign
670              %f  bare filename, or "Untitled"
671              %F  full path to file, or "Untitled"
672              %p  PDB image id
673              %i  view instance number
674              %t  image type (RGB, grayscale, indexed)
675              %z  zoom factor as a percentage
676              %s  source scale factor
677              %d  destination scale factor
678              %Dx  expands to x if the image is dirty, the empty string other‐
679              wise
680              %Cx expands to x if the image is clean, the empty string  other‐
681              wise
682              %B   expands  to  (modified)  if  the  image is dirty, the empty
683              string otherwise
684              %A  expands to (clean) if the image is clean, the  empty  string
685              otherwise
686              %Nx  expands to x if the image is export-dirty, the empty string
687              otherwise
688              %Ex expands to x if the image is export-clean, the empty  string
689              otherwise
690              %l  the number of layers
691              %L  the number of layers (long form)
692              %m  memory used by the image
693              %n  the name of the active layer/channel
694              %P  the PDB id of the active layer/channel
695              %w  image width in pixels
696              %W  image width in real-world units
697              %h  image height in pixels
698              %H  image height in real-world units
699              %M  the image size expressed in megapixels
700              %u  unit symbol
701              %U  unit abbreviation
702              %x  the width of the active layer/channel in pixels
703              %X  the width of the active layer/channel in real-world units
704              %y  the height of the active layer/channel in pixels
705              %Y  the height of the active layer/channel in real-world units
706              %o  the name of the image's color profile
707
708
709
710       (monitor-xresolution 96)
711
712              Sets  the monitor's horizontal resolution, in dots per inch.  If
713              set to 0, forces the X server to be queried for both  horizontal
714              and vertical resolution information.  This is a float value.
715
716
717       (monitor-yresolution 96)
718
719              Sets  the  monitor's  vertical resolution, in dots per inch.  If
720              set to 0, forces the X server to be queried for both  horizontal
721              and vertical resolution information.  This is a float value.
722
723
724       (monitor-resolution-from-windowing-system yes)
725
726              When enabled, GIMP will use the monitor resolution from the win‐
727              dowing system.  Possible values are yes and no.
728
729
730       (navigation-preview-size medium)
731
732              Sets the size of the navigation preview available in  the  lower
733              right  corner  of  the  image window.  Possible values are tiny,
734              extra-small, small, medium, large, extra-large,  huge,  enormous
735              and gigantic.
736
737
738       (default-view
739                  (show-menubar yes)
740                  (show-statusbar yes)
741                  (show-rulers yes)
742                  (show-scrollbars yes)
743                  (show-selection yes)
744                  (show-layer-boundary yes)
745                  (show-canvas-boundary yes)
746                  (show-guides yes)
747                  (show-grid no)
748                  (show-sample-points yes)
749                  (snap-to-guides yes)
750                  (snap-to-grid no)
751                  (snap-to-canvas no)
752                  (snap-to-path no)
753                  (padding-mode default)
754                  (padding-color (color-rgb 1 1 1))
755                  (padding-in-show-all no))
756
757              Sets the default settings for the image view.  This is a parame‐
758              ter list.
759
760
761       (default-fullscreen-view
762                  (show-menubar yes)
763                  (show-statusbar yes)
764                  (show-rulers yes)
765                  (show-scrollbars yes)
766                  (show-selection yes)
767                  (show-layer-boundary yes)
768                  (show-canvas-boundary yes)
769                  (show-guides yes)
770                  (show-grid no)
771                  (show-sample-points yes)
772                  (snap-to-guides yes)
773                  (snap-to-grid no)
774                  (snap-to-canvas no)
775                  (snap-to-path no)
776                  (padding-mode default)
777                  (padding-color (color-rgb 1 1 1))
778                  (padding-in-show-all no))
779
780              Sets the default settings  used  when  an  image  is  viewed  in
781              fullscreen mode.  This is a parameter list.
782
783
784       (activate-on-focus yes)
785
786              When  enabled,  an  image  will become the active image when its
787              image window receives the focus. This is useful for window  man‐
788              agers using "click to focus".
789               Possible values are yes and no.
790
791
792       (space-bar-action pan)
793
794              What  to  do  when the space bar is pressed in the image window.
795              Possible values are none, pan and move.
796
797
798       (zoom-quality high)
799
800              There's a tradeoff between speed and quality of  the  zoomed-out
801              display.  Possible values are low and high.
802
803
804       (use-event-history no)
805
806              Bugs  in  event history buffer are frequent so in case of cursor
807              offset problems turning it off helps.  Possible values  are  yes
808              and no.
809
810
811       (edit-non-visible no)
812
813              When  enabled, non-visible layers can be edited as normal.  Pos‐
814              sible values are yes and no.
815
816
817       (move-tool-changes-active no)
818
819              If enabled, the move tool sets  the  edited  layer  or  path  as
820              active.   This  used  to  be the default behaviour in older ver‐
821              sions.  Possible values are yes and no.
822
823
824       (filter-tool-max-recent 10)
825
826              How many recent settings to keep around in filter  tools.   This
827              is an integer value.
828
829
830       (filter-tool-use-last-settings no)
831
832              Default  to  the  last  used settings in filter tools.  Possible
833              values are yes and no.
834
835
836       (filter-tool-show-color-options no)
837
838              Show advanced color options in filter  tools.   Possible  values
839              are yes and no.
840
841
842       (trust-dirty-flag no)
843
844              When  enabled,  GIMP  will  not save an image if it has not been
845              changed since it was opened.  Possible values are yes and no.
846
847
848       (save-device-status yes)
849
850              Remember the current tool, pattern, color, and brush across GIMP
851              sessions.  Possible values are yes and no.
852
853
854       (devices-share-tool no)
855
856              When  enabled,  the  same tool and tool options will be used for
857              all input devices. No tool switching will occur when  the  input
858              device changes.  Possible values are yes and no.
859
860
861       (save-session-info yes)
862
863              Save  the  positions  and  sizes  of  the main dialogs when GIMP
864              exits.  Possible values are yes and no.
865
866
867       (restore-session yes)
868
869              Let GIMP try to restore your last saved session on each startup.
870              Possible values are yes and no.
871
872
873       (restore-monitor no)
874
875              When  enabled,  GIMP  will try to restore windows on the monitor
876              they were open before.  When disabled, windows  will  appear  on
877              the currently used monitor.  Possible values are yes and no.
878
879
880       (save-tool-options yes)
881
882              Save  the tool options when GIMP exits.  Possible values are yes
883              and no.
884
885
886       (compact-sliders yes)
887
888              Use compact style for sliders.  Possible values are yes and no.
889
890
891       (show-tooltips yes)
892
893              Show a tooltip when the pointer hovers over an  item.   Possible
894              values are yes and no.
895
896
897       (tearoff-menus yes)
898
899              When  enabled,  menus  can be torn off.  Possible values are yes
900              and no.
901
902
903       (can-change-accels no)
904
905              When enabled, you can change keyboard shortcuts for  menu  items
906              by hitting a key combination while the menu item is highlighted.
907              Possible values are yes and no.
908
909
910       (save-accels yes)
911
912              Save changed keyboard shortcuts when GIMP exits.  Possible  val‐
913              ues are yes and no.
914
915
916       (restore-accels yes)
917
918              Restore saved keyboard shortcuts on each GIMP startup.  Possible
919              values are yes and no.
920
921
922       (last-opened-size 10)
923
924              How many recently opened image filenames to  keep  on  the  File
925              menu.  This is an integer value.
926
927
928       (max-new-image-size 128M)
929
930              GIMP will warn the user if an attempt is made to create an image
931              that would take more memory than the size specified  here.   The
932              integer  size can contain a suffix of 'B', 'K', 'M' or 'G' which
933              makes GIMP interpret the size as being specified in bytes, kilo‐
934              bytes,  megabytes  or  gigabytes.  If no suffix is specified the
935              size defaults to being specified in kilobytes.
936
937
938       (toolbox-color-area yes)
939
940              Show the current foreground and background colors in  the  tool‐
941              box.  Possible values are yes and no.
942
943
944       (toolbox-foo-area no)
945
946              Show  the  currently selected brush, pattern and gradient in the
947              toolbox.  Possible values are yes and no.
948
949
950       (toolbox-image-area no)
951
952              Show the currently active image in the toolbox.  Possible values
953              are yes and no.
954
955
956       (toolbox-wilber yes)
957
958              Show the GIMP mascot at the top of the toolbox.  Possible values
959              are yes and no.
960
961
962       (toolbox-groups yes)
963
964              Use a single toolbox button for grouped tools.  Possible  values
965              are yes and no.
966
967
968       (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
969
970              Sets  the  theme search path.  This is a colon-separated list of
971              folders to search.
972
973
974       (theme "Dark")
975
976              The name of the theme to use.  This is a string value.
977
978
979       (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
980
981              Sets the icon theme search path.  This is a colon-separated list
982              of folders to search.
983
984
985       (icon-theme "Symbolic")
986
987              The name of the icon theme to use.  This is a string value.
988
989
990       (icon-size auto)
991
992              The  size of the icons to use.  Possible values are auto, theme,
993              small, medium, large and huge.
994
995
996       (use-help yes)
997
998              When enabled, pressing F1 will open the help browser.   Possible
999              values are yes and no.
1000
1001
1002       (show-help-button yes)
1003
1004              When  enabled, dialogs will show a help button that gives access
1005              to the related help page.  Without this button,  the  help  page
1006              can  still  be  reached by pressing F1.  Possible values are yes
1007              and no.
1008
1009
1010       (help-locales "")
1011
1012              Specifies the language preferences used by the help system. This
1013              is  a colon-separated list of language identifiers with decreas‐
1014              ing priority. If empty, the language is taken  from  the  user's
1015              locale setting.  This is a string value.
1016
1017
1018       (help-browser gimp)
1019
1020              Sets  the  browser used by the help system.  Possible values are
1021              gimp and web-browser.
1022
1023
1024       (search-show-unavailable-actions no)
1025
1026              When enabled, a search of  actions  will  also  return  inactive
1027              actions.  Possible values are yes and no.
1028
1029
1030       (action-history-size 100)
1031
1032              The  maximum  number  of  actions  saved in history.  This is an
1033              integer value.
1034
1035
1036       (user-manual-online no)
1037
1038              When enabled, the online user manual will be used  by  the  help
1039              system.  Otherwise the locally installed copy is used.  Possible
1040              values are yes and no.
1041
1042
1043       (user-manual-online-uri "https://docs.gimp.org/2.10")
1044
1045              The location of the online user manual. This is used  if  'user-
1046              manual-online' is enabled.  This is a string value.
1047
1048
1049       (dock-window-hint utility)
1050
1051              The window type hint that is set on dock windows and the toolbox
1052              window. This may affect the way your  window  manager  decorates
1053              and  handles these windows.  Possible values are normal, utility
1054              and keep-above.
1055
1056
1057       (cursor-handedness right)
1058
1059              Sets the handedness for cursor positioning.  Possible values are
1060              left and right.
1061
1062
1063       (playground-npd-tool no)
1064
1065              Enable  the  N-Point  Deformation tool.  Possible values are yes
1066              and no.
1067
1068
1069       (playground-seamless-clone-tool no)
1070
1071              Enable the Seamless Clone tool.  Possible values are yes and no.
1072
1073
1074       (color-profile-policy ask)
1075
1076              How to handle embedded color profiles when opening a file.  Pos‐
1077              sible values are ask, keep and convert.
1078
1079
1080
1081       Sets  the default folder path for all color profile file dialogs.  This
1082       is a
1083              single filename.
1084
1085
1086       (image-convert-profile-intent relative-colorimetric)
1087
1088              Sets the default rendering intent for the 'Convert to Color Pro‐
1089              file'  dialog.  Possible values are perceptual, relative-colori‐
1090              metric, saturation and absolute-colorimetric.
1091
1092
1093       (image-convert-profile-black-point-compensation yes)
1094
1095              Sets the default 'Black Point Compensation' state for the  'Con‐
1096              vert to Color Profile' dialog.  Possible values are yes and no.
1097
1098
1099       (image-convert-precision-layer-dither-method none)
1100
1101              Sets  the default layer dithering method for the 'Convert Preci‐
1102              sion' dialog.  Possible values are none, floyd-steinberg, bayer,
1103              random,  random-covariant,  add,  add-covariant,  xor  and  xor-
1104              covariant.
1105
1106
1107       (image-convert-precision-text-layer-dither-method none)
1108
1109              Sets the default text layer dithering method  for  the  'Convert
1110              Precision'  dialog.   Possible values are none, floyd-steinberg,
1111              bayer, random, random-covariant,  add,  add-covariant,  xor  and
1112              xor-covariant.
1113
1114
1115       (image-convert-precision-channel-dither-method none)
1116
1117              Sets  the default channel dithering method for the 'Convert Pre‐
1118              cision' dialog.   Possible  values  are  none,  floyd-steinberg,
1119              bayer,  random,  random-covariant,  add,  add-covariant, xor and
1120              xor-covariant.
1121
1122
1123       (image-convert-indexed-palette-type generate)
1124
1125              Sets the default palette type for the 'Convert to Indexed'  dia‐
1126              log.  Possible values are generate, web, mono and custom.
1127
1128
1129       (image-convert-indexed-max-colors 256)
1130
1131              Sets  the  default  maximum number of colors for the 'Convert to
1132              Indexed' dialog.
1133               This is an integer value.
1134
1135
1136       (image-convert-indexed-remove-duplicates yes)
1137
1138              Sets the default 'Remove duplicate colors' state for  the  'Con‐
1139              vert to Indexed' dialog.  Possible values are yes and no.
1140
1141
1142       (image-convert-indexed-dither-type none)
1143
1144              Sets  the  default  dithering  type for the 'Convert to Indexed'
1145              dialog.  Possible values are none, fs, fs-lowbleed and fixed.
1146
1147
1148       (image-convert-indexed-dither-alpha no)
1149
1150              Sets the default  'Dither  alpha'  state  for  the  'Convert  to
1151              Indexed' dialog.  Possible values are yes and no.
1152
1153
1154       (image-convert-indexed-dither-text-layers no)
1155
1156              Sets  the default 'Dither text layers' state for the 'Convert to
1157              Indexed' dialog.  Possible values are yes and no.
1158
1159
1160       (image-resize-fill-type transparent)
1161
1162              Sets the default fill type for the 'Canvas Size' dialog.  Possi‐
1163              ble  values  are  foreground, background, white, transparent and
1164              pattern.
1165
1166
1167       (image-resize-layer-set none)
1168
1169              Sets the default set of layers to resize for the  'Canvas  Size'
1170              dialog.  Possible values are none, all, image-sized, visible and
1171              linked.
1172
1173
1174       (image-resize-resize-text-layers no)
1175
1176              Sets the default 'Resize text  layers'  state  for  the  'Canvas
1177              Size' dialog.  Possible values are yes and no.
1178
1179
1180       (layer-new-name "Layer")
1181
1182              Sets the default layer name for the 'New Layer' dialog.  This is
1183              a string value.
1184
1185
1186       (layer-new-mode normal)
1187
1188              Sets the default mode for the 'New Layer' dialog.  Possible val‐
1189              ues are normal-legacy, dissolve, behind-legacy, multiply-legacy,
1190              screen-legacy,  overlay-legacy,   difference-legacy,   addition-
1191              legacy,   subtract-legacy,   darken-only-legacy,   lighten-only-
1192              legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy,
1193              hsv-value-legacy,   divide-legacy,   dodge-legacy,  burn-legacy,
1194              hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-
1195              merge-legacy,  color-erase-legacy, overlay, lch-hue, lch-chroma,
1196              lch-color, lch-lightness, normal, behind, multiply, screen, dif‐
1197              ference, addition, subtract, darken-only, lighten-only, hsv-hue,
1198              hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hard‐
1199              light,  softlight, grain-extract, grain-merge, vivid-light, pin-
1200              light, linear-light,  hard-mix,  exclusion,  linear-burn,  luma-
1201              darken-only,  luma-lighten-only,  luminance, color-erase, erase,
1202              merge, split, pass-through, replace and anti-erase.
1203
1204
1205       (layer-new-blend-space auto)
1206
1207              Sets the default blend space for the 'New Layer' dialog.  Possi‐
1208              ble values are auto, rgb-linear, rgb-perceptual and lab.
1209
1210
1211       (layer-new-composite-space auto)
1212
1213              Sets  the  default  composite  space for the 'New Layer' dialog.
1214              Possible values are auto, rgb-linear, rgb-perceptual and lab.
1215
1216
1217       (layer-new-composite-mode auto)
1218
1219              Sets the default composite mode  for  the  'New  Layer'  dialog.
1220              Possible values are auto, union, clip-to-backdrop, clip-to-layer
1221              and intersection.
1222
1223
1224       (layer-new-opacity 1)
1225
1226              Sets the default opacity for the 'New Layer' dialog.  This is  a
1227              float value.
1228
1229
1230       (layer-new-fill-type transparent)
1231
1232              Sets the default fill type for the 'New Layer' dialog.  Possible
1233              values are foreground, background, white, transparent  and  pat‐
1234              tern.
1235
1236
1237       (layer-resize-fill-type transparent)
1238
1239              Sets the default fill type for the 'Layer Boundary Size' dialog.
1240              Possible values are foreground, background,  white,  transparent
1241              and pattern.
1242
1243
1244       (layer-add-mask-type white)
1245
1246              Sets the default mask for the 'Add Layer Mask' dialog.  Possible
1247              values are white, black, alpha, alpha-transfer, selection,  copy
1248              and channel.
1249
1250
1251       (layer-add-mask-invert no)
1252
1253              Sets  the  default  'invert mask' state for the 'Add Layer Mask'
1254              dialog.  Possible values are yes and no.
1255
1256
1257       (layer-merge-type expand-as-necessary)
1258
1259              Sets the default merge type for the 'Merge Visible Layers'  dia‐
1260              log.   Possible  values  are expand-as-necessary, clip-to-image,
1261              clip-to-bottom-layer and flatten-image.
1262
1263
1264       (layer-merge-active-group-only yes)
1265
1266              Sets the default 'Active group only' for the 'Merge Visible Lay‐
1267              ers' dialog.  Possible values are yes and no.
1268
1269
1270       (layer-merge-discard-invisible no)
1271
1272              Sets the default 'Discard invisible' for the 'Merge Visible Lay‐
1273              ers' dialog.  Possible values are yes and no.
1274
1275
1276       (channel-new-name "Channel")
1277
1278              Sets the default channel name  for  the  'New  Channel'  dialog.
1279              This is a string value.
1280
1281
1282       (channel-new-color (color-rgba 0 0 0 0.5))
1283
1284              Sets the default color and opacity for the 'New Channel' dialog.
1285              The color is specified in the form (color-rgba  red  green  blue
1286              alpha) with channel values as floats in the range of 0.0 to 1.0.
1287
1288
1289       (path-new-name "Path")
1290
1291              Sets the default path name for the 'New Path' dialog.  This is a
1292              string value.
1293
1294
1295
1296       Sets the default folder path for the 'Export Path' dialog.  This  is  a
1297       single
1298              filename.
1299
1300
1301       (path-export-active-only yes)
1302
1303              Sets  the default 'Export the active path' state for the 'Export
1304              Path' dialog.  Possible values are yes and no.
1305
1306
1307
1308       Sets the default folder path for the 'Import Path' dialog.  This  is  a
1309       single
1310              filename.
1311
1312
1313       (path-import-merge no)
1314
1315              Sets  the  default  'Merge imported paths' state for the 'Import
1316              Path' dialog.  Possible values are yes and no.
1317
1318
1319       (path-import-scale no)
1320
1321              Sets the default 'Scale imported paths to fit  size'  state  for
1322              the 'Import Path' dialog.  Possible values are yes and no.
1323
1324
1325       (selection-feather-radius 5)
1326
1327              Sets the default feather radius for the 'Feather Selection' dia‐
1328              log.  This is a float value.
1329
1330
1331       (selection-feather-edge-lock yes)
1332
1333              Sets the default 'Selected areas  continue  outside  the  image'
1334              setting for the 'Feather Selection' dialog.  Possible values are
1335              yes and no.
1336
1337
1338       (selection-grow-radius 1)
1339
1340              Sets the default grow radius for the  'Grow  Selection'  dialog.
1341              This is a float value.
1342
1343
1344       (selection-shrink-radius 1)
1345
1346              Sets  the  default shrink radius for the 'Shrink Selection' dia‐
1347              log.  This is a float value.
1348
1349
1350       (selection-shrink-edge-lock no)
1351
1352              Sets the default 'Selected areas  continue  outside  the  image'
1353              setting  for the 'Shrink Selection' dialog.  Possible values are
1354              yes and no.
1355
1356
1357       (selection-border-radius 5)
1358
1359              Sets the default border radius for the 'Border  Selection'  dia‐
1360              log.  This is a float value.
1361
1362
1363       (selection-border-style smooth)
1364
1365              Sets the default border style for the 'Border Selection' dialog.
1366              Possible values are hard, smooth and feathered.
1367
1368
1369       (selection-border-edge-lock no)
1370
1371              Sets the default 'Selected areas  continue  outside  the  image'
1372              setting  for the 'Border Selection' dialog.  Possible values are
1373              yes and no.
1374
1375
1376       (fill-options
1377                  (style solid)
1378                  (antialias yes)
1379                  (feather no)
1380                  (feather-radius 10))
1381
1382              The default fill options for the fill dialogs.  This is a param‐
1383              eter list.
1384
1385
1386       (stroke-options
1387                  (style solid)
1388                  (antialias yes)
1389                  (feather no)
1390                  (feather-radius 10)
1391                  (method line)
1392                  (width 6)
1393                  (unit pixels)
1394                  (cap-style butt)
1395                  (join-style miter)
1396                  (miter-limit 10)
1397                  (dash-offset 0)
1398                  (dash-info 0)
1399                  (emulate-brush-dynamics no))
1400
1401              The  default  stroke  options for the stroke dialogs.  This is a
1402              parameter list.
1403
1404
1405       (fractalexplorer-path                           "${gimp_dir}/fractalex‐
1406       plorer:${gimp_data_dir}/fractalexplorer")
1407
1408              Where  to search for fractals used by the Fractal Explorer plug-
1409              in.  This is a colon-separated list of folders to search.
1410
1411
1412       (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1413
1414              Where to search for Gfig figures used by the Gfig plug-in.  This
1415              is a colon-separated list of folders to search.
1416
1417
1418       (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1419
1420              Where to search for gflares used by the GFlare plug-in.  This is
1421              a colon-separated list of folders to search.
1422
1423
1424       (gimpressionist-path  "${gimp_dir}/gimpressionist:${gimp_data_dir}/gim‐
1425       pressionist")
1426
1427              Where  to  search  for  data used by the Gimpressionist plug-in.
1428              This is a colon-separated list of folders to search.
1429
1430
1431       (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1432
1433              This path will be searched for scripts when the Script-Fu  plug-
1434              in is run.  This is a colon-separated list of folders to search.
1435
1436

PATH EXPANSION

1438       Strings  of  type  PATH  are  expanded  in a manner similar to bash(1).
1439       Specifically: tilde (~) is expanded to the user's home directory.  Note
1440       that  the  bash  feature  of  being  able to refer to other user's home
1441       directories by writing ~userid/ is not valid in this file.
1442
1443       ${variable} is expanded to the current value of  an  environment  vari‐
1444       able.  There are a few variables that are pre-defined:
1445
1446       gimp_dir
1447              The  personal  gimp  directory  which is set to the value of the
1448              environment   variable   GIMP2_DIRECTORY   or    to    $XDG_CON‐
1449              FIG_HOME/GIMP/2.10.
1450
1451       gimp_data_dir
1452              Base  for  paths to shareable data, which is set to the value of
1453              the environment variable GIMP2_DATADIR  or  to  the  compiled-in
1454              default value /usr/share/gimp/2.0.
1455
1456       gimp_plug_in_dir
1457              Base  to  paths  for architecture-specific plug-ins and modules,
1458              which  is  set  to  the  value  of  the   environment   variable
1459              GIMP2_PLUGINDIR    or   to   the   compiled-in   default   value
1460              /usr/lib64/gimp/2.0.
1461
1462       gimp_sysconf_dir
1463              Path to configuration files, which is set to the  value  of  the
1464              environment  variable  GIMP2_SYSCONFDIR  or  to  the compiled-in
1465              default value /etc/gimp/2.0.
1466
1467       gimp_cache_dir
1468              Path to cached files, which is set to the value of the  environ‐
1469              ment  variable  GIMP2_CACHEDIR or to the system default for per-
1470              user cached files.
1471
1472       gimp_temp_dir
1473              Path to temporary files, which is set to the value of the  envi‐
1474              ronment variable GIMP2_TEMPDIR or to the system default for tem‐
1475              porary files.
1476
1477

FILES

1479       /etc/gimp/2.0/gimprc
1480              System-wide configuration file
1481
1482       $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1483              Per-user configuration file
1484
1485

SEE ALSO

1487       gimp(1)
1488
1489
1490
1491GIMP Manual Pages               Version 2.10.18                      GIMPRC(5)
Impressum