# How Does PhotoGIMP Modify GIMP's Default Layout? A Complete Technical Guide > Discover how PhotoGIMP modifies GIMP's layout by overwriting configuration files to mimic Photoshop's interface without altering source code. Get the complete technical guide. - Repository: [Diolinux/PhotoGIMP](https://github.com/Diolinux/PhotoGIMP) - Tags: deep-dive - Published: 2026-05-20 --- **PhotoGIMP modifies GIMP's default layout by overwriting configuration files in the user's GIMP directory, specifically `toolrc`, `sessionrc`, `shortcutsrc`, and `dockrc`, to replicate Adobe Photoshop's interface without changing any source code.** PhotoGIMP, maintained in the Diolinux/PhotoGIMP repository, is not a compiled plugin but rather a sophisticated configuration patch that transforms GIMP's interface into a Photoshop-like workspace. By replacing specific files in GIMP's configuration directory, it reorders tools, remaps keyboard shortcuts, and repositions panels to minimize the learning curve for users migrating from Adobe's ecosystem. ## Understanding PhotoGIMP's Configuration-Based Architecture PhotoGIMP does not compile into a binary or alter GIMP's source code. Instead, it supplies pre-tuned configuration files that GIMP reads at startup from the user's configuration directory. When these files are present in `~/.config/GIMP/3.0` on Linux, `%APPDATA%\GIMP\3.0` on Windows, or `~/Library/Application Support/GIMP/3.0` on macOS, GIMP builds its UI according to PhotoGIMP's specifications rather than its own defaults. Because GIMP rewrites `sessionrc` on every quit, PhotoGIMP ensures its layout persists by providing a baseline configuration that GIMP loads fresh each startup. This approach allows the transformation to remain stable across sessions while remaining completely reversible by deleting the configuration files. ## The Core Configuration Files That Transform the UI PhotoGIMP's layout modification relies on seven key configuration files, each controlling specific aspects of the interface. ### toolrc: Reordering and Hiding Toolbox Tools The `.config/GIMP/3.0/toolrc` file restructures the left-hand toolbox to mirror Photoshop's tool arrangement. It reorders tools to group related functions together—such as placing the align-tool immediately after the move-tool—and hides rarely-used utilities that clutter the default GIMP interface. This creates the familiar vertical column of selection, paint, and retouching tools found in Adobe's workflow. ### sessionrc: Window Mode and Panel Placement The `.config/GIMP/3.0/sessionrc` file enforces **single-window mode**, sets the default window to maximized, and positions the toolbox on the left side of the canvas. It also docks the *tool options* panel on the right and opens the most commonly used dockables—including layers, channels, and brushes—creating the maximized canvas feel characteristic of Photoshop. This file is critical for establishing the overall workspace geometry that defines the PhotoGIMP experience. ### shortcutsrc: Photoshop-Compatible Keyboard Shortcuts The `.config/GIMP/3.0/shortcutsrc` file maps keyboard shortcuts to Adobe Photoshop's defaults, allowing users to trigger tools with familiar keystrokes. For example, **V** activates the Move tool, **M** selects the Marquee (Rectangle Select), and **B** calls the Brush tool. This eliminates the friction of learning new hotkeys when transitioning between applications. ### dockrc: Managing Dock Panel Visibility The `.config/GIMP/3.0/dockrc` file defines which docks remain visible and their default widths. PhotoGIMP configures the right-hand dock area to display *Tool Options*, *Brush Grid*, *Gradient List*, and other essential panels while hiding GIMP-specific panels that don't align with Photoshop's workflow. The file forces specific dock widths to ensure the canvas maintains optimal screen real estate. ### gimprc: General Preferences and Performance The `.config/GIMP/3.0/gimprc` file adjusts general preferences that affect the workspace feel, including canvas size defaults, undo memory limits, and UI scaling factors. These tweaks maximize usable workspace and ensure the interface responds similarly to Photoshop's performance characteristics. ### Theme and Visual Polish PhotoGIMP includes [`.config/GIMP/3.0/theme.css`](https://github.com/Diolinux/PhotoGIMP/blob/main/.config/GIMP/3.0/theme.css) for minor UI spacing adjustments and `.config/GIMP/3.0/templaterc` to provide ready-made canvas templates matching Photoshop's default sizes. The `.config/GIMP/3.0/splashes/` directory contains a custom splash screen that brands the application as "PhotoGIMP," providing immediate visual confirmation that the configuration patch is active. ## Installation Paths Across Operating Systems PhotoGIMP works by placing its configuration files in GIMP's user-specific configuration directory. Depending on your operating system, extract the PhotoGIMP archive to one of the following locations: - **Linux**: `~/.config/GIMP/3.0/` - **Windows**: `%APPDATA%\GIMP\3.0\` - **macOS**: `~/Library/Application Support/GIMP/3.0/` When you extract PhotoGIMP's ZIP file into your home folder, these paths align with the repository structure, automatically placing the configuration files in the correct location for GIMP 3.0 to read them at startup. ## How to Inspect and Verify the Layout Changes You can verify that PhotoGIMP's configuration files are active by inspecting their contents directly. These commands demonstrate how the patched files influence GIMP's behavior: ```bash # Verify the reordered toolbox hierarchy grep -A2 '"gimp-move-tool"' ~/.config/GIMP/3.0/toolrc ``` ```bash # Confirm single-window mode is forced grep 'single-window-mode' ~/.config/GIMP/3.0/sessionrc ``` ```bash # Display Photoshop-style keyboard mappings grep -E '^\(shortcut.*V|M|B' ~/.config/GIMP/3.0/shortcutsrc ``` These commands confirm that PhotoGIMP has successfully overwritten the default configuration, allowing you to edit these files afterward to further customize the layout to your preferences. ## Summary - PhotoGIMP modifies GIMP's default layout by overwriting seven key configuration files in the user's GIMP directory without touching source code. - The `.config/GIMP/3.0/sessionrc` file enforces single-window mode and positions panels to replicate Photoshop's workspace geometry. - The `.config/GIMP/3.0/toolrc` file reorders and filters the toolbox to match Adobe's tool arrangement. - Keyboard shortcuts are remapped via `.config/GIMP/3.0/shortcutsrc` to use Photoshop's standard keystrokes (V for Move, M for Marquee, B for Brush). - Dock panels are controlled by `.config/GIMP/3.0/dockrc`, while general preferences are tuned in `.config/GIMP/3.0/gimprc`. - Installation requires extracting files to `~/.config/GIMP/3.0` (Linux), `%APPDATA%\GIMP\3.0` (Windows), or `~/Library/Application Support/GIMP/3.0` (macOS). ## Frequently Asked Questions ### Does PhotoGIMP modify GIMP's source code? No, PhotoGIMP does not modify any source code or require compilation. It is a pure configuration solution that works by supplying replacement files for GIMP's standard configuration files. GIMP reads these files at startup and constructs its interface accordingly, making the changes completely reversible by deleting the configuration directory. ### How do I revert to GIMP's default layout after installing PhotoGIMP? To restore GIMP's default layout, delete or rename the PhotoGIMP configuration files in your GIMP user directory. Remove the `toolrc`, `sessionrc`, `shortcutsrc`, `dockrc`, and `gimprc` files from `~/.config/GIMP/3.0/` (or the equivalent path for your operating system), then restart GIMP. GIMP will regenerate these files with its default settings on the next launch. ### Will PhotoGIMP work with GIMP versions other than 3.0? PhotoGIMP is specifically tuned for GIMP 3.0, as indicated by the directory structure `.config/GIMP/3.0/`. While some settings may carry over to other versions, the configuration files are version-specific and may not load correctly or may be ignored by older or newer GIMP releases. Always check the PhotoGIMP repository for compatibility updates before upgrading GIMP. ### Can I customize the PhotoGIMP layout after installation? Yes, you can customize any aspect of the PhotoGIMP layout by editing the configuration files after installation. Changes to `sessionrc` will persist for the current session but may be overwritten when GIMP exits, while modifications to `toolrc`, `shortcutsrc`, and `gimprc` typically persist until manually changed. You can also use GIMP's Preferences dialog to adjust settings, though some changes may conflict with PhotoGIMP's defaults.