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

PATH EXPANSION

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

FILES

1491       /etc/gimp/2.0/gimprc
1492              System-wide configuration file
1493
1494       $XDG_CONFIG_HOME/GIMP/2.10/gimprc
1495              Per-user configuration file
1496
1497

SEE ALSO

1499       gimp(1)
1500
1501
1502
1503GIMP Manual Pages               Version 2.10.32                      GIMPRC(5)
Impressum