Merge pull request #152 from WACOMalt/patch-1

Update README.md for correct Win11 shortcut locations.

.config/GIMP/3.0/action-history

@@ -0,0 +1,47 @@
+# GIMP action-history
+
+(history-item "layers-lock-alpha" 0)
+(history-item "layers-lock-content" 0)
+(history-item "layers-lock-position" 4)
+(history-item "dockable-show-button-bar" 0)
+(history-item "dockable-preview-size-tiny" 0)
+(history-item "dockable-preview-size-medium" 0)
+(history-item "dockable-tab-style-icon" 0)
+(history-item "dockable-tab-style-preview" 0)
+(history-item "dockable-view-type-list" 0)
+(history-item "dock-show-image-menu" 0)
+(history-item "dock-auto-follow-active" 0)
+(history-item "dock-move-to-screen--1" 0)
+(history-item "layers-mask-show" 0)
+(history-item "layers-mask-disable" 2)
+(history-item "layers-visible" 0)
+(history-item "channels-lock-content" 0)
+(history-item "channels-lock-position" 1)
+(history-item "view-show-statusbar" 0)
+(history-item "layers-blend-space-auto" 0)
+(history-item "layers-composite-space-auto" 0)
+(history-item "layers-composite-mode-auto" 0)
+(history-item "paths-lock-content" 0)
+(history-item "paths-lock-position" 1)
+(history-item "view-dot-for-dot" 0)
+(history-item "view-display-black-point-compensation" 0)
+(history-item "view-snap-to-guides" 0)
+(history-item "view-show-menubar" 1)
+(history-item "drawable-visible" 0)
+(history-item "drawable-lock-content" 0)
+(history-item "drawable-lock-position" 0)
+(history-item "view-color-management-enable" 0)
+(history-item "view-show-selection" 0)
+(history-item "view-show-guides" 0)
+(history-item "view-show-sample-points" 0)
+(history-item "view-snap-to-canvas" 0)
+(history-item "view-show-rulers" 0)
+(history-item "view-show-scrollbars" 0)
+(history-item "image-convert-non-linear" 0)
+(history-item "image-color-profile-use-srgb" 0)
+(history-item "select-none" 0)
+(history-item "image-new" 0)
+(history-item "file-export-as" 0)
+(history-item "file-quit" 0)
+
+# end of action-history

.config/GIMP/3.0/colorrc

@@ -3,8 +3,8 @@
 # This file holds a list of recently used colors.
 
 (color-history
-    (color "HSV float" 12 "\244\17\44\77\225\203\310\76\62\60\217\76" 0)
     (color "R'G'B'A float" 16 "\0\0\200\77\0\0\200\77\0\0\200\77\0\0\200\77" 0)
+    (color "HSV float" 12 "\244\17\44\77\225\203\310\76\62\60\217\76" 0)
     (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0)
     (color "HSV float" 12 "\23\21\76\77\0\0\200\77\0\0\200\77" 0))
 

.config/GIMP/3.0/contextrc

@@ -1,9 +1,7 @@
 # GIMP user context
 
-(tool "gimp-move-tool")
+(tool "gimp-rect-select-tool")
 (paint-info "gimp-paintbrush")
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (mybrush "100% Opaque")

.config/GIMP/3.0/devicerc

@@ -3,8 +3,8 @@
 (GimpDeviceInfo "Virtual core pointer"
     (icon-name "gimp-cursor")
     (name "Virtual core pointer")
-    (tool-options "GimpMoveOptions"
-        (tool "gimp-move-tool"))
+    (tool-options "GimpRectangleSelectOptions"
+        (tool "gimp-rect-select-tool"))
     (use-fg-bg no)
     (use-opacity-paint-mode no)
     (use-brush no)

.config/GIMP/3.0/filters/GimpBrightnessContrastConfig.settings

@@ -0,0 +1,8 @@
+# settings
+
+(GimpBrightnessContrastConfig "2025-02-26 08:53:39"
+    (time 1740570819)
+    (brightness 0)
+    (contrast 0.023622047244094488))
+
+# end of settings

.config/GIMP/3.0/gimprc

@@ -6,9 +6,8 @@
 # Most values can be set within GIMP by changing some options in the
 # Preferences dialog.
 
-(language "en_US")
-(prev-language "en_US")
-(config-version "3.0.0-RC3+git")
+(language "")
+(config-version "3.0.0")
 (undo-levels 8)
 (undo-preview-size medium)
 (layer-preview-size extra-large)

.config/GIMP/3.0/plug-in-settings/GimpProcedureConfigRun-file-jpeg-export.last

@@ -0,0 +1,27 @@
+# settings
+
+(quality 1)
+(smoothing 0)
+(optimize yes)
+(progressive yes)
+(cmyk no)
+(sub-sampling "sub-sampling-1x1")
+(baseline yes)
+(restart 16)
+(dct "integer")
+(include-exif no)
+(include-iptc no)
+(include-xmp no)
+(include-color-profile no)
+(include-thumbnail no)
+(include-comment no)
+(use-original-quality yes)
+(original-quality 100)
+(original-sub-sampling 2)
+(original-num-quant-tables 0)
+(show-preview no)
+(use-arithmetic-coding no)
+(use-restart no)
+(gimp-comment "Created with GIMP")
+
+# end of settings

.config/GIMP/3.0/plug-in-settings/GimpProcedureConfigRun-file-png-export.last

@@ -0,0 +1,20 @@
+# settings
+
+(interlaced no)
+(compression 9)
+(bkgd no)
+(offs no)
+(phys yes)
+(time yes)
+(save-transparent no)
+(optimize-palette no)
+(format "auto")
+(include-exif no)
+(include-iptc no)
+(include-xmp no)
+(include-color-profile no)
+(include-thumbnail no)
+(include-comment no)
+(gimp-comment "Created with GIMP")
+
+# end of settings

.config/GIMP/3.0/pluginrc

@@ -192,39 +192,6 @@
         (proc-arg 9 "GimpParamChannel" "GimpChannel" "channel" "Channel" "Channel" 3 1)
         (proc-arg 9 "GimpParamDrawable" "GimpDrawable" "drawable" "Drawable" "Drawable" 3 1)
         (proc-arg 9 "GimpParamPath" "GimpPath" "vectors" "Vectors" "Vectors" 3 1)))
