From 30e77d4feeebea596fabe5e3f400f967753f3ad9 Mon Sep 17 00:00:00 2001 From: EmsSpree Date: Wed, 24 Nov 2021 12:01:15 +0100 Subject: [PATCH] Update README.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * »build« -- term is confusing as it just contains configuration files but no application binaries * »the localization of« -- localization means language translation, it means not where to find a file * »on every system/package« -- make clear it is not about the files of the application itself * in the one-line code, »console« instead of »bash« so the term »for« in the path gets not colored red, which could be confusing * other confusing wording * other wrong english (e.g. »its« vs. »it’s«) --- README.md | 90 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 52 insertions(+), 38 deletions(-) diff --git a/README.md b/README.md index def5477..3b5c4f5 100644 --- a/README.md +++ b/README.md @@ -1,29 +1,28 @@ -![PhotoGimp Diolinux Splash Art](./.var/app/org.gimp.GIMP/config/GIMP/2.10/splashes/photogimp-diolinux-splash.png) - # 🎨 PhotoGIMP PhotoGimp Icon + alt="PhotoGimp application icon" title="PhotoGimp application icon" + width="200px" align="right"> A patch for optimizing GIMP 2.10+ for Adobe Photoshop users, including features like: -* Tool organization to mimic the position of Adobe's Photoshop; +* Tool organization to mimic the position of Adobe Photoshop; * Hundreds of new fonts by default; * 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 on Photoshop, following Adobe's Documentation; +* 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. -## 📷 Screenshots +![PhotoGimp Diolinux Splash Art](./.var/app/org.gimp.GIMP/config/GIMP/2.10/splashes/photogimp-diolinux-splash.png) + +**📷 Screenshot** ![PhotoGimp Screenshot - Editing Google Takeout](./screenshots/2020-06-22_12-06.png) -## 🈂 Have a large set of fonts available anytime +**🈂 Have a large set of fonts available anytime** More than 1800 fonts are included by default in PhotoGimp so you can speed up your creative workflow. @@ -31,62 +30,77 @@ More than 1800 fonts are included by default in PhotoGimp so you can speed up yo [Check out all included fonts](https://github.com/Diolinux/PhotoGIMP/blob/master/fonts.txt) -# ⚙ How to Install +## ⚙ How to Install (using Flatpak) + +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. -This build 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 localization of the GIMP files on every system/package. +**Start and quit GIMP after you installed before you continue!** -## Preparing the Flatpak enviroment +### Prepare the Flatpak enviroment * First of all, you need to have the latest GIMP installed on your system [using Flatpak](https://flatpak.org/setup/) * Install GIMP Flatpak through your AppCenter/Package Manager or terminal: ```flatpak install flathub org.gimp.GIMP``` -## Installing PhotoGIMP +### Install PhotoGIMP -Inside the .zip file from the [releases page](https://github.com/Diolinux/PhotoGIMP/releases) you'll find three hidden folders (on Linux, using the dot before it's name). All of these folders have to be extracted on your ```/home/$USER``` folder, overwriting everything if you already have the same files from an older installation. +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 beginn 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. 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+) +* `.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+) -If you just want the PhotoGIMP customization without changing the original GIMP icon and it's name, just extract only the .var folder to your home directory. +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. -## Want to use on Windows, macOS or Ubuntu(Snap)? +## ⚙ How to Install (others) -* [Vídeo Tutorial by Davies Media Design on macOS](https://youtu.be/5nXhtaGQs9U) -* [Vídeo Tutorial by Davies Media Design on Windows](https://youtu.be/57DNUsf4A-0) +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/2.10` to your GIMP’s configuration folder on each particular system, overriding the existent ones. -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 patch ```/.var/app/org.gimp.GIMP/config/GIMP/2.10``` to the the GIMP's folder on each particular system, overriding the existent ones: +**Start and quit GIMP after you installed before you continue!** -* Windows: `%APPDATA%\GIMP\2.10` +The new icon needs to be set manually. -Or install via [Chocolatey](https://chocolatey.org/): -```powershell -choco install photogimp +### Ubuntu Snap + +Configuration folder: `$HOME/snap/gimp/47/.config/GIMP/2.10/` + +### Other Linux or Unix(-like) systems (.deb, .rpm, etc.) + +Configuration folder: `$HOME/.config/GIMP/2.10/` + +### macOS + +Configuration folder: `"$HOME/Library/Application Support/GIMP/2.10/"` + +* [Video Tutorial by Davies Media Design on macOS](https://youtu.be/5nXhtaGQs9U) + +This one-liner will do the job: +```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 ``` -Maintained by: [André Augusto](https://github.com/AndreAugustoAAQ) +(downloads release 1.0 into `Downloads` folder, unzips and copies files, then removes downloaded .zip file) -* macOS: `~/Library/Application Support/GIMP/2.10/` +*Notice*: GIMP on macOS is a bit late on its release. This way, this patch still works, specially on the shortcuts matter, but somethings, such the toolbox organization, will not work properly. Until the macOS version reaches the version 2.10.20, expect this behavior. - This one-liner will do the job: download release 1.0 into `Downloads` folder, unzip and copy patch files, then remove previously downloaded zip: - ```bash - 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 - ``` - **Notice:** GIMP on macOS are a bit late on it's release. This way, this patch still works, specially on the shorcuts matter, but somethings, such the toolbox organization, will not work properly. Until macOS's version reaches the version 2.10.20, expect this behavior. +### Windows -* Ubuntu (Snap): `/home/$USER/snap/gimp/47/.config/GIMP/2.10/` +Configuration folder: `%APPDATA%\GIMP\2.10` -* Regular Linux Installation (.deb, .rpm): `/home/$USER/.config/GIMP/2.10/` +* [Video Tutorial by Davies Media Design on Windows](https://youtu.be/57DNUsf4A-0) -The new icon will only work through the patch extration process on Linux enviroments, but you can set it manually on your system. +Or install via [Chocolatey](https://chocolatey.org/): +```powershell +choco install photogimp +``` +Maintained by: [André Augusto](https://github.com/AndreAugustoAAQ) ## Credits -* This project would't be possible without the amazing GIMP Team. +* 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). +* A BIG thanks to all Diolinux’s supporters on [Twitch](https://twitch.tv/Diolinux) and [YouTube](https://youtube.com/Diolinux). ## Patch Notes - [Veja as Notas de Lançamento em Português](https://diolinux.com.br/2020/06/photogimp-2020.html)