gimp_upscale

  Upscale directly within GIMP using realesrgan-ncnn-vulkan

Features

• Choose between 6 built-in models:
  • realesr-animevideov3-x4, RealESRGAN_General_x4_v3,
  • realesrgan-x4plus, realesrgan-x4plus-anime,
  • UltraSharp-4x, AnimeSharp-4x
• Upscale the entire layer, or just the selection.
• Scale the output to any factor from 0.1x to 8x
• Create a copy of the original selection when upscaling just the selection.
• Cleanly upscale transparent alpha channels.
• Use any other custom 4x ESRGAN model.

Adding your own custom ESRGAN models to the plug-in...

• Add your own models (NCNN) to the resrgan/models folder.
  • Additional models can be found at https://openmodeldb.info/
  • At this time, only 4x/x4 models are supported.
  • Please ensure the custom model includes a model.param and a model.bin file.
    • .pth model format is not supported.
  • Models can be converted to NCNN format with tools like:
    • Chainner, or custom scripts

Note

• Currently, only Windows and Linux are supported. If you're interested in testing the Mac plug-in, please create an issue.

💾 Install

Method 1

1. Download the latest release
2. Extract the zip file to your GIMP plugins directory
3. Restart GIMP

Method 2

1. Clone this repo
2. Open GIMP and go to: GIMP > Edit > Preferences > Folders > Plug-ins
3. Add the repo path to your plug-in folders
4. Restart GIMP

Extra info

Find your GIMP plug-in directory...

• You can always find you plug-in folder from:
  • GIMP > Edit > Preferences > Folders > Plug-ins
• Default directory for Windows:
  • C:\Users\%USERNAME%\AppData\Roaming\GIMP\2.10\plug-ins
  • C:\Program Files\GIMP 2\lib\gimp\2.0\plug-ins
• Default directory for Linux:
  • ~/.config/GIMP/2.10/plug-ins
  • ~/.gimp-2.10/plug-ins

Example directory structure...

GIMP plug-ins must be in a folder structure like this:

plug-ins
|
└── gimp_upscale
    |
    └── gimp_upscale.py

Additional information for Linux...

Setting up Python in GIMP on Linux may require additional steps.

If you're having trouble, you can check the resources below:

• The official GIMP download page.
  • The flatpak version of GIMP should come with Python support.
• Prebuilt GIMP Appimages; eg. From here, or from here, etc.
• Install gimp-python from your package manager.

📝 Usage

1. Open an image in GIMP
2. Go to Filters > Enhance > AI Upscale (NCNN)...
3. Choose the desired settings and click OK
4. Wait for the image to be upscaled

👥 Thanks!

• GIMP - GPL-3.0

• xinntao - Real-ESRGAN_portable - BSD-3-Clause license