-(plug-in-def "${gimp_plug_in_dir}/plug-ins/test-file-plug-ins/test-file-plug-ins.py" 0
-    (proc-def "test-import-plug-ins" 1
-         "Run file import plug-in tests"
-         "Run file import plug-in tests"
-         "Jacob Boerema"
-         "Jacob Boerema"
-         "2021-2024"
-         "Test file _import plug-ins"
-         1
-        (menu-path "<Image>/Filters/Development/Python-Fu/")
-        (icon icon-name -1 "")
-         "*"
-         2147483647
-         3 0
-        (proc-arg 3 "GParamEnum" "GimpRunMode" "run-mode" "Run mode" "The run mode" 3 1)
-        (proc-arg 9 "GimpParamImage" "GimpImage" "image" "Image" "The input image" 259 0)
-        (proc-arg 10 "GimpParamCoreObjectArray" "GimpCoreObjectArray" "drawables" "Drawables" "The input drawables" 259 "GimpDrawable"))
-    (proc-def "test-export-plug-ins" 1
-         "Run file export plug-in tests"
-         "Run file export plug-in tests"
-         "Jacob Boerema"
-         "Jacob Boerema"
-         "2021-2024"
-         "Test file _export plug-ins"
-         1
-        (menu-path "<Image>/Filters/Development/Python-Fu/")
-        (icon icon-name -1 "")
-         "*"
-         2147483647
-         3 0
-        (proc-arg 3 "GParamEnum" "GimpRunMode" "run-mode" "Run mode" "The run mode" 3 1)
-        (proc-arg 9 "GimpParamImage" "GimpImage" "image" "Image" "The input image" 259 0)
-        (proc-arg 10 "GimpParamCoreObjectArray" "GimpCoreObjectArray" "drawables" "Drawables" "The input drawables" 259 "GimpDrawable")))
 (plug-in-def "${gimp_plug_in_dir}/plug-ins/spyro-plus/spyro-plus.py" 0
     (proc-def "plug-in-spyrogimp" 1
          "Draw spyrographs using current tool settings and selection."

.config/GIMP/3.0/sessionrc

@@ -11,8 +11,9 @@
     (size 640 480))
 (session-info "toplevel"
     (factory-entry "gimp-single-image-window")
-    (position 1928 48)
-    (size 1896 1975)
+    (position 16 16)
+    (size 1888 1011)
+    (monitor 1)
     (open-on-exit)
     (aux-info
         (left-docks-width "66")
@@ -46,7 +47,7 @@
                 (aux-info
                     (show-button-bar "true"))))
         (book
-            (position 706)
+            (position 741)
             (current-page 0)
             (dockable "gimp-layer-list"
                 (tab-style icon)
@@ -68,7 +69,7 @@
     (position 1257 725))
 (session-info "toplevel"
     (factory-entry "gimp-toolbox-color-dialog")
-    (position 626 840))
+    (position 2559 856))
 (session-info "toplevel"
     (factory-entry "gimp-preferences-dialog")
     (position 1340 397)
@@ -83,7 +84,7 @@
     (size 562 606))
 (session-info "toplevel"
     (factory-entry "gimp-file-export-dialog")
-    (position 256 192)
+    (position 232 32)
     (size 1688 1197))
 (session-info "toplevel"
     (factory-entry "gimp-keyboard-shortcuts-dialog")
@@ -93,6 +94,10 @@
     (factory-entry "gimp-file-open-dialog")
     (position 1257 32)
     (size 1688 1197))
+(session-info "toplevel"
+    (factory-entry "gimp-brightness-contrast-tool-dialog")
+    (position 91 439)
+    (monitor 1))
 
 (hide-docks no)
 (single-window-mode yes)

.config/GIMP/3.0/shortcutsrc

@@ -31,17 +31,16 @@
 # (action "layers-lower-to-bottom")
 # (action "view-zoom-minimum")
 # (action "context-palette-background-set")
-# (action "filters-gegl-shuffle-search")
 # (action "context-opacity-decrease-skip")
 # (action "image-convert-float")
 # (action "view-scroll-left-border")
 # (action "view-show-all")
 # (action "dialogs-dynamics-editor")
 # (action "select-fill")
-# (action "filters-gegl-selective-hue-saturation")
 # (action "gimp-help-using-photography")
 # (action "layers-select-next" "Page_Down")
 # (action "plug-in-qbist")
+# (action "tools-airbrush-rate-maximum")
 # (action "layers-resize")
 # (action "plug-in-cml-explorer")
 # (action "view-show-canvas-boundary")
@@ -53,14 +52,12 @@
 # (action "tools-transform-3d" "<Shift>w")
 # (action "paths-color-tag-yellow")
 # (action "filters-pixelize")
-# (action "tools-airbrush-rate-maximum")
 # (action "filters-desaturate")
 # (action "paths-select-top")
 # (action "view-scroll-right-border")
 # (action "filters-long-shadow")
 # (action "script-fu-fuzzy-border")
 # (action "filters-lens-blur")
-# (action "test-export-plug-ins")
 # (action "filters-semi-flatten")
 # (action "view-padding-color-in-show-all")
 # (action "filters-gegl-brightness-contrast")
@@ -91,7 +88,6 @@
 # (action "filters-median-blur")
 # (action "windows-use-single-window-mode")
 # (action "tools-color-average-radius-set")
-# (action "filters-gegl-alpha-inpaint")
 # (action "plug-in-smooth-palette")
 # (action "paths-color-tag-violet")
 # (action "layers-mask-disable")
@@ -136,7 +132,7 @@
 # (action "context-brush-select-first")
 # (action "file-save" "<Primary>s")
 # (action "context-background-red-increase-skip")
-(action "tools-size-decrease")
+# (action "tools-size-decrease")
 # (action "edit-paste-into")
 # (action "image-flip-horizontal")
 # (action "view-flip-horizontally")
@@ -172,7 +168,6 @@
 # (action "context-foreground-saturation-decrease-skip")
 # (action "filters-lens-distortion")
 # (action "view-scroll-horizontal")
-# (action "filters-gegl-boxblur")
 # (action "tools-hardness-decrease")
 # (action "drawable-flip-vertical")
 # (action "paths-select-bottom")
@@ -212,7 +207,7 @@
 # (action "context-foreground-green-maximum")
 # (action "context-foreground-green-increase-skip")
 # (action "context-brush-spacing-set")
-# (action "edit-fill-fg" "<Primary>comma")
+(action "edit-fill-fg" "<Primary>BackSpace")
 # (action "drawable-rotate-180")
 # (action "plug-in-gflare")
 # (action "gimp-palette-export-text")
@@ -230,7 +225,7 @@
 # (action "context-palette-foreground-previous-skip")
 # (action "context-opacity-decrease")
 # (action "view-zoom-2-1" "2" "KP_2")
-# (action "tools-hardness-decrease-skip")
+(action "tools-hardness-decrease-skip" "braceleft")
 # (action "context-foreground-red-increase-skip")
 # (action "filters-stretch-contrast-hsv")
 # (action "context-background-value-increase-skip")
@@ -239,7 +234,6 @@
 # (action "dialogs-patterns" "<Primary><Shift>p")
 # (action "tools-aspect-maximum")
 # (action "layers-merge-layers-last-values")
-# (action "filters-gegl-gray-component-replacement")
 # (action "paths-lock-content")
 # (action "dialogs-gradients" "<Primary>g")
 # (action "context-brush-spikes-maximum")
@@ -283,7 +277,6 @@
 # (action "script-fu-reverse-layers")
 # (action "layers-color-tag-red")
 # (action "filters-shift")
-# (action "filters-gegl-segment-kmeans")
 # (action "edit-undo-clear")
 # (action "tools-aspect-set")
 # (action "filters-offset" "<Primary><Shift>o")
@@ -296,7 +289,7 @@
 # (action "tools-by-color-select" "<Shift>o")
 # (action "script-fu-add-bevel")
 # (action "script-fu-weave")
-(action "context-brush-radius-increase" "bracketright")
+# (action "context-brush-radius-increase")
 # (action "channels-color-tag-violet")
 # (action "windows-hide-docks")
 # (action "context-tool-select-next")
@@ -308,7 +301,6 @@
 # (action "tools-gradient" "g")
 # (action "plug-in-warp")
 # (action "edit-named-copy")
-# (action "filters-gegl-aces-rrt")
 # (action "tools-offset")
 # (action "context-brush-select-next")
 # (action "context-opacity-increase")
@@ -354,17 +346,16 @@
 (action "tools-scale" "<Primary>t")
 # (action "file-save-as" "<Primary><Shift>s")
 # (action "file-save-and-close")
-# (action "view-move-to-screen--1")
-# (action "view-rotate-345")
 # (action "filters-vignette")
+# (action "view-rotate-345")
+# (action "view-move-to-screen--1")
 # (action "context-pattern-select-last")
 # (action "context-paint-mode-first")
 # (action "plug-in-animationoptimize")
 # (action "dialogs-templates")
 # (action "channels-color-tag-gray")
 # (action "context-background-green-increase")
-# (action "image-resize")
-# (action "filters-gegl-ctx-script")
+(action "image-resize" "<Primary><Alt>c")
 # (action "script-fu-round-corners")
 # (action "context-swatch-foreground-first")
 # (action "tools-spacing-maximum")
@@ -400,7 +391,7 @@
 (action "tools-fuzzy-select" "w")
 # (action "filters-edge-neon")
 # (action "gimp-help-using-selections")
-# (action "file-export" "<Primary>e")
+(action "file-export" "<Primary><Shift><Alt>w")
 # (action "filters-noise-rgb")
 # (action "filters-image-gradient")
 # (action "tools-airbrush-rate-minimum")
@@ -443,14 +434,14 @@
 # (action "image-rotate-270")
 # (action "tools-opacity-increase-percent")
 # (action "context-brush-spikes-increase-skip")
-# (action "image-scale")
+(action "image-scale" "<Primary><Alt>i")
 # (action "script-fu-set-cmap")
 # (action "channels-raise")
 # (action "filters-noise-hurl")
 # (action "context-brush-angle-maximum")
 # (action "context-colormap-foreground-set")
 # (action "image-convert-grayscale")
-(action "image-duplicate")
+(action "image-duplicate" "<Primary>j")
 # (action "dialogs-undo-history")
 # (action "select-feather")
 # (action "select-stroke-last-values")
@@ -507,7 +498,7 @@
 # (action "filters-color-enhance")
 # (action "tools-opacity-decrease" "less")
 # (action "tools-force-set-to-default")
-(action "context-brush-hardness-decrease-skip" "braceleft")
+# (action "context-brush-hardness-decrease-skip")
 # (action "edit-cut" "<Primary>x" "Cut")
 # (action "context-pattern-select-next")
 # (action "layers-mask-selection-add")
@@ -556,7 +547,7 @@
 # (action "tools-ink-blob-angle-set")
 # (action "context-tool-select-first")
 # (action "filters-erode")
-# (action "edit-fill-bg" "<Primary>period")
+(action "edit-fill-bg" "<Alt>BackSpace")
 # (action "image-print-size")
 # (action "context-foreground-green-minimum")
 # (action "filters-gegl-color-warp")
@@ -564,7 +555,7 @@
 # (action "tools-handle-transform" "<Shift>l")
 # (action "filters-gaussian-blur")
 # (action "context-colormap-background-previous")
-# (action "image-merge-layers" "<Primary>m")
+(action "image-merge-layers" "<Primary>e")
 # (action "filters-high-pass")
 (action "tools-move" "v")
 # (action "context-pattern-select-previous")
@@ -594,7 +585,7 @@
 # (action "context-foreground-blue-decrease-skip")
 # (action "context-foreground-blue-set")
 # (action "tools-angle-decrease")
-(action "context-brush-radius-decrease" "bracketleft")
+# (action "context-brush-radius-decrease")
 # (action "tools-object-1-previous")
 # (action "paths-export")
 # (action "plug-in-animationoptimize-diff")
@@ -627,7 +618,7 @@
 # (action "filters-supernova")
 # (action "view-scroll-page-up")
 # (action "context-background-saturation-increase-skip")
-# (action "tools-hardness-increase-skip")
+(action "tools-hardness-increase-skip"  "braceright")
 # (action "filters-focus-blur")
 (action "tools-eraser" "e")
 # (action "dialogs-preferences")
@@ -669,7 +660,6 @@
 # (action "plug-in-compose")
 # (action "filters-panorama-projection")
 # (action "layers-mask-delete")
-# (action "test-import-plug-ins")
 # (action "filters-gegl-graph")
 # (action "layers-composite-mode-auto")
 # (action "filters-recent-01")
@@ -707,10 +697,9 @@
 # (action "edit-strong-undo" "<Primary><Shift>z")
 # (action "layers-merge-down")
 # (action "gimp-help-using-web")
-# (action "filters-gegl-voronoi-diagram")
+# (action "image-convert-linear")
 (action "tools-airbrush")
 # (action "filters-recent-07")
-# (action "image-convert-linear")
 # (action "plug-in-spheredesigner")
 # (action "script-fu-blend-anim")
 # (action "layers-new-from-visible")
@@ -733,7 +722,7 @@
 # (action "context-brush-shape-diamond")
 # (action "tools-threshold")
 # (action "plug-in-despeckle")
-# (action "filters-gegl-connected-components")
+# (action "filters-gegl-bevel")
 # (action "dialogs-palettes")
 # (action "filters-polar-coordinates")
 # (action "filters-mean-curvature-blur")
@@ -743,7 +732,6 @@
 # (action "file-open-recent-02" "<Primary>2")
 # (action "paths-import")
 # (action "dialogs-input-devices")
-# (action "filters-gegl-bevel")
 # (action "channels-color-tag-orange")
 # (action "view-scroll-bottom-border")
 # (action "context-foreground-hue-decrease-skip")
@@ -789,11 +777,11 @@
 # (action "tools-angle-increase-skip")
 # (action "file-open-recent-09" "<Primary>9")
 # (action "tools-heal" "h")
-# (action "gimp-help-using-simpleobjects")
-# (action "filters-photocopy")
-# (action "tools-spacing-decrease")
-# (action "filters-channel-mixer")
 # (action "dialogs-cursor")
+# (action "gimp-help-using-simpleobjects")
+# (action "tools-spacing-decrease")
+# (action "filters-photocopy")
+# (action "filters-channel-mixer")
 # (action "file-pat-export-internal")
 # (action "layers-lock-position")
 # (action "plug-in-fractalexplorer")
@@ -803,7 +791,6 @@
 # (action "context-swatch-foreground-next-skip")
 # (action "paths-visible")
 # (action "channels-visible")
-# (action "filters-gegl-bilateral-filter-fast")
 # (action "select-sharpen")
 # (action "context-gradient-select-set")
 # (action "debug-dump-attached-data")
@@ -829,7 +816,6 @@
 # (action "dialogs-histogram")
 # (action "channels-select-bottom")
 # (action "filters-mantiuk-2006")
-# (action "filters-gegl-gradient-map")
 # (action "filters-gegl-color-assimilation-grid")
 # (action "tools-force-minimum")
 # (action "filters-tile-glass")
@@ -838,7 +824,6 @@
 # (action "filters-dilate")
 # (action "filters-invert-linear")
 # (action "context-palette-select-last")
-# (action "filters-gegl-paint-select")
 # (action "plug-in-decompose")
 # (action "filters-plasma")
 # (action "tools-aspect-decrease-skip")
@@ -849,18 +834,17 @@
 # (action "paths-selection-replace")
 # (action "view-display-intent-saturation")
 # (action "context-background-red-maximum")
-# (action "context-background-saturation-minimum")
 # (action "filters-gegl-negative-darkroom")
+# (action "context-background-saturation-minimum")
 # (action "select-cut-float" "<Primary><Shift>l")
 # (action "dialogs-buffers")
 (action "tools-color-picker" "i")
-# (action "tools-warp-effect-size-set")
 # (action "filters-gegl-inner-glow")
 # (action "context-foreground-value-maximum")
 # (action "filters-bayer-matrix")
 # (action "context-background-saturation-set")
+# (action "tools-warp-effect-size-set")
 # (action "tools-spacing-increase")
-# (action "filters-gegl-demosaic-bimedian")
 # (action "channels-color-tag-brown")
 # (action "view-show-sample-points")
 # (action "paths-stroke")
@@ -885,7 +869,7 @@
 # (action "context-brush-select-set")
 # (action "help-context-help" "<Shift>F1")
 # (action "tools-pencil" "n")
-(action "context-brush-hardness-increase-skip" "braceright")
+# (action "context-brush-hardness-increase-skip")
 # (action "filters-edge")
 # (action "tools-object-1-next")
 # (action "layers-opacity-decrease-skip")
@@ -955,7 +939,6 @@
 # (action "filters-stretch-contrast")
 # (action "plug-in-imagemap")
 # (action "filters-deinterlace")
-# (action "filters-gegl-demosaic-simple")
 # (action "context-brush-angle-decrease")
 # (action "filters-noise-hsv")
 # (action "tools-mypaint-brush-pixel-size-set")
@@ -1009,7 +992,7 @@
 # (action "layers-alpha-selection-subtract")
 # (action "tools-foreground-select-brush-size-set")
 # (action "filters-noise-solid")
-(action "tools-size-increase")
+# (action "tools-size-increase")
 # (action "dialogs-navigation")
 # (action "filters-color-balance")
 (action "tools-unified-transform")
@@ -1024,7 +1007,6 @@
 # (action "view-zoom-other")
 # (action "context-swatch-background-previous")
 # (action "context-foreground-value-decrease")
-# (action "filters-gegl-band-tune")
 # (action "filters-gegl-styles")
 # (action "context-foreground-red-set")
 # (action "filters-alien-map")
@@ -1063,7 +1045,6 @@
 # (action "plug-in-map-object")
 # (action "view-rotate-270")
 # (action "script-fu-slide")
-# (action "windows-display-0001")
 # (action "tools-hardness-increase-percent")
 # (action "context-brush-radius-increase-percent")
 # (action "script-fu-addborder")

.config/GIMP/3.0/theme.css

@@ -2,7 +2,7 @@
  *
  * This file is written on GIMP startup and on every theme change.
  * It is NOT supposed to be edited manually. Edit your personal
- * gimp.css file instead (/home/diolinux/.var/app/org.gimp.GIMP.Nightly/config/GIMP/3.0/gimp.css).
+ * gimp.css file instead (/home/diolinux/.var/app/org.gimp.GIMP/config/GIMP/3.0/gimp.css).
  */
 
 @import url("file:///app/share/gimp/3.0/themes/Default/gimp-dark.css");

.config/GIMP/3.0/tool-options/gimp-airbrush-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-airbrush-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-bucket-fill-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-bucket-fill-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (pattern "Starfield")
 (brush-size 51)
 (brush-hardness 0.5)

.config/GIMP/3.0/tool-options/gimp-clone-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-clone-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-color-picker-tool

@@ -0,0 +1,4 @@
+# GIMP gimp-color-picker-tool options
+
+
+# end of gimp-color-picker-tool options

.config/GIMP/3.0/tool-options/gimp-convolve-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-convolve-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-crop-tool

@@ -2,8 +2,6 @@
 
 (aspect-denominator 1080)
 (aspect-numerator 1920)
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (pattern "Starfield")
 
 # end of gimp-crop-tool options

.config/GIMP/3.0/tool-options/gimp-dodge-burn-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-dodge-burn-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (palette "Standard")

.config/GIMP/3.0/tool-options/gimp-eraser-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-eraser-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (palette "Standard")

.config/GIMP/3.0/tool-options/gimp-foreground-select-tool

@@ -1,6 +1,4 @@
 # GIMP gimp-foreground-select-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 
 # end of gimp-foreground-select-tool options

.config/GIMP/3.0/tool-options/gimp-gradient-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-gradient-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (gradient "Skyline")
 (brush-size 51)
 (brush-hardness 0.5)

.config/GIMP/3.0/tool-options/gimp-heal-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-heal-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-ink-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-ink-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (pattern "Starfield")
 (brush-size 51)
 (brush-hardness 0.5)

.config/GIMP/3.0/tool-options/gimp-mypaint-brush-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-mypaint-brush-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (mybrush "100% Opaque")
 (pattern "Starfield")
 (brush-size 51)

.config/GIMP/3.0/tool-options/gimp-operation-tool

@@ -0,0 +1,4 @@
+# GIMP gimp-operation-tool options
+
+
+# end of gimp-operation-tool options

.config/GIMP/3.0/tool-options/gimp-paintbrush-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-paintbrush-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-pencil-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-pencil-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-perspective-clone-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-perspective-clone-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-smudge-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-smudge-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.config/GIMP/3.0/tool-options/gimp-text-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-text-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (palette "Standard")
 (font "Sans-serif")
 

.config/GIMP/3.0/tool-options/gimp-vector-tool

@@ -1,7 +1,5 @@
 # GIMP gimp-vector-tool options
 
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
 (brush "2. Hardness 050")
 (dynamics "Pressure Size")
 (pattern "Starfield")

.gitignore

@@ -7,3 +7,30 @@
 
 # VSCode Files
 .vscode/*
+
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk

.local/share/applications/org.gimp.GIMP.desktop

@@ -138,7 +138,7 @@ Comment[zh_CN]=创建图像或编辑照片
 Comment[zh_HK]=建立圖像與編輯照片
 Comment[zh_TW]=建立圖像與編輯照片
 Icon=photogimp
-Exec=/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=gimp-2.10 --file-forwarding org.gimp.GIMP @@u %U @@
+Exec=/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=gimp --file-forwarding org.gimp.GIMP @@u %U @@
 Actions=
 MimeType=image/bmp;image/g3fax;image/gif;image/x-fits;image/x-pcx;image/x-portable-anymap;image/x-portable-bitmap;image/x-portable-graymap;image/x-portable-pixmap;image/x-psd;image/x-sgi;image/x-tga;image/x-xbitmap;image/x-xwindowdump;image/x-xcf;image/x-compressed-xcf;image/x-gimp-gbr;image/x-gimp-pat;image/x-gimp-gih;image/tiff;image/jpeg;image/x-psp;application/postscript;image/png;image/x-icon;image/x-xpixmap;image/x-exr;image/x-webp;image/heif;image/heic;image/svg+xml;application/pdf;image/x-wmf;image/jp2;image/x-xcursor;
 Categories=2DGraphics;GTK;Graphics;RasterGraphics;
@@ -176,3 +176,4 @@ Keywords[tr]=GIMP;PhotoGIMP;grafik;tasarım;örnekleme;boyama;illüstrasyon;resi
 Keywords[uk]=GIMP;PhotoGIMP;graphic;design;illustration;painting;гімп;ґімп;графіка;дизайн;ілюстрації;малювання;
 Keywords[zh_CN]=GIMP;PhotoGIMP;图形;设计;绘画;graphic;design;illustration;painting;
 StartupNotify=true
+StartupWMClass=gimp-3.0

.var/app/org.gimp.GIMP/config/GIMP/3.0/tool-options/gimp-color-picker-tool

@@ -1,6 +0,0 @@
-# GIMP gimp-color-picker-tool options
-
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
-
-# end of gimp-color-picker-tool options

.var/app/org.gimp.GIMP/config/GIMP/3.0/tool-options/gimp-operation-tool

@@ -1,6 +0,0 @@
-# GIMP gimp-operation-tool options
-
-(foreground
-    (color "HSVA float" 16 "\0\0\0\0d\22P\77\134\354y\77\0\0\200\77" 0))
-
-# end of gimp-operation-tool options

README.md

@@ -1,100 +1,322 @@
 # 🎨 PhotoGIMP
 
-<img src="./.local/share/icons/hicolor/256x256/apps/photogimp.png" align="right" alt="PhotoGimp application icon" title="PhotoGimp application icon">
+<img src="./.local/share/icons/hicolor/256x256/256x256.png" align="right" alt="PhotoGIMP application icon" title="PhotoGIMP application icon">
 
-A patch for optimizing GIMP 3.0+ for Adobe Photoshop users, including features like:
+[![GitHub stars](https://img.shields.io/github/stars/Diolinux/PhotoGIMP?style=social)](https://github.com/Diolinux/PhotoGIMP)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Latest Release](https://img.shields.io/github/v/release/Diolinux/PhotoGIMP)](https://github.com/Diolinux/PhotoGIMP/releases/latest)
 
-* Tool organization to mimic the position of Adobe Photoshop;
-* New Python filters installed by default, such as "heal selection";
-* New Splash Screen
-* New default settings to maximize space on the canvas;
-* Shortcuts similar to the ones in Photoshop for Windows, following Adobe’s Documentation;
-* New icon and Name from custom .desktop file.
-* System Language is now used by default, you can still change in settings if you want.
+**PhotoGIMP** is a free, community-driven patch that transforms [GIMP](https://www.gimp.org/) (GNU Image Manipulation Program) into a layout that feels familiar to **Adobe Photoshop** users. If you're switching from Photoshop to GIMP and want to feel at home right away, PhotoGIMP is for you.
 
-![PhotoGimp Diolinux Splash Art](./.var/app/org.gimp.GIMP/config/GIMP/3.0/splashes/splash-screen-2025-v2.png)
+> **New to GIMP?** GIMP is a free and open-source image editor available for Linux, macOS, and Windows. It can do most things Photoshop can — photo retouching, image composition, graphic design, and more — all for free. PhotoGIMP just makes it *look and feel* more like Photoshop.
+
+---
+
+## ✨ Features
+
+- **Photoshop-like tool layout** — Tools are reorganized to mimic the positions you're used to in Adobe Photoshop.
+- **Custom Splash Screen** — A unique PhotoGIMP splash screen greets you on startup.
+- **Maximized canvas space** — Default settings are optimized to give you the largest possible working area.
+- **Photoshop keyboard shortcuts** — Keyboard shortcuts follow [Adobe's official documentation](https://helpx.adobe.com/photoshop/using/default-keyboard-shortcuts.html) for the Windows version.
+- **Custom icon & name** — A dedicated `.desktop` file gives PhotoGIMP its own icon and app name in your system menu.
+
+---
 
 ## 📷 Screenshots
 
-![PhotoGimp 3](./screenshots/photogimp_3_-_diolinux.png)
+<p>
+  <img src="./.config/GIMP/3.0/splashes/splash-screen-2025-v2.png" alt="PhotoGIMP Diolinux Splash Art">
+  <em>PhotoGIMP Diolinux Splash Art</em>
+</p>
 
-## ⚙ How to Install (using Flatpak)
+<p>
+  <img src="./screenshots/photogimp_3_-_diolinux.png" alt="PhotoGIMP 3">
+  <em>GIMP 3.0 with the PhotoGIMP patch applied</em>
+</p>
 
-This package is all about flatpak, but it also contains "just files" that you can use on any version of GIMP (.deb, .rpm, Snap, AppImage, Windows, macOS). Just check the location of the GIMP configuration files.
+---
 
-**Start and quit GIMP after you installed before you continue!**
+## 📋 Requirements
 
-### Prepare the Flatpak environment
+Before installing PhotoGIMP, make sure you have:
 
-*If you have previously had GIMP installed via .deb, .rpm, etc., please ensure you delete the directory `$HOME/.config/GIMP`, as this may cause conflicts with the Flatpak config files.*
+| Requirement | Details |
+|---|---|
+| **GIMP 3.0 or newer** | Download from: [gimp.org](https://www.gimp.org/downloads/) or [Flathub](https://flathub.org/apps/org.gimp.GIMP) (Linux) |
+| **Run GIMP at least once** | GIMP needs to generate its config files before PhotoGIMP can overwrite them. **Install GIMP → open it → close it → then install PhotoGIMP.** |
 
-1. First of all, you need to have the latest GIMP installed on your system [using Flatpak](https://flatpak.org/setup/)
-2. Install GIMP Flatpak through your AppCenter/Package Manager or terminal:
-   ```flatpak install flathub org.gimp.GIMP```
+---
 
-### Install PhotoGIMP
+## ⚙ How to Install
 
-Inside the .zip file from the [releases page](https://github.com/Diolinux/PhotoGIMP/releases) you’ll find three folders (hidden on non-Windows systems as their names begin with a dot). All of these folders have to be extracted to your `$HOME` folder, overwriting everything if you already have the same files from an older installation.
+> [!WARNING]
+> **Back up your current GIMP settings before installing!** PhotoGIMP overwrites GIMP's configuration files. If you have custom settings you want to keep, save a backup copy first. See the backup instructions in each section below.
 
-The file contains these directories:
+---
 
-* `.icons` (which has a new PhotoGIMP icon)
-* `.local` (which contains the personalized .desktop file)
-* `.var` (which contains the flatpak patch customization for GIMP 2.10+)
+### 🐧 Flatpak (Linux)
 
-If you just want the PhotoGIMP customization without changing the original GIMP icon and its name, just extract only the ```.var``` folder to your home directory.
+<img src="https://skillicons.dev/icons?i=linux" align="right" width="40" />
 
-## ⚙ How to Install (others)
+#### Backup (optional)
 
-Since it’s just files, the only thing you need to do is to copy all the files that reside on a particular folder from this package `/.var/app/org.gimp.GIMP/config/GIMP/3.0` to your GIMP’s configuration folder on each particular system, overriding the existent ones.
-
-**Start and quit GIMP after you installed before you continue!**
-
-The new icon needs to be set manually.
-
-### Ubuntu Snap
-
-Configuration folder: `$HOME/snap/gimp/47/.config/GIMP/3.10/`
-
-### Other Linux or Unix(-like) systems (.deb, .rpm, etc.)
-
-Configuration folder: `$HOME/.config/GIMP/3.10/`
-
-### macOS
-
-Configuration folder: `"$HOME/Library/Application Support/GIMP/3.10/"`
-
-* [Video Tutorial by Davies Media Design on macOS](https://youtu.be/5nXhtaGQs9U)
-
-##### Run bash how to
-
-you can [down](https://raw.githubusercontent.com/MatthijsKamstra/Mac-setup/master/install/photogimp_osx.sh) and run the bash script:
+If you want to keep your current GIMP settings, back them up first:
 
 ```bash
-cd /path/to/download/folder
-sh photogimp_osx.sh
+cp -r ~/.config/GIMP/3.0 ~/GIMP-3.0-backup
 ```
 
-##### Run script (the easy way)
+#### Install
 
+1. Make sure you already have GIMP installed [from Flathub](https://flathub.org/apps/org.gimp.GIMP).
+2. **Open GIMP once, then close it** — this creates the config folders that PhotoGIMP needs.
+3. Download the latest release:
+   👉 **[Download PhotoGIMP for Linux (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP-linux.zip)**
+4. Extract the `.zip` file **into your home folder** (`~`).
+   - This will place files into `~/.config` and `~/.local`, which are hidden folders.
+   - To see hidden folders in your file manager, press <kbd>Ctrl</kbd> + <kbd>H</kbd>.
+   - When prompted about existing files, choose **"Replace"** or **"Overwrite"**.
+5. Open GIMP — you should see the new PhotoGIMP layout! 🎉
+
+<details>
+<summary><strong>💡 Using a non-Flatpak GIMP?</strong></summary>
+
+If you installed GIMP from your distro's package manager (apt, dnf, pacman, etc.) instead of Flatpak, the config folder is in the same location (`~/.config/GIMP/3.0`), so the steps above still work. Just make sure you have GIMP version 3.0 or newer.
+</details>
+
+---
+
+### 🪟 Windows
+
+<img src="https://skillicons.dev/icons?i=windows" align="right" />
+
+#### Backup (optional)
+
+If you want to keep your current GIMP settings, back them up first:
+
+1. Press <kbd>Windows</kbd> + <kbd>R</kbd> to open the Run dialog.
+2. Type `%APPDATA%\GIMP` and press <kbd>Enter</kbd>.
+3. Copy the entire `3.0` folder to a safe location (e.g., your Desktop).
+
+#### Install
+
+1. Make sure you have [GIMP installed from the official website](https://www.gimp.org/downloads/).
+2. **Open GIMP once, then close it** — this creates the config folders that PhotoGIMP needs.
+3. Download the latest release:
+   👉 **[Download PhotoGIMP for Windows (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Extract the contents of `PhotoGIMP.zip` to any folder (e.g., your Desktop).
+5. Open the extracted folder and **copy the `3.0` folder**.
+6. Press <kbd>Windows</kbd> + <kbd>R</kbd> to open the Run dialog.
+7. Type `%APPDATA%\GIMP` and press <kbd>Enter</kbd> — this opens GIMP's settings folder.
+8. **Paste** the `3.0` folder here.
+9. When prompted about existing files, select **"Replace the files in the destination"**.
+10. Open GIMP — you should see the new PhotoGIMP layout! 🎉
+
+<details>
+<summary><strong>💡 Optional: Change the GIMP shortcut icon</strong></summary>
+
+You can also download [photogimp.ico](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/photogimp.ico) and update the icon on the GIMP shortcut located at:
+
+```
+%appdata%\Microsoft\Windows\Start Menu\Programs\GIMP 3.0.0
+```
+
+Right-click the shortcut → **Properties** → **Change Icon** → browse to the downloaded `.ico` file.
+</details>
+
+<details>
+<summary><strong>🍫 Install via Chocolatey (alternative)</strong></summary>
+
+If you use [Chocolatey](https://chocolatey.org/), you can install PhotoGIMP with a single command:
+
+```powershell
+choco install photogimp
+```
+
+Maintained by: [André Augusto](https://github.com/AndreAugustoDev)
+</details>
+
+---
+
+:bulb: Tips:
+- Optionally, you can also download the [photogimp.ico](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/photogimp.ico) and update the icon for the GIMP 3.x.x shortcut in `%appdata%\Microsoft\Windows\Start Menu\Programs\`. On Windows 11 the path will likely be `C:\ProgramData\Microsoft\Windows\Start Menu\Programs\` instead;
+
+- If you want to backup your current GIMP settings before installing PhotoGIMP, copy the entire `3.0` folder from `%APPDATA%\GIMP` to a safe location before proceeding with the installation.
+
+### 🍎 macOS
+
+<img src="https://skillicons.dev/icons?i=macos" align="right" />
+
+#### Backup (optional)
+
+If you want to keep your current GIMP settings, back them up first:
+
+1. Open Finder.
+2. Press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> and go to `~/Library/Application Support/GIMP`.
+3. Copy the entire `GIMP` folder to a safe location (e.g., your Desktop).
+
+#### Install
+
+1. Make sure you have [GIMP installed from the official website](https://www.gimp.org/downloads/).
+2. **Open GIMP once, then close it** — this creates the config folders that PhotoGIMP needs.
+3. Download the latest release:
+   👉 **[Download PhotoGIMP for macOS (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Extract the contents of `PhotoGIMP.zip` to any folder (e.g., your Desktop).
+5. Open the extracted folder and **copy the `3.0` folder**.
+6. Open Finder, press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> to open "Go to Folder".
+7. Type `~/Library/Application Support/GIMP` and press <kbd>Enter</kbd>.
+8. If you see a `2.10` folder from a previous installation, **delete it** to avoid conflicts.
+9. **Paste** the `3.0` folder inside the GIMP folder.
+10. When prompted about existing files, select **"Replace"** or **"Merge"**.
+11. Open GIMP — you should see the new PhotoGIMP layout! 🎉
+
+---
+
+## 📦 What's Inside the Patch
+
+PhotoGIMP replaces or adds the following files in GIMP's configuration directory:
+
+| File / Folder | What it does |
+|---|---|
+| `shortcutsrc` | Keyboard shortcuts mapped to match Photoshop |
+| `toolrc` | Tool configuration and ordering |
+| `sessionrc` | Window layout and panel positions |
+| `dockrc` | Dock / panel configuration |
+| `gimprc` | General GIMP preferences (canvas, grid, etc.) |
+| `contextrc` | Active tool/color context settings |
+| `splashes/` | Custom PhotoGIMP splash screen |
+| `theme.css` | Minor UI theme adjustments |
+| `templaterc` | Pre-defined canvas templates |
+
+On Linux, the patch also installs:
+- A custom `.desktop` file (app launcher with PhotoGIMP name and icon)
+- A custom application icon in `~/.local/share/icons/`
+
+---
+
+## 🗑 How to Uninstall
+
+To remove PhotoGIMP and restore GIMP to its default state, simply delete GIMP's config folder and reopen GIMP — it will regenerate fresh default settings.
+
+### Linux
 
 ```bash
-sh -c "$(curl -fsSL https://raw.githubusercontent.com/MatthijsKamstra/Mac-setup/master/install/photogimp_osx.sh)"
+rm -rf ~/.config/GIMP/3.0
+```
+
+Then open GIMP again — it will create a brand new default configuration.
+
+If you made a backup earlier, restore it instead:
+
+```bash
+cp -r ~/GIMP-3.0-backup ~/.config/GIMP/3.0
 ```
 
 ### Windows
 
-* Download the file [PhotoGIMP.zip](https://github.com/Diolinux/PhotoGIMP/releases)
-* Access the path `.var\app\org.gimp.GIMP\config\GIMP\3.0` from the ZIP, copy the files to the path `%APPDATA%\GIMP\3.0`
-* [Video Tutorial by Davies Media Design on Windows](https://youtu.be/57DNUsf4A-0)
+1. Press <kbd>Windows</kbd> + <kbd>R</kbd>, type `%APPDATA%\GIMP` and press <kbd>Enter</kbd>.
+2. Delete the `3.0` folder.
+3. Open GIMP — it will recreate the default settings.
 
-## Credits
+Or restore your backup by pasting the backed-up `3.0` folder back.
 
-* This project would not be possible without the amazing GIMP team.
-* The Photo in the new Splash is from [Isabella Mariana](https://www.pexels.com/pt-br/@isabella-mariana-1022505)
-* A BIG thanks to all Diolinux’s supporters on [Twitch](https://twitch.tv/Diolinux) and [YouTube](https://youtube.com/Diolinux).
+### macOS
+
+1. Open Finder, press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd>.
+2. Go to `~/Library/Application Support/GIMP`.
+3. Delete the `3.0` folder.
+4. Open GIMP — it will recreate the default settings.
+
+Or restore your backup by pasting the backed-up folder back.
+
+---
+
+## ❓ Troubleshooting / FAQ
+
+> [!CAUTION]
+> **PhotoGIMP does not have an official website.** The only official source for the project is its GitHub repository: https://github.com/Diolinux/PhotoGIMP/
+
+<details>
+<summary><strong>PhotoGIMP didn't change anything — GIMP looks the same</strong></summary>
+
+- Make sure you extracted the files to the **correct location**. The most common mistake is extracting to the wrong folder.
+- **Linux**: The `.config` and `.local` folders must be in your home directory (`~`). They are hidden — press <kbd>Ctrl</kbd> + <kbd>H</kbd> in your file manager to see them.
+- **Windows**: The `3.0` folder must be inside `%APPDATA%\GIMP`, not next to it.
+- **macOS**: The `3.0` folder must be inside `~/Library/Application Support/GIMP`.
+- Did you **close GIMP** before pasting the files? GIMP may overwrite incoming settings on exit.
+</details>
+
+<details>
+<summary><strong>I get an error when opening GIMP after installing PhotoGIMP</strong></summary>
+
+- This usually means the GIMP version doesn't match. PhotoGIMP is built for **GIMP 3.0+**. If you're running GIMP 2.x, it won't be compatible.
+- Try deleting the config folder and reinstalling — see the [How to Uninstall](#-how-to-uninstall) section.
+</details>
+
+<details>
+<summary><strong>Can I use PhotoGIMP with GIMP 2.10?</strong></summary>
+
+No. This version of PhotoGIMP is designed exclusively for **GIMP 3.0 and newer**. The configuration format changed significantly between GIMP 2.x and 3.x.
+</details>
+
+<details>
+<summary><strong>Will PhotoGIMP delete my custom brushes, fonts, or plug-ins?</strong></summary>
+
+No. PhotoGIMP only replaces configuration files (shortcuts, layout, preferences). Your personal brushes, fonts, gradients, and plug-ins remain untouched.
+</details>
+
+<details>
+<summary><strong>Can I customize the shortcuts after installing PhotoGIMP?</strong></summary>
+
+Absolutely! PhotoGIMP just sets a starting point. You can change any shortcut in GIMP via **Edit → Keyboard Shortcuts**.
+</details>
+
+<details>
+<summary><strong>How do I update PhotoGIMP to a new version?</strong></summary>
+
+Just download the latest release and follow the installation steps again — it will overwrite the previous PhotoGIMP configuration.
+</details>
+
+---
+
+## 🤝 Contributing
+
+Found a bug? Have a suggestion? We'd love your help!
+
+- **Report an issue**: [Open an issue](https://github.com/Diolinux/PhotoGIMP/issues)
+- **Submit a fix**: [Create a pull request](https://github.com/Diolinux/PhotoGIMP/pulls)
+- **Translate**: Help us translate the README into more languages! See the [Translations](#-translations) section.
+
+---
+
+## 🌍 Translations
+
+This README is available in other languages:
+
+- 🇧🇷 [Português (Brazilian Portuguese)](./docs/README_pt.md)
+- 🇵🇱 [Polski (Polish)](./docs/README_pl.md)
+- 🇷🇺 [Русский (Russian)](./docs/README_ru.md)
+
+Want to add your language? Fork the repo, create a `docs/README_xx.md` file, and submit a pull request!
+
+---
+
+## 🏆 Credits
+
+- This project would not be possible without the amazing [GIMP](https://www.gimp.org/) team.
+- A BIG thanks to all Diolinux's supporters on [YouTube](https://youtube.com/Diolinux).
+- Splash screen & icons from [Adriel Filipe Design](https://bento.me/adrielfilipedesign).
+
+---
+
+## 👥 Contributors
 
-## Contributors
 <a align="center" href="https://github.com/Diolinux/PhotoGIMP/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=Diolinux/PhotoGIMP" />
 </a>
+
+---
+
+## 📄 License
+
+PhotoGIMP is licensed under the [GNU General Public License v3.0](./LICENSE).

docs/README_pl.md

@@ -1,105 +1,313 @@
 # 🎨 PhotoGIMP
 
-<img src="../.local/share/icons/hicolor/256x256/apps/photogimp.png" align="right" alt="PhotoGimp application icon" title="PhotoGimp application icon">
+<img src="../.local/share/icons/hicolor/256x256/256x256.png" align="right" alt="Ikona aplikacji PhotoGIMP" title="Ikona aplikacji PhotoGIMP">
 
-Prosta modyfikacja do GIMP-a 2.10+, aby pomóc użytkownikom <span style="color: blue;">_Photoshop-a_.
-_Od Tłumacza: Oraz dla nowych użytkowników GIMP-a, którzy chcą się poczuć jak na Photoshop-ie_</span>
+[![GitHub stars](https://img.shields.io/github/stars/Diolinux/PhotoGIMP?style=social)](https://github.com/Diolinux/PhotoGIMP)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Latest Release](https://img.shields.io/github/v/release/Diolinux/PhotoGIMP)](https://github.com/Diolinux/PhotoGIMP/releases/latest)
 
-Co zostanie zmienione:
+**PhotoGIMP** to darmowa, utrzymywana przez społeczność modyfikacja, która przekształca [GIMP](https://www.gimp.org/) (GNU Image Manipulation Program) w układ znany użytkownikom **Adobe Photoshop**. Jeśli przechodzisz z Photoshopa na GIMP i chcesz od razu poczuć się jak w domu, PhotoGIMP jest dla Ciebie.
 
-*	Zmiana położenia narzędzi, podobna do Adobe Photoshop-a;
-*	Nowe domyślne filtry Python-a, takie jak "heal selection";
-*	Nowy Ekran Ładowania;
-*	Nowe domyślne ustawienia, zwiększające przestrzeń roboczą;
-*	Skróty klawiaturowe, przypominające z Photoshop-a, wzorowane na dokumentacji Adobe;
-*	Nowa ikona i nazwa dla dowolnego pliku .desktop ;
-*	Po instalacji, domyślnym językiem, będzie systemowy. Możesz to łatwo zmienić w ustawieniach
+> **Nowy w GIMP-ie?** GIMP to darmowy edytor graficzny o otwartym kodzie źródłowym, dostępny na Linuxa, macOS i Windows. Potrafi zrobić większość rzeczy, które robi Photoshop — retusz zdjęć, kompozycja obrazów, projektowanie graficzne i wiele więcej — wszystko za darmo. PhotoGIMP sprawia jedynie, że GIMP *wygląda i działa* bardziej jak Photoshop.
 
-![PhotoGimp Diolinux - nowy ekran ładowania](../.var/app/org.gimp.GIMP/config/GIMP/2.10/splashes/photogimp-diolinux-splash.png)
+---
 
+## ✨ Funkcje
 
-**📷 Zrzut Ekranu**
+- **Układ narzędzi w stylu Photoshopa** — Narzędzia są uporządkowane tak, aby naśladować pozycje znane z Adobe Photoshop.
+- **Własny ekran powitalny** — Unikalny ekran powitalny PhotoGIMP wita Cię przy każdym uruchomieniu.
+- **Zmaksymalizowana przestrzeń robocza** — Domyślne ustawienia są zoptymalizowane, aby zapewnić jak największy obszar roboczy.
+- **Skróty klawiaturowe z Photoshopa** — Skróty klawiaturowe zgodne z [oficjalną dokumentacją Adobe](https://helpx.adobe.com/photoshop/using/default-keyboard-shortcuts.html) dla wersji Windows.
+- **Własna ikona i nazwa** — Dedykowany plik `.desktop` nadaje PhotoGIMP własną ikonę i nazwę w menu systemowym.
 
-![Zrzut ekranu z PhotoGIMP - edytowany na Google Takeout](../screenshots/2020-06-22_12-06.png)
+---
 
-## ⚙ Jak zainstalować (używając Flatpak)
-Ta paczka dotyczy tylko flatpaka, ale można również jej użyć w innych wersjach GIMP-a (.deb, .rpm, Snap, AppImage, Windows, macOS). Sprawdź lokalizację konfiguracyjnych plików GIMP-a
+## 📷 Zrzuty Ekranu
 
-**Aby kontynuować, przed instalacją uruchom i zamknij GIMP-a**
+<p>
+  <img src="../.config/GIMP/3.0/splashes/splash-screen-2025-v2.png" alt="PhotoGIMP Diolinux Splash Art">
+  <em>PhotoGIMP Diolinux Splash Art</em>
+</p>
 
-### Przygotowanie do instalacji, z środowiska Flatpak
-*Jeśli miałeś, wcześniej zainstalowany GIMP, za pomocą .deb, .rpm itd., to upewnij się, że usunąłeś folder `$HOME/.config/GIMP`, ponieważ może to powodować problemy z plikami konfiguracji Flatpak*
-* Na początku, upewnij się że masz najnowszą wersję GIMP-a, [z Flatpak-a](https://flatpak.org/setup/)
-*   Zainstaluj GIMP-a [Flatpak] z centrum aplikacji/instalatora oprogramowania lub używając poniższego polecenia, w terminalu:
-```flatpak install flathub org.gimp.GIMP```
+<p>
+  <img src="../screenshots/photogimp_3_-_diolinux.png" alt="PhotoGIMP 3">
+  <em>GIMP 3.0 z zastosowanym patchem PhotoGIMP</em>
+</p>
 
-### Instalacja (PhotoGIMP)
+---
 
-W pliku ZIP z [strony nowych wydań (Releases)](https://github.com/Diolinux/PhotoGIMP/releases) znajdziesz trzy ukryte foldery (na wszystkich systemach, oprócz Windows-a, ponieważ użyto kropki przed nazwą folderu). Musisz rozpakować plik ZIP z wszystkimi folderami do swojego profilu użytkownika `$HOME`, <span style="color: red;">JUwaga, jeśli masz poprzednią wersję instalacji, musisz zgodzić się na nadpisanie wszystkich plików</span>
+## 📋 Wymagania
 
-Plik (ZIP) zawiera poniższe foldery:
+Przed zainstalowaniem PhotoGIMP, upewnij się, że masz:
 
-*  `.icons` (nowe ikony PhotoGimp)
-*  `.local` (modyfikacja wyglądu, dla pliku .desktop)
-*  `.var` (modyfikacja flatpak dla GIMP-a 2.10+)
+| Wymaganie | Szczegóły |
+|---|---|
+| **GIMP 3.0 lub nowszy** | Pobierz z: [gimp.org](https://www.gimp.org/downloads/) lub [Flathub](https://flathub.org/apps/org.gimp.GIMP) (Linux) |
+| **Uruchom GIMP co najmniej raz** | GIMP musi wygenerować swoje pliki konfiguracyjne zanim PhotoGIMP będzie mógł je nadpisać. **Zainstaluj GIMP → otwórz go → zamknij go → następnie zainstaluj PhotoGIMP.** |
 
+---
 
-Jeśli chcesz użyć PhotoGimp bez zmieniania ikon i nazwy, rozpakuj tylko folder .var do domyślnej lokalizacji GIMP-a.
+## ⚙ Jak Zainstalować
 
-## ⚙ Jak zainstalować (bez Flatpak)
+> [!WARNING]
+> **Zrób kopię zapasową obecnych ustawień GIMP-a przed instalacją!** PhotoGIMP nadpisuje pliki konfiguracyjne GIMP-a. Jeśli masz własne ustawienia, które chcesz zachować, najpierw zapisz ich kopię zapasową. Zobacz instrukcje tworzenia kopii zapasowej w każdej sekcji poniżej.
 
-Ponieważ są to tylko pliki, musisz skopiować je do określonego folderu z tego pakietu `/.var/app/org.gimp.GIMP/config/GIMP/2.10`, do folderu konfiguracyjnego GIMP-a w używanym systemie
+---
 
-**Aby kontynuować, przed instalacją uruchom i zamknij GIMP-a**
+### 🐧 Flatpak (Linux)
 
-Nowe ikony musisz ustawić ręcznie
+<img src="https://skillicons.dev/icons?i=linux" align="right" width="40" />
 
-### Ubuntu (przez Snap)
+#### Kopia zapasowa (opcjonalnie)
 
-Folder konfiguracyjny (GIMP-a): `$HOME/.config/GIMP/2.10/`
-
-
-### Pozostałe systemy Linux lub podobne do Unix, używające (.deb, .rpm, itd.)
-
-Folder Konfiguracyjny: `$HOME/.config/GIMP/2.10/`
-
-### macOS
-Folder konfiguracyjny: `"$HOME/Library/Application Support/GIMP/2.10/"`
-
-* [Poradnik Wideo stworzony przez Davies Media Design na macOS](https://youtu.be/5nXhtaGQs9U)
-
-Ta poniższa linijka zainstaluje wszystko, co potrzebujesz do działania programu:
-```console
-curl -L "https://github.com/Diolinux/PhotoGIMP/releases/download/1.0/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip" -o ~/Downloads/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip && unzip ~/Downloads/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip -d ~/Downloads && sudo cp -R ~/Downloads/PhotoGIMP\ by\ Diolinux\ v2020\ for\ Flatpak/.var/app/org.gimp.GIMP/config/GIMP/2.10/ ~/Library/Application\ Support/GIMP/2.10 && rm ~/Downloads/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip
-```
-(Pobierze wersję 1.0 do folderu `Downloads` lub do folderu `Pobrane`, rozpakuje i skopiuje zmodyfikowane pliki, a na końcu usunie wcześniej pobrany plik `.zip`)
-
-**Ważne** : GIMP na macOS jest troche spóżnioną wersją. Dlatego, ta modyfikacja działa w skrótach klawiszowych, ale nie, które opcję mogą nie działać, takie jak organizacje zestawu narzędzi. Trzeba poczekać, aż dla macOS będzie dostępna wersja 2.10.20, inaczej możesz spodziewać takich problemów.
-
-### Łatwy instalator, dla macOS (stworzony przez: [@MatthijsKamstra](https://github.com/MatthijsKamstra))
+Jeśli chcesz zachować obecne ustawienia GIMP-a, najpierw zrób kopię zapasową:
 
 ```bash
-sh -c "$(curl -fsSL https://raw.githubusercontent.com/MatthijsKamstra/Mac-setup/master/install/photogimp_osx.sh)"
+cp -r ~/.config/GIMP/3.0 ~/GIMP-3.0-backup
+```
+
+#### Instalacja
+
+1. Upewnij się, że masz już zainstalowany GIMP [z Flathub](https://flathub.org/apps/org.gimp.GIMP).
+2. **Otwórz GIMP-a raz, a następnie go zamknij** — to tworzy foldery konfiguracyjne potrzebne dla PhotoGIMP.
+3. Pobierz najnowszą wersję:
+   👉 **[Pobierz PhotoGIMP dla Linux (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP-linux.zip)**
+4. Rozpakuj plik `.zip` **do swojego folderu domowego** (`~`).
+   - Umieści to pliki w `~/.config` i `~/.local`, które są folderami ukrytymi.
+   - Aby zobaczyć ukryte foldery w menedżerze plików, naciśnij <kbd>Ctrl</kbd> + <kbd>H</kbd>.
+   - Gdy pojawi się pytanie o istniejące pliki, wybierz **"Zastąp"** lub **"Nadpisz"**.
+5. Otwórz GIMP — powinieneś zobaczyć nowy układ PhotoGIMP! 🎉
+
+<details>
+<summary><strong>💡 Używasz GIMP-a spoza Flatpak?</strong></summary>
+
+Jeśli zainstalowałeś GIMP-a z menedżera pakietów dystrybucji (apt, dnf, pacman, itp.) zamiast z Flatpaka, folder konfiguracyjny znajduje się w tym samym miejscu (`~/.config/GIMP/3.0`), więc powyższe kroki nadal działają. Upewnij się tylko, że masz GIMP w wersji 3.0 lub nowszej.
+</details>
+
+---
+
+### 🪟 Windows
+
+<img src="https://skillicons.dev/icons?i=windows" align="right" />
+
+#### Kopia zapasowa (opcjonalnie)
+
+Jeśli chcesz zachować obecne ustawienia GIMP-a, najpierw zrób kopię zapasową:
+
+1. Naciśnij <kbd>Windows</kbd> + <kbd>R</kbd>, aby otworzyć okno Uruchom.
+2. Wpisz `%APPDATA%\GIMP` i naciśnij <kbd>Enter</kbd>.
+3. Skopiuj cały folder `3.0` w bezpieczne miejsce (np. na Pulpit).
+
+#### Instalacja
+
+1. Upewnij się, że masz [GIMP zainstalowany ze strony oficjalnej](https://www.gimp.org/downloads/).
+2. **Otwórz GIMP-a raz, a następnie go zamknij** — to tworzy foldery konfiguracyjne potrzebne dla PhotoGIMP.
+3. Pobierz najnowszą wersję:
+   👉 **[Pobierz PhotoGIMP dla Windows (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Rozpakuj zawartość `PhotoGIMP.zip` do dowolnego folderu (np. na Pulpit).
+5. Otwórz rozpakowany folder i **skopiuj folder `3.0`**.
+6. Naciśnij <kbd>Windows</kbd> + <kbd>R</kbd>, aby otworzyć okno Uruchom.
+7. Wpisz `%APPDATA%\GIMP` i naciśnij <kbd>Enter</kbd> — to otworzy folder ustawień GIMP-a.
+8. **Wklej** folder `3.0` tutaj.
+9. Gdy pojawi się pytanie o istniejące pliki, wybierz **"Zastąp pliki w miejscu docelowym"**.
+10. Otwórz GIMP — powinieneś zobaczyć nowy układ PhotoGIMP! 🎉
+
+<details>
+<summary><strong>💡 Opcjonalnie: Zmień ikonę skrótu GIMP-a</strong></summary>
+
+Możesz również pobrać [photogimp.ico](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/photogimp.ico) i zaktualizować ikonę skrótu GIMP-a znajdującego się w:
+
+```
+%appdata%\Microsoft\Windows\Start Menu\Programs\GIMP 3.0.0
+```
+
+Kliknij prawym przyciskiem myszy na skrót → **Właściwości** → **Zmień ikonę** → wskaż pobrany plik `.ico`.
+</details>
+
+<details>
+<summary><strong>🍫 Instalacja przez Chocolatey (alternatywa)</strong></summary>
+
+Jeśli używasz [Chocolatey](https://chocolatey.org/), możesz zainstalować PhotoGIMP jednym poleceniem:
+
+```powershell
+choco install photogimp
+```
+
+Opiekun pakietu: [André Augusto](https://github.com/AndreAugustoDev)
+</details>
+
+---
+
+### 🍎 macOS
+
+<img src="https://skillicons.dev/icons?i=macos" align="right" />
+
+#### Kopia zapasowa (opcjonalnie)
+
+Jeśli chcesz zachować obecne ustawienia GIMP-a, najpierw zrób kopię zapasową:
+
+1. Otwórz Finder.
+2. Naciśnij <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> i przejdź do `~/Library/Application Support/GIMP`.
+3. Skopiuj cały folder `GIMP` w bezpieczne miejsce (np. na Pulpit).
+
+#### Instalacja
+
+1. Upewnij się, że masz [GIMP zainstalowany ze strony oficjalnej](https://www.gimp.org/downloads/).
+2. **Otwórz GIMP-a raz, a następnie go zamknij** — to tworzy foldery konfiguracyjne potrzebne dla PhotoGIMP.
+3. Pobierz najnowszą wersję:
+   👉 **[Pobierz PhotoGIMP dla macOS (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Rozpakuj zawartość `PhotoGIMP.zip` do dowolnego folderu (np. na Pulpit).
+5. Otwórz rozpakowany folder i **skopiuj folder `3.0`**.
+6. Otwórz Finder, naciśnij <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd>, aby otworzyć "Idź do folderu".
+7. Wpisz `~/Library/Application Support/GIMP` i naciśnij <kbd>Enter</kbd>.
+8. Jeśli masz folder `2.10` z poprzedniej instalacji, **usuń go**, aby uniknąć konfliktów.
+9. **Wklej** folder `3.0` do folderu GIMP.
+10. Gdy pojawi się pytanie o istniejące pliki, wybierz **"Zastąp"** lub **"Scal"**.
+11. Otwórz GIMP — powinieneś zobaczyć nowy układ PhotoGIMP! 🎉
+
+---
+
+## 📦 Co Zawiera Patch
+
+PhotoGIMP zastępuje lub dodaje następujące pliki w katalogu konfiguracyjnym GIMP-a:
+
+| Plik / Folder | Co robi |
+|---|---|
+| `shortcutsrc` | Skróty klawiaturowe zmapowane tak, aby odpowiadały Photoshopowi |
+| `toolrc` | Konfiguracja i kolejność narzędzi |
+| `sessionrc` | Układ okien i pozycje paneli |
+| `dockrc` | Konfiguracja doków / paneli |
+| `gimprc` | Ogólne preferencje GIMP-a (płótno, siatka, itp.) |
+| `contextrc` | Ustawienia aktywnego narzędzia/koloru |
+| `splashes/` | Własny ekran powitalny PhotoGIMP |
+| `theme.css` | Drobne korekty motywu interfejsu |
+| `templaterc` | Predefiniowane szablony płótna |
+
+Na Linuxie patch instaluje również:
+- Własny plik `.desktop` (launcher z nazwą i ikoną PhotoGIMP)
+- Własną ikonę aplikacji w `~/.local/share/icons/`
+
+---
+
+## 🗑 Jak Odinstalować
+
+Aby usunąć PhotoGIMP i przywrócić GIMP do stanu domyślnego, wystarczy usunąć folder konfiguracyjny GIMP-a i ponownie go otworzyć — wygeneruje on nowe domyślne ustawienia.
+
+### Linux
+
+```bash
+rm -rf ~/.config/GIMP/3.0
+```
+
+Następnie otwórz GIMP ponownie — utworzy on nową domyślną konfigurację.
+
+Jeśli wcześniej zrobiłeś kopię zapasową, przywróć ją:
+
+```bash
+cp -r ~/GIMP-3.0-backup ~/.config/GIMP/3.0
 ```
 
 ### Windows
 
-Folder Konfiguracyjny: `%APPDATA%\GIMP\2.10`
+1. Naciśnij <kbd>Windows</kbd> + <kbd>R</kbd>, wpisz `%APPDATA%\GIMP` i naciśnij <kbd>Enter</kbd>.
+2. Usuń folder `3.0`.
+3. Otwórz GIMP — odtworzy on domyślne ustawienia.
 
-* [Poradnik Wideo, stworzony przez Davies Media Design, dla Windows-a](https://youtu.be/57DNUsf4A-0)
+Lub przywróć kopię zapasową, wklejając folder `3.0` z powrotem.
 
-Lub zainstaluj przez [Chocolatey](https://chocolatey.org/):
-```powershell
-choco install photogimp
-```
-Prowadzone przez: [André Augusto](https://github.com/AndreAugustoAAQ)
+### macOS
 
-## Podziękowania
+1. Otwórz Finder, naciśnij <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd>.
+2. Przejdź do `~/Library/Application Support/GIMP`.
+3. Usuń folder `3.0`.
+4. Otwórz GIMP — odtworzy on domyślne ustawienia.
 
-* Projekt, nie mógłby być nigdy zrealizowany, bez świetnego zespołu GIMP-a.
-* Za zrobienie nowego zdjęcia do Ekranu Ładowania dla [Isabella Mariana](https://www.pexels.com/pt-br/@isabella-mariana-1022505)
-* Specjalne podziękowania do wszystkich pomocników Diolinux's na [Twitch-u](https://twitch.tv/Diolinux) i na [YouTube](https://youtube.com/Diolinux).
+Lub przywróć kopię zapasową, wklejając folder z powrotem.
 
-## Lista Zmian
-- [w języku, brazylijsko portugalskim]( https://diolinux.com.br/2020/06/photogimp-2020.html)
-- [Veja as Notas de Lançamento em Português](https://diolinux.com.br/2020/06/photogimp-2020.html)
+---
+
+## ❓ Rozwiązywanie Problemów / FAQ
+
+<details>
+<summary><strong>PhotoGIMP nic nie zmienił — GIMP wygląda tak samo</strong></summary>
+
+- Upewnij się, że rozpakowałeś pliki we **właściwym miejscu**. Najczęstszym błędem jest rozpakowanie do złego folderu.
+- **Linux**: Foldery `.config` i `.local` muszą znajdować się w Twoim katalogu domowym (`~`). Są one ukryte — naciśnij <kbd>Ctrl</kbd> + <kbd>H</kbd> w menedżerze plików, aby je zobaczyć.
+- **Windows**: Folder `3.0` musi znajdować się **wewnątrz** `%APPDATA%\GIMP`, nie obok niego.
+- **macOS**: Folder `3.0` musi znajdować się **wewnątrz** `~/Library/Application Support/GIMP`.
+- Czy **zamknąłeś GIMP-a** przed wklejeniem plików? GIMP może nadpisać przychodzące ustawienia przy zamykaniu.
+</details>
+
+<details>
+<summary><strong>Otrzymuję błąd po otwarciu GIMP-a po zainstalowaniu PhotoGIMP</strong></summary>
+
+- To zwykle oznacza, że wersja GIMP-a nie pasuje. PhotoGIMP jest przeznaczony dla **GIMP 3.0+**. Jeśli używasz GIMP 2.x, nie będzie kompatybilny.
+- Spróbuj usunąć folder konfiguracyjny i zainstalować ponownie — zobacz sekcję [Jak Odinstalować](#-jak-odinstalować).
+</details>
+
+<details>
+<summary><strong>Czy mogę używać PhotoGIMP z GIMP 2.10?</strong></summary>
+
+Nie. Ta wersja PhotoGIMP została zaprojektowana wyłącznie dla **GIMP 3.0 i nowszego**. Format konfiguracji zmienił się znacząco między GIMP 2.x a 3.x.
+</details>
+
+<details>
+<summary><strong>Czy PhotoGIMP usunie moje własne pędzle, czcionki lub wtyczki?</strong></summary>
+
+Nie. PhotoGIMP zastępuje jedynie pliki konfiguracyjne (skróty, układ, preferencje). Twoje osobiste pędzle, czcionki, gradienty i wtyczki pozostają nietknięte.
+</details>
+
+<details>
+<summary><strong>Czy mogę dostosować skróty po zainstalowaniu PhotoGIMP?</strong></summary>
+
+Oczywiście! PhotoGIMP ustawia jedynie punkt wyjścia. Możesz zmienić dowolny skrót w GIMP-ie przez **Edycja → Skróty klawiaturowe**.
+</details>
+
+<details>
+<summary><strong>Jak zaktualizować PhotoGIMP do nowej wersji?</strong></summary>
+
+Wystarczy pobrać najnowszą wersję i ponownie wykonać kroki instalacji — nadpisze to poprzednią konfigurację PhotoGIMP.
+</details>
+
+---
+
+## 🤝 Współpraca
+
+Znalazłeś błąd? Masz sugestię? Chętnie przyjmiemy Twoją pomoc!
+
+- **Zgłoś problem**: [Otwórz issue](https://github.com/Diolinux/PhotoGIMP/issues)
+- **Wyślij poprawkę**: [Utwórz pull request](https://github.com/Diolinux/PhotoGIMP/pulls)
+- **Tłumacz**: Pomóż nam przetłumaczyć README na więcej języków! Zobacz sekcję [Tłumaczenia](#-tłumaczenia).
+
+---
+
+## 🌍 Tłumaczenia
+
+Ten README jest dostępny w innych językach:
+
+- 🇬🇧 [English (Angielski)](../README.md)
+- 🇧🇷 [Português (Portugalski)](./README_pt.md)
+
+Chcesz dodać swój język? Zrób fork repozytorium, utwórz plik `docs/README_xx.md` i wyślij pull request!
+
+---
+
+## 🏆 Podziękowania
+
+- Ten projekt nie byłby możliwy bez wspaniałego zespołu [GIMP-a](https://www.gimp.org/).
+- Wielkie podziękowania dla wszystkich wspierających Diolinux na [YouTube](https://youtube.com/Diolinux).
+- Ekran powitalny i ikony od [Adriel Filipe Design](https://bento.me/adrielfilipedesign).
+
+---
+
+## 👥 Współtwórcy
+
+<a align="center" href="https://github.com/Diolinux/PhotoGIMP/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Diolinux/PhotoGIMP" />
+</a>
+
+---
+
+## 📄 Licencja
+
+PhotoGIMP jest objęty licencją [GNU General Public License v3.0](../LICENSE).

docs/README_pt.md

@@ -1,101 +1,313 @@
 # 🎨 PhotoGIMP
 
-<img src="../.local/share/icons/hicolor/256x256/apps/photogimp.png" align="right" alt="PhotoGimp application icon" title="PhotoGimp application icon">
+<img src="../.local/share/icons/hicolor/256x256/256x256.png" align="right" alt="Ícone do PhotoGIMP" title="Ícone do PhotoGIMP">
 
-Um patch para otimizar o GIMP 2.10+ para usuários do Adobe Photoshop, incluindo recursos como:
+[![GitHub stars](https://img.shields.io/github/stars/Diolinux/PhotoGIMP?style=social)](https://github.com/Diolinux/PhotoGIMP)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Latest Release](https://img.shields.io/github/v/release/Diolinux/PhotoGIMP)](https://github.com/Diolinux/PhotoGIMP/releases/latest)
 
-* Organização de ferramentas para imitar a posição do Adobe Photoshop;
-* Centenas de novas fontes por padrão;
-* Novos filtros Python instalados por padrão, como "heal selection";
-* Nova tela inicial;
-* Novas configurações padrão para maximizar o espaço na tela;
-* Atalhos semelhantes aos do Photoshop para Windows, seguindo a Documentação da Adobe;
-* Novo ícone e nome do arquivo .desktop personalizado;
-* O idioma do sistema agora é usado por padrão, você ainda pode alterar isso nas configurações, se desejar.
+**PhotoGIMP** é um patch gratuito e mantido pela comunidade que transforma o [GIMP](https://www.gimp.org/) (GNU Image Manipulation Program) em um layout familiar para usuários do **Adobe Photoshop**. Se você está migrando do Photoshop para o GIMP e quer se sentir em casa imediatamente, o PhotoGIMP é para você.
 
-![PhotoGimp Diolinux Splash Art](../.var/app/org.gimp.GIMP/config/GIMP/2.10/splashes/photogimp-diolinux-splash.png)
+> **Novo no GIMP?** O GIMP é um editor de imagens gratuito e de código aberto disponível para Linux, macOS e Windows. Ele pode fazer quase tudo que o Photoshop faz — retoque de fotos, composição de imagens, design gráfico e muito mais — tudo de graça. O PhotoGIMP apenas faz com que ele *pareça e funcione* mais como o Photoshop.
 
-**📷 Captura de Tela**
+---
 
-![PhotoGimp Screenshot - Editing Google Takeout](../screenshots/2020-06-22_12-06.png)
+## ✨ Recursos
 
-**🈂 Tenha um grande conjunto de fontes disponíveis a qualquer momento**
+- **Layout de ferramentas no estilo Photoshop** — As ferramentas são reorganizadas para imitar as posições que você já conhece do Adobe Photoshop.
+- **Tela Inicial personalizada** — Uma splash screen exclusiva do PhotoGIMP aparece ao iniciar o programa.
+- **Espaço de trabalho maximizado** — As configurações padrão são otimizadas para dar a você a maior área de trabalho possível.
+- **Atalhos de teclado do Photoshop** — Os atalhos seguem a [documentação oficial da Adobe](https://helpx.adobe.com/photoshop/using/default-keyboard-shortcuts.html) para a versão Windows.
+- **Ícone e nome personalizados** — Um arquivo `.desktop` dedicado dá ao PhotoGIMP seu próprio ícone e nome no menu do sistema.
 
-Mais de 1800 fontes são incluídas por padrão no PhotoGimp para que você possa acelerar seu fluxo de trabalho criativo.
+---
 
-<!-- TODO: Adicionar captura de tela utilizando uma das fontes incluídas. -->
+## 📷 Capturas de Tela
 
-[Confira todas as fontes incluídas](https://github.com/Diolinux/PhotoGIMP/blob/master/fonts.txt)
+<p>
+  <img src="../.config/GIMP/3.0/splashes/splash-screen-2025-v2.png" alt="PhotoGIMP Diolinux Splash Art">
+  <em>PhotoGIMP Diolinux Splash Art</em>
+</p>
 
-## ⚙ Como instalar (usando Flatpak)
+<p>
+  <img src="../screenshots/photogimp_3_-_diolinux.png" alt="PhotoGIMP 3">
+  <em>GIMP 3.0 com o patch PhotoGIMP aplicado</em>
+</p>
 
-Este pacote é sobre flatpak, mas também contém "apenas arquivos" que você pode usar em qualquer versão do GIMP (.deb, .rpm, Snap, AppImage, Windows, macOS). Basta verificar a localização dos arquivos de configuração do GIMP.
+---
 
-**Inicie e saia do GIMP após a instalação antes de continuar!**
+## 📋 Requisitos
 
-### Prepare o ambiente Flatpak
+Antes de instalar o PhotoGIMP, certifique-se de que você tem:
 
-* Antes de tudo, você precisa ter o GIMP mais recente instalado em seu sistema [usando Flatpak](https://flatpak.org/setup/)
-* Instale o GIMP Flatpak através do seu AppCenter/Gerenciador de Pacotes ou terminal: ```flatpak install flathub org.gimp.GIMP```
+| Requisito | Detalhes |
+|---|---|
+| **GIMP 3.0 ou mais recente** | Baixe em: [gimp.org](https://www.gimp.org/downloads/) ou [Flathub](https://flathub.org/apps/org.gimp.GIMP) (Linux) |
+| **Executar o GIMP pelo menos uma vez** | O GIMP precisa gerar seus arquivos de configuração antes que o PhotoGIMP possa sobrescrevê-los. **Instale o GIMP → abra-o → feche-o → depois instale o PhotoGIMP.** |
 
-### Instale o PhotoGIMP
+---
 
-Dentro do arquivo .zip da [página de lançamentos](https://github.com/Diolinux/PhotoGIMP/releases) você encontrará três pastas (ocultas em sistemas não Windows, pois seus nomes começam com um ponto). Todas essas pastas devem ser extraídas para sua pasta `$HOME`, substituindo tudo se você já tiver os mesmos arquivos de uma instalação mais antiga.
+## ⚙ Como Instalar
 
-O arquivo contém estes diretórios:
-* `.icons` (que tem um novo ícone do PhotoGIMP)
-* `.local` (que contém o arquivo .desktop personalizado)
-* `.var` (que contém a personalização do patch flatpak para GIMP 2.10+)
+> [!WARNING]
+> **Faça backup das suas configurações atuais do GIMP antes de instalar!** O PhotoGIMP sobrescreve os arquivos de configuração do GIMP. Se você tem configurações personalizadas que deseja manter, salve uma cópia de backup primeiro. Veja as instruções de backup em cada seção abaixo.
 
-Se você deseja apenas a personalização do PhotoGIMP sem alterar o ícone original do GIMP e seu nome, apenas extraia apenas a pasta ```.var``` para o seu diretório home.
+---
 
-## ⚙ Como instalar (outros)
+### 🐧 Flatpak (Linux)
 
-Como são apenas arquivos, a única coisa que você precisa fazer é copiar todos os arquivos que residem em uma pasta específica deste pacote `/.var/app/org.gimp.GIMP/config/GIMP/2.10` para a configuração do seu GIMP pasta em cada sistema em particular, substituindo os existentes.
+<img src="https://skillicons.dev/icons?i=linux" align="right" width="40" />
 
-**Inicie e saia do GIMP após a instalação antes de continuar!**
+#### Backup (opcional)
 
-O novo ícone precisa ser definido manualmente.
+Se você deseja manter suas configurações atuais do GIMP, faça o backup primeiro:
 
-### Snap do Ubuntu
-
-Pasta de configuração: `$HOME/snap/gimp/47/.config/GIMP/2.10/`
-
-### Outros sistemas Linux ou Unix(-like) (.deb, .rpm, etc.)
-
-Pasta de configuração: `$HOME/.config/GIMP/2.10/`
-
-### macOS
-
-Pasta de configuração: `"$HOME/Library/Application Support/GIMP/2.10/"`
-
-* [Video Tutorial de Davies Media Design no macOS](https://youtu.be/5nXhtaGQs9U)
-
-Este one-liner fará o trabalho:
-```console
-curl -L https://github.com/Diolinux/PhotoGIMP/releases/download/1.0/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip -o ~/Downloads/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip && unzip ~/Downloads/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip -d ~/Downloads && cp -R ~/Downloads/PhotoGIMP\ by\ Diolinux\ v2020\ for\ Flatpak/.var/app/org.gimp.GIMP/config/GIMP/2.10/ ~/Library/Application\ Support/GIMP/2.10 && rm ~/Downloads/PhotoGIMP.by.Diolinux.v2020.for.Flatpak.zip
+```bash
+cp -r ~/.config/GIMP/3.0 ~/GIMP-3.0-backup
 ```
-(baixa a versão 1.0 na pasta `Downloads`, descompacta e copia os arquivos, depois remove o arquivo .zip baixado)
 
-*Aviso*: o GIMP no macOS está um pouco atrasado em seu lançamento. Desta forma, este patch ainda funciona, especialmente na questão dos atalhos, mas algumas coisas, como a organização da caixa de ferramentas, não funcionarão corretamente. Até que a versão do macOS atinja a versão 2.10.20, espere esse comportamento.
+#### Instalação
 
-### Windows
+1. Certifique-se de que o GIMP já está instalado [pelo Flathub](https://flathub.org/apps/org.gimp.GIMP).
+2. **Abra o GIMP uma vez e depois feche-o** — isso cria as pastas de configuração que o PhotoGIMP precisa.
+3. Baixe a versão mais recente:
+   👉 **[Baixar PhotoGIMP para Linux (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP-linux.zip)**
+4. Extraia o arquivo `.zip` **na sua pasta pessoal** (`~`).
+   - Isso colocará arquivos em `~/.config` e `~/.local`, que são pastas ocultas.
+   - Para ver pastas ocultas no seu gerenciador de arquivos, pressione <kbd>Ctrl</kbd> + <kbd>H</kbd>.
+   - Quando perguntado sobre arquivos existentes, escolha **"Substituir"** ou **"Sobrescrever"**.
+5. Abra o GIMP — você deverá ver o novo layout do PhotoGIMP! 🎉
 
-Pasta de configuração: `%APPDATA%\GIMP\2.10`
+<details>
+<summary><strong>💡 Usando um GIMP que não é Flatpak?</strong></summary>
 
-* [Tutorial em vídeo para Davies Media Design no Windows](https://youtu.be/57DNUsf4A-0)
+Se você instalou o GIMP pelo gerenciador de pacotes da sua distribuição (apt, dnf, pacman, etc.) em vez do Flatpak, a pasta de configuração está no mesmo local (`~/.config/GIMP/3.0`), então os passos acima ainda funcionam. Apenas certifique-se de que você tem o GIMP versão 3.0 ou mais recente.
+</details>
+
+---
+
+### 🪟 Windows
+
+<img src="https://skillicons.dev/icons?i=windows" align="right" />
+
+#### Backup (opcional)
+
+Se você deseja manter suas configurações atuais do GIMP, faça o backup primeiro:
+
+1. Pressione <kbd>Windows</kbd> + <kbd>R</kbd> para abrir o diálogo Executar.
+2. Digite `%APPDATA%\GIMP` e pressione <kbd>Enter</kbd>.
+3. Copie toda a pasta `3.0` para um local seguro (ex.: sua Área de Trabalho).
+
+#### Instalação
+
+1. Certifique-se de que o [GIMP está instalado pelo site oficial](https://www.gimp.org/downloads/).
+2. **Abra o GIMP uma vez e depois feche-o** — isso cria as pastas de configuração que o PhotoGIMP precisa.
+3. Baixe a versão mais recente:
+   👉 **[Baixar PhotoGIMP para Windows (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Extraia o conteúdo de `PhotoGIMP.zip` para qualquer pasta (ex.: sua Área de Trabalho).
+5. Abra a pasta extraída e **copie a pasta `3.0`**.
+6. Pressione <kbd>Windows</kbd> + <kbd>R</kbd> para abrir o diálogo Executar.
+7. Digite `%APPDATA%\GIMP` e pressione <kbd>Enter</kbd> — isso abre a pasta de configurações do GIMP.
+8. **Cole** a pasta `3.0` aqui.
+9. Quando perguntado sobre arquivos existentes, selecione **"Substituir os arquivos no destino"**.
+10. Abra o GIMP — você deverá ver o novo layout do PhotoGIMP! 🎉
+
+<details>
+<summary><strong>💡 Opcional: Alterar o ícone do atalho do GIMP</strong></summary>
+
+Você também pode baixar o [photogimp.ico](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/photogimp.ico) e atualizar o ícone no atalho do GIMP localizado em:
+
+```
+%appdata%\Microsoft\Windows\Start Menu\Programs\GIMP 3.0.0
+```
+
+Clique com o botão direito no atalho → **Propriedades** → **Alterar Ícone** → navegue até o arquivo `.ico` baixado.
+</details>
+
+<details>
+<summary><strong>🍫 Instalar via Chocolatey (alternativa)</strong></summary>
+
+Se você usa o [Chocolatey](https://chocolatey.org/), pode instalar o PhotoGIMP com um único comando:
 
-Ou instale via [Chocolatey](https://chocolatey.org/):
 ```powershell
 choco install photogimp
 ```
-Mantido por: [André Augusto](https://github.com/AndreAugustoAAQ)
 
-## Créditos
+Mantido por: [André Augusto](https://github.com/AndreAugustoDev)
+</details>
 
-* Este projeto não seria possível sem a incrível equipe do GIMP.
-* A Foto no novo Splash é da [Isabella Mariana](https://www.pexels.com/pt-br/@isabella-mariana-1022505).
-* Muito obrigado a todos os apoiadores do Diolinux no [Twitch](https://twitch.tv/Diolinux) e no [YouTube](https://youtube.com/Diolinux).
+---
 
-## Notas do patch
-- [Veja as Notas de Lançamento em Português](https://diolinux.com.br/2020/06/photogimp-2020.html).
+### 🍎 macOS
+
+<img src="https://skillicons.dev/icons?i=macos" align="right" />
+
+#### Backup (opcional)
+
+Se você deseja manter suas configurações atuais do GIMP, faça o backup primeiro:
+
+1. Abra o Finder.
+2. Pressione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> e vá para `~/Library/Application Support/GIMP`.
+3. Copie toda a pasta `GIMP` para um local seguro (ex.: sua Área de Trabalho).
+
+#### Instalação
+
+1. Certifique-se de que o [GIMP está instalado pelo site oficial](https://www.gimp.org/downloads/).
+2. **Abra o GIMP uma vez e depois feche-o** — isso cria as pastas de configuração que o PhotoGIMP precisa.
+3. Baixe a versão mais recente:
+   👉 **[Baixar PhotoGIMP para macOS (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Extraia o conteúdo de `PhotoGIMP.zip` para qualquer pasta (ex.: sua Área de Trabalho).
+5. Abra a pasta extraída e **copie a pasta `3.0`**.
+6. Abra o Finder, pressione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> para abrir "Ir para a Pasta".
+7. Digite `~/Library/Application Support/GIMP` e pressione <kbd>Enter</kbd>.
+8. Se você tiver uma pasta `2.10` de uma instalação anterior, **exclua-a** para evitar conflitos.
+9. **Cole** a pasta `3.0` dentro da pasta do GIMP.
+10. Quando perguntado sobre arquivos existentes, selecione **"Substituir"** ou **"Mesclar"**.
+11. Abra o GIMP — você deverá ver o novo layout do PhotoGIMP! 🎉
+
+---
+
+## 📦 O Que Está Incluído no Patch
+
+O PhotoGIMP substitui ou adiciona os seguintes arquivos no diretório de configuração do GIMP:
+
+| Arquivo / Pasta | O que faz |
+|---|---|
+| `shortcutsrc` | Atalhos de teclado mapeados para corresponder ao Photoshop |
+| `toolrc` | Configuração e ordenação de ferramentas |
+| `sessionrc` | Layout de janelas e posições de painéis |
+| `dockrc` | Configuração de painéis / docks |
+| `gimprc` | Preferências gerais do GIMP (canvas, grade, etc.) |
+| `contextrc` | Configurações de ferramenta/cor ativas |
+| `splashes/` | Tela inicial personalizada do PhotoGIMP |
+| `theme.css` | Pequenos ajustes no tema da interface |
+| `templaterc` | Modelos de canvas pré-definidos |
+
+No Linux, o patch também instala:
+- Um arquivo `.desktop` personalizado (lançador com nome e ícone do PhotoGIMP)
+- Um ícone personalizado em `~/.local/share/icons/`
+
+---
+
+## 🗑 Como Desinstalar
+
+Para remover o PhotoGIMP e restaurar o GIMP ao estado padrão, basta excluir a pasta de configuração do GIMP e reabri-lo — ele irá regenerar as configurações padrão.
+
+### Linux
+
+```bash
+rm -rf ~/.config/GIMP/3.0
+```
+
+Depois abra o GIMP novamente — ele criará uma nova configuração padrão.
+
+Se você fez um backup anteriormente, restaure-o:
+
+```bash
+cp -r ~/GIMP-3.0-backup ~/.config/GIMP/3.0
+```
+
+### Windows
+
+1. Pressione <kbd>Windows</kbd> + <kbd>R</kbd>, digite `%APPDATA%\GIMP` e pressione <kbd>Enter</kbd>.
+2. Exclua a pasta `3.0`.
+3. Abra o GIMP — ele irá recriar as configurações padrão.
+
+Ou restaure seu backup colando a pasta `3.0` de volta.
+
+### macOS
+
+1. Abra o Finder, pressione <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd>.
+2. Vá para `~/Library/Application Support/GIMP`.
+3. Exclua a pasta `3.0`.
+4. Abra o GIMP — ele irá recriar as configurações padrão.
+
+Ou restaure seu backup colando a pasta de volta.
+
+---
+
+## ❓ Solução de Problemas / FAQ
+
+<details>
+<summary><strong>O PhotoGIMP não mudou nada — o GIMP está igual</strong></summary>
+
+- Certifique-se de que você extraiu os arquivos no **local correto**. O erro mais comum é extrair na pasta errada.
+- **Linux**: As pastas `.config` e `.local` devem estar no seu diretório pessoal (`~`). Elas são ocultas — pressione <kbd>Ctrl</kbd> + <kbd>H</kbd> no seu gerenciador de arquivos para vê-las.
+- **Windows**: A pasta `3.0` deve estar **dentro** de `%APPDATA%\GIMP`, não ao lado dela.
+- **macOS**: A pasta `3.0` deve estar **dentro** de `~/Library/Application Support/GIMP`.
+- Você **fechou o GIMP** antes de colar os arquivos? O GIMP pode sobrescrever as configurações recebidas ao sair.
+</details>
+
+<details>
+<summary><strong>Recebo um erro ao abrir o GIMP depois de instalar o PhotoGIMP</strong></summary>
+
+- Isso geralmente significa que a versão do GIMP não corresponde. O PhotoGIMP é feito para o **GIMP 3.0+**. Se você está usando o GIMP 2.x, não será compatível.
+- Tente excluir a pasta de configuração e reinstalar — veja a seção [Como Desinstalar](#-como-desinstalar).
+</details>
+
+<details>
+<summary><strong>Posso usar o PhotoGIMP com o GIMP 2.10?</strong></summary>
+
+Não. Esta versão do PhotoGIMP foi projetada exclusivamente para o **GIMP 3.0 e mais recente**. O formato de configuração mudou significativamente entre o GIMP 2.x e 3.x.
+</details>
+
+<details>
+<summary><strong>O PhotoGIMP vai apagar meus pincéis, fontes ou plug-ins personalizados?</strong></summary>
+
+Não. O PhotoGIMP substitui apenas arquivos de configuração (atalhos, layout, preferências). Seus pincéis, fontes, gradientes e plug-ins pessoais permanecem intocados.
+</details>
+
+<details>
+<summary><strong>Posso personalizar os atalhos depois de instalar o PhotoGIMP?</strong></summary>
+
+Com certeza! O PhotoGIMP apenas define um ponto de partida. Você pode alterar qualquer atalho no GIMP em **Editar → Atalhos de Teclado**.
+</details>
+
+<details>
+<summary><strong>Como atualizo o PhotoGIMP para uma nova versão?</strong></summary>
+
+Basta baixar a versão mais recente e seguir os passos de instalação novamente — isso sobrescreverá a configuração anterior do PhotoGIMP.
+</details>
+
+---
+
+## 🤝 Contribuindo
+
+Encontrou um bug? Tem uma sugestão? Adoraríamos sua ajuda!
+
+- **Relatar um problema**: [Abrir uma issue](https://github.com/Diolinux/PhotoGIMP/issues)
+- **Enviar uma correção**: [Criar um pull request](https://github.com/Diolinux/PhotoGIMP/pulls)
+- **Traduzir**: Ajude-nos a traduzir o README para mais idiomas! Veja a seção [Traduções](#-traduções).
+
+---
+
+## 🌍 Traduções
+
+Este README está disponível em outros idiomas:
+
+- 🇬🇧 [English (Inglês)](../README.md)
+- 🇵🇱 [Polski (Polonês)](./README_pl.md)
+
+Quer adicionar seu idioma? Faça um fork do repositório, crie um arquivo `docs/README_xx.md` e envie um pull request!
+
+---
+
+## 🏆 Créditos
+
+- Este projeto não seria possível sem a incrível equipe do [GIMP](https://www.gimp.org/).
+- Um GRANDE obrigado a todos os apoiadores do Diolinux no [YouTube](https://youtube.com/Diolinux).
+- Tela inicial e ícones de [Adriel Filipe Design](https://bento.me/adrielfilipedesign).
+
+---
+
+## 👥 Contribuidores
+
+<a align="center" href="https://github.com/Diolinux/PhotoGIMP/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Diolinux/PhotoGIMP" />
+</a>
+
+---
+
+## 📄 Licença
+
+PhotoGIMP é licenciado sob a [GNU General Public License v3.0](../LICENSE).

docs/README_ru.md

@@ -0,0 +1,314 @@
+# 🎨 PhotoGIMP
+
+<img src="../.local/share/icons/hicolor/256x256/256x256.png" align="right" alt="PhotoGIMP application icon" title="PhotoGIMP application icon">
+
+[![GitHub stars](https://img.shields.io/github/stars/Diolinux/PhotoGIMP?style=social)](https://github.com/Diolinux/PhotoGIMP)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Latest Release](https://img.shields.io/github/v/release/Diolinux/PhotoGIMP)](https://github.com/Diolinux/PhotoGIMP/releases/latest)
+
+**PhotoGIMP** — это бесплатный, разработанный сообществом патч, который преобразует [GIMP](https://www.gimp.org/) (GNU Image Manipulation Program) в интерфейс, знакомый пользователям **Adobe Photoshop**. Если вы переходите с Photoshop на GIMP и хотите сразу почувствовать себя как дома, PhotoGIMP — это то, что вам нужно.
+
+> **Впервые работаете в GIMP?** GIMP — это бесплатный графический редактор с открытым исходным кодом, доступный для Linux, macOS и Windows. Он может делать большинство вещей, которые может делать Photoshop — ретушь фотографий, композицию изображений, графический дизайн и многое другое — и всё это бесплатно. PhotoGIMP просто делает его похожим на Photoshop по *внешнему виду и функциональности*.
+
+---
+
+## ✨ Особенности
+
+- **Расположение инструментов, аналогичное Photoshop** — Инструменты перегруппированы таким образом, чтобы имитировать привычное вам расположение в Adobe Photoshop.
+- **Пользовательская заставка** — Уникальная заставка PhotoGIMP приветствует вас при запуске.
+- **Максимально увеличенное рабочее пространство** — Настройки по умолчанию оптимизированы для обеспечения максимально возможной рабочей области.
+- **Сочетания клавиш Photoshop** — Сочетания клавиш соответствуют [официальной документации Adobe](https://helpx.adobe.com/photoshop/using/default-keyboard-shortcuts.html) для версии Windows.
+- **Пользовательский значок и имя** — Специальный `.desktop` файл позволяет присвоить PhotoGIMP собственный значок и имя приложения в системном меню.
+
+---
+
+## 📷 Скриншоты
+
+<p>
+  <img src="../.config/GIMP/3.0/splashes/splash-screen-2025-v2.png" alt="PhotoGIMP Diolinux Splash Art">
+  <em>PhotoGIMP Diolinux Splash Art</em>
+</p>
+
+<p>
+  <img src="../screenshots/photogimp_3_-_diolinux.png" alt="PhotoGIMP 3">
+  <em>GIMP 3.0 с примененным патчем PhotoGIMP</em>
+</p>
+
+---
+
+## 📋 Требования
+
+Перед установкой PhotoGIMP убедитесь, что у вас установлены следующие компоненты:
+
+| Requirement | Details |
+|---|---|
+| **GIMP 3.0 или более поздняя версия** | Скачать можно с сайта: [gimp.org](https://www.gimp.org/downloads/) или [Flathub](https://flathub.org/apps/org.gimp.GIMP) (Linux) |
+| **Запустите GIMP хотя бы один раз.** | GIMP должен сначала создать файлы конфигурации, прежде чем PhotoGIMP сможет их заменить. **Установите GIMP → запустите его → закройте → затем установите PhotoGIMP.** |
+
+---
+
+## ⚙ Инструкция по установке
+
+> [!WARNING]
+> **Перед установкой обязательно сделайте резервную копию текущих настроек GIMP!** PhotoGIMP перезаписывает конфигурационные файлы GIMP. Если у вас есть пользовательские настройки, которые вы хотите сохранить, сначала сохраните резервную копию. Инструкции по резервному копированию см. в каждом разделе ниже.
+
+---
+
+### 🐧 Flatpak (Linux)
+
+<img src="https://skillicons.dev/icons?i=linux" align="right" width="40" />
+
+#### Резервное копирование (необязательно)
+
+Если вы хотите сохранить текущие настройки GIMP, сначала сделайте их резервную копию:
+
+```bash
+cp -r ~/.config/GIMP/3.0 ~/GIMP-3.0-backup
+```
+
+#### Установка
+
+1. Убедитесь, что у вас уже установлен GIMP [из Flathub](https://flathub.org/apps/org.gimp.GIMP).
+2. **Откройте GIMP один раз, а затем закройте его** — это создаст папки конфигурации, необходимые для PhotoGIMP.
+3. Скачайте последнюю версию:
+   👉 **[Скачать PhotoGIMP для Linux (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP-linux.zip)**
+4. Распакуйте `.zip` файл **в свою домашнюю папку** (`~`).
+   - Это позволит поместить файлы в папки `~/.config` и `~/.local`, которые являются скрытыми папками.
+   - Чтобы просмотреть скрытые папки в файловом менеджере, нажмите <kbd>Ctrl</kbd> + <kbd>H</kbd>.
+   - При появлении запроса о существующих файлах выберите **"Заменить"** или **"Перезаписать"**.
+5. Откройте GIMP — вы увидите новый интерфейс PhotoGIMP! 🎉
+
+<details>
+<summary><strong>💡 Используете GIMP, не относящийся к Flatpak?</strong></summary>
+
+Если вы установили GIMP через менеджер пакетов вашего дистрибутива (apt, dnf, pacman и т. д.), а не через Flatpak, папка config находится в том же месте (`~/.config/GIMP/3.0`), поэтому описанные выше шаги по-прежнему работают. Просто убедитесь, что у вас установлена ​​версия GIMP 3.0 или новее.
+</details>
+
+---
+
+### 🪟 Windows
+
+<img src="https://skillicons.dev/icons?i=windows" align="right" />
+
+#### Резервное копирование (необязательно)
+
+Если вы хотите сохранить текущие настройки GIMP, сначала сделайте их резервную копию:
+
+1. Нажмите <kbd>Windows</kbd> + <kbd>R</kbd> чтобы открыть диалоговое окно "Выполнить".
+2. Введите текст `%APPDATA%\GIMP` и нажмите <kbd>Enter</kbd>.
+3. Скопируйте всю `3.0` папку в безопасное место (например, на рабочий стол).
+
+#### Установить
+
+1. Убедитесь, что у вас [установлен GIMP с официального сайта](https://www.gimp.org/downloads/).
+2. **Откройте GIMP один раз, а затем закройте его** — это создаст папки конфигурации, необходимые для PhotoGIMP.
+3. Скачайте последнюю версию:
+   👉 **[Скачать PhotoGIMP для Windows (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Распакуйте содержимое `PhotoGIMP.zip` в любую папку (например, на рабочий стол).
+5. Откройте извлеченную папку и **скопируйте содержимое `3.0` папки**.
+6. Нажмите <kbd>Windows</kbd> + <kbd>R</kbd>, чтобы открыть диалоговое окно "Выполнить".
+7. Введите `%APPDATA%\GIMP` и нажмите клавишу <kbd>Enter</kbd> — это откроет папку настроек GIMP.
+8. **Вставьте** папку `3.0` сюда.
+9. При появлении запроса о существующих файлах выберите **"Заменить файлы в папке назначения"**.
+10. Откройте GIMP — вы увидите новый интерфейс PhotoGIMP! 🎉
+
+<details>
+<summary><strong>💡 (Необязательно): Измените значок ярлыка GIMP</strong></summary>
+
+Вы также можете скачать [photogimp.ico](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/photogimp.ico) и обновить значок в ярлыке GIMP, расположенном по адресу:
+
+```
+%appdata%\Microsoft\Windows\Start Menu\Programs\GIMP 3.0.0
+```
+
+Щелкните правой кнопкой мыши по ярлыку → **Свойства** → **Изменить значок** → найдите загруженный `.ico` файл.
+</details>
+
+<details>
+<summary><strong>🍫 Установка через Chocolatey (альтернативный вариант)</strong></summary>
+
+Если вы используете [Chocolatey](https://chocolatey.org/), вы можете установить PhotoGIMP одной командой:
+
+```powershell
+choco install photogimp
+```
+
+Поддерживается: [André Augusto](https://github.com/AndreAugustoDev)
+</details>
+
+---
+
+### 🍎 macOS
+
+<img src="https://skillicons.dev/icons?i=macos" align="right" />
+
+#### Резервное копирование (необязательно)
+
+Если вы хотите сохранить текущие настройки GIMP, сначала сделайте их резервную копию:
+
+1. Откройте Finder.
+2. Нажмите <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> и перейдите в `~/Library/Application Support/GIMP`.
+3. Скопируйте всю `GIMP` папку в безопасное место (например, на рабочий стол).
+
+#### Установить
+
+1. Убедитесь, что у вас [установлен GIMP с официального сайта](https://www.gimp.org/downloads/).
+2. **Откройте GIMP один раз, а затем закройте его** — это создаст папки конфигурации, необходимые для PhotoGIMP.
+3. Скачайте последнюю версию:
+   👉 **[Скачать PhotoGIMP для macOS (.zip)](https://github.com/Diolinux/PhotoGIMP/releases/download/3.0/PhotoGIMP.zip)**
+4. Распакуйте содержимое `PhotoGIMP.zip` в любую папку (например, на рабочий стол).
+5. Откройте извлеченную папку и **скопируйте содержимое `3.0` папки**.
+6. Откройте Finder, нажмите <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> чтобы открыть «Переход к папке».
+7. Введите `~/Library/Application Support/GIMP` и нажмите <kbd>Enter</kbd>.
+8. Если вы видите `2.10` папку от предыдущей установки, **удалите её**, чтобы избежать конфликтов.
+
+9. **Вставьте** папку `3.0` внутрь папки GIMP.
+10. При появлении запроса о существующих файлах выберите **"Заменить"** or **"Объединить"**.
+11. Откройте GIMP — вы увидите новый интерфейс PhotoGIMP! 🎉
+
+---
+
+## 📦 Что входит в патч
+
+PhotoGIMP заменяет или добавляет следующие файлы в каталог конфигурации GIMP:
+
+| Файл / Папка | Что это делает |
+|---|---|
+| `shortcutsrc` | Клавиатурные сочетания клавиш настроены в соответствии с настройками Photoshop |
+| `toolrc` | Настройки инструментов и порядок их расположения в панели |
+| `sessionrc` | Расположение окон и панелей |
+| `dockrc` | Конфигурация доков и боковых панелей |
+| `gimprc` | Общие настройки GIMP (холст, сетка и т.д.) |
+| `contextrc` | Активные настройки контекста инструмента/цвета |
+| `splashes/` | Пользовательская заставка PhotoGIMP |
+| `theme.css` | Незначительные корректировки темы оформления пользовательского интерфейса |
+| `templaterc` | Предварительно заданные шаблоны холста |
+
+В Linux этот патч также устанавливает:
+- Пользовательский `.desktop` файл (заставка приложения с названием и значком PhotoGIMP)
+- Пользовательская иконка приложения в `~/.local/share/icons/`
+
+---
+
+## 🗑 Как удалить
+
+Чтобы удалить PhotoGIMP и восстановить GIMP до состояния по умолчанию, просто удалите папку config GIMP и снова откройте GIMP — он сгенерирует новые настройки по умолчанию.
+
+### Linux
+
+```bash
+rm -rf ~/.config/GIMP/3.0
+```
+
+Затем снова откройте GIMP — он создаст совершенно новую конфигурацию по умолчанию.
+
+Если вы ранее создали резервную копию, восстановите её:
+
+```bash
+cp -r ~/GIMP-3.0-backup ~/.config/GIMP/3.0
+```
+
+### Windows
+
+1. Нажмите <kbd>Windows</kbd> + <kbd>R</kbd>, введите `%APPDATA%\GIMP` и нажмите <kbd>Enter</kbd>.
+2. Удалите папку `3.0`.
+3. Откройте GIMP — он восстановит настройки по умолчанию.
+
+Или восстановите резервную копию, скопировав папку `3.0` из резервной копии обратно.
+
+### macOS
+
+1. Откройте Finder, нажмите <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd>.
+2. Перейдите `~/Library/Application Support/GIMP`.
+3. Удалите папку `3.0`.
+4. Откройте GIMP — он восстановит настройки по умолчанию.
+
+Или восстановите резервную копию, скопировав папку из резервной копии обратно.
+
+---
+
+## ❓ Устранение неполадок / Часто задаваемые вопросы / FAQ
+
+<details>
+<summary><strong>PhotoGIMP ничего не изменил — GIMP выглядит так же.</strong></summary>
+
+- Убедитесь, что вы распаковали файлы в **правильное место**. Самая распространённая ошибка — распаковка в неправильную папку.
+- **Linux**: Папки `.config` и `.local` должны находиться в вашей домашней директории (`~`). Они скрыты — нажмите <kbd>Ctrl</kbd> + <kbd>H</kbd> в файловом менеджере, чтобы увидеть их.
+- **Windows**: Папка `3.0` должна находиться внутри `%APPDATA%\GIMP`, а не рядом с ней.
+- **macOS**: Папка `3.0` должна находиться внутри `~/Library/Application Support/GIMP`.
+- Вы **закрыли GIMP** перед тем, как вставить файлы? GIMP может перезаписать входящие настройки при выходе.
+</details>
+
+<details>
+<summary><strong>После установки PhotoGIMP при открытии GIMP возникает ошибка.</strong></summary>
+
+- Обычно это означает, что версия GIMP не совпадает. PhotoGIMP разработан для **GIMP 3.0+**. Если вы используете GIMP 2.x, совместимость будет нарушена.
+- Попробуйте удалить папку config и переустановить программу — см. раздел [Как удалить](#-how-to-uninstall).
+</details>
+
+<details>
+<summary><strong>Можно ли использовать PhotoGIMP с GIMP 2.10?</strong></summary>
+
+Нет. Эта версия PhotoGIMP разработана исключительно для **GIMP 3.0 и новее**. Формат конфигурации значительно изменился между GIMP 2.x и 3.x.
+</details>
+
+<details>
+<summary><strong>Удалит ли PhotoGIMP мои пользовательские кисти, шрифты или плагины?</strong></summary>
+
+Нет. PhotoGIMP заменяет только файлы конфигурации (ярлыки, макет, настройки). Ваши личные кисти, шрифты, градиенты и плагины остаются неизменными.
+</details>
+
+<details>
+<summary><strong>Можно ли настроить сочетания клавиш после установки PhotoGIMP?</strong></summary>
+
+Конечно! PhotoGIMP просто задает отправную точку. Вы можете изменить любую комбинацию клавиш в GIMP через меню **Редактировать → Сочетания клавиш**.
+</details>
+
+<details>
+<summary><strong>Как обновить PhotoGIMP до новой версии?</strong></summary>
+
+Просто скачайте последнюю версию и повторите шаги установки — это перезапишет предыдущую конфигурацию PhotoGIMP.
+</details>
+
+---
+
+## 🤝 Вклад в проект
+
+Обнаружили ошибку? Есть предложение? Будем рады вашей помощи!
+
+- **Сообщить о проблеме**: [Открыть заявку](https://github.com/Diolinux/PhotoGIMP/issues)
+- **Отправьте исправление**: [создайте запрос на слияние (pull request).](https://github.com/Diolinux/PhotoGIMP/pulls)
+- **Перевод**: Help us translate the README into more languages! See the [Переводы](#-translations).
+
+---
+
+## 🌍 Переводы
+
+Данный файл README доступен на других языках:
+
+- 🇧🇷 [Português (Brazilian Portuguese)](./docs/README_pt.md)
+- 🇵🇱 [Polski (Polish)](./docs/README_pl.md)
+
+Хотите добавить свой язык? Создайте форк репозитория, создайте в нём файл`docs/README_xx.md` отправьте запрос на слияние!
+
+---
+
+## 🏆 Авторы
+
+- Этот проект был бы невозможен без замечательной команды [GIMP](https://www.gimp.org/).
+- Огромное спасибо всем поклонникам Diolinux на [YouTube](https://youtube.com/Diolinux).
+- Заставка и иконки от [Adriel Filipe Design](https://bento.me/adrielfilipedesign).
+
+---
+
+## 👥 Участники
+
+<a align="center" href="https://github.com/Diolinux/PhotoGIMP/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Diolinux/PhotoGIMP" />
+</a>
+
+---
+
+## 📄 Лицензия
+
+PhotoGIMP распространяется под лицензией [GNU General Public License v3.0](./LICENSE).