Skip to content
This repository has been archived by the owner. It is now read-only.

How to Install the PhotoGIMP Plugin

Bobby Moss edited this page Sep 29, 2020 · 23 revisions

PhotoGIMP is a very cool plugin that tweaks the GNU Image Manipulation Program specifically for users of Adobe Photoshop. It is intended by the original developer (DioLinux) to help ease the transition for users switching to a free software solution for the first time. For your convenience, we have documented how to use it with Glimpse Image Editor.

Before you proceed, please read our legal disclaimer:

"The PhotoGIMP plugin is third-party software that the Glimpse project does not host, endorse, support, or maintain. We cannot guarantee that the repository will remain available, and we rely on users reporting any problems with these instructions to us.

The plug-in itself contains assets (such as fonts) that may not have been licensed for commercial use and/or may require the payment of royalties to the intellectual property owner(s). We have provided these instructions to you on the understanding that you have made reasonable good faith efforts to comply with any and all license requirements and software patent restrictions that apply in your country.

By using the PhotoGIMP plugin and/or following any of these instructions, you agree that you are doing so at your own personal risk, and we cannot be held responsible for any legal action that may be taken against you and/or any damages or royalties that you may be required to pay."

Finally, do not copy and paste the entire contents of the ZIP file into your configuration directory. You are not running an upstream version of the GNU Image Manipulation Program, so performing that action may break your installation.

Installing PhotoGIMP 1.0 on Windows

You can replicate the steps in the Linux installation instructions by copying files into the %appData%\Glimpse\0.2 directory, and then making the necessary file edits manually instead of using sed.

Changing the splash screen and desktop shortcut are optional steps. You can change your desktop shortcut using right-click > Properties, and then tweak the settings to use the correct name and icon.

Also be aware that we do not support Python plug-ins on Windows, so you may not see some filters and functionalities that have been added by PhotoGIMP.

Installing PhotoGIMP 1.0 on Linux

These instructions assume that you have already successfully installed Glimpse Image Editor, and launched the application at least once.

The first step is to clone the assets you need to your home directory:

$ git clone --branch 1.0 https://github.com/Diolinux/PhotoGIMP.git

The remaining instructions for installing this plugin vary depending on how you installed Glimpse Image Editor.

Flatpak

Copy across the necessary assets and settings with these bash commands:

$ cd ~/.var/app/org.glimpse_editor.Glimpse/config/Glimpse/0.2

# Import all the assets
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/brushes/* brushes
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/filters/* filters
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/fonts/* fonts
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/plug-ins/* plug-ins

# You no longer need to update configuration files because we added by default in 0.2.0

# Update the splash screen
$ cp -rf ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/splashes .

# Update the application launcher icon
$ mkdir -p ~/.icons && cp ~/PhotoGIMP/.icons/photogimp.png ~/.icons/photogimp.png
$ cd ~/.local/share/applications/
$ cp /var/lib/flatpak/exports/share/applications/org.glimpse_editor.Glimpse.desktop .
$ sed -i 's/Glimpse\sImage\sEditor/PhotoGIMP/g' org.glimpse_editor.Glimpse.desktop
$ sed -i "s|Icon=.*|Icon=$HOME/.icons/photogimp.png|g" org.glimpse_editor.Glimpse.desktop

You will need to restart your machine for the application launcher to update.

Snapcraft

Copy across the necessary assets and settings with these bash commands:

$ cd ~/snap/glimpse-editor/current/.config/Glimpse/0.2

# Import all the assets
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/brushes/* brushes
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/filters/* filters
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/fonts/* fonts
$ cp ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/plug-ins/* plug-ins

# You no longer need to update configuration files because we added by default in 0.2.0

# Update the splash screen
$ cp -rf ~/PhotoGIMP/.var/app/org.gimp.GIMP/config/GIMP/2.10/splashes .

# Update application launcher icon
$ mkdir -p ~/.icons && cp ~/PhotoGIMP/.icons/photogimp.png ~/.icons/photogimp.png
$ cd /var/lib/snapd/desktop/applications
$ sudo sed -i 's/Glimpse\sImage\sEditor/PhotoGIMP/g' glimpse-editor_glimpse-editor.desktop
$ sudo sed -i "s|Icon=.*|Icon=$HOME/.icons/photogimp.png|g" glimpse-editor_glimpse-editor.desktop

You will need to restart your machine for the application launcher to update.

Uninstalling PhotoGIMP 1.0 on Linux

If you want to clear the plug-in from your system, delete the configuration folders and new custom files:

# Delete any custom app launcher files
$ rm -rf ~/.icon && rm ~/.local/share/applications/org.glimpse_editor.Glimpse.desktop

# Delete config folders
$ rm -rf ~/.var/app/org.glimpse_editor.Glimpse/config/Glimpse
$ rm -rf ~/snap/glimpse-editor/current/.config/Glimpse

If you installed using a Flatpak, your configuration folder should be regenerated the next time you launch the application. If it is not, you may need to reinstall the package.

If you installed using Snapcraft, you can either manually edit the launcher file in /var/lib/snapd/desktop/applications/org.glimpse_editor.Glimpse.desktop, or reinstall the application.