GUI for ESRGAN with additional features
Uses net-vips library to split input images into tiles and then merge them after processing with ESRGAN. Also supports alpha channels (transparency) and various image formats (.dds, .tga etc).
If you want to use all features of this tool (filtering, logs and more) - don't use imagemagick tiling. Also imagemagick merging might leave visible seams.
Although app can detect model upscale size by running python script, for better perfomance it is highly recommended to rename all your models so that filenames contain upscale size as in screenshot below.
YOU DON'T PUT YOUR IMAGES IN LR FOLDER, PUT THEM IN "IMAGES" FOLDER AND CROP THEM, TILES WILL BE CREATED IN LR IN PNG FORMAT
Please, before using this tool ensure that you installed all python dependencies correctly and ESRGAN is working.
- .NET Framework 4.5
- ESRGAN (old version)
- ImageMagick 7 (optional, for using ImageMagick instead of vips)
On first launch specify ESRGAN main directory path in Settings tab. You can also specify folders for input and output images. By default it will be "esrgan-path/img" and "esrgan-path/results/merged".
Check one or more models from the tree view, select corresponding upscale size, output mode.
When ready click [CROP] button. Tiles will be created from input images in "esrgan-path/LR" directory. Tile resolution will be calculated from MaxTileResolution value (biggest possible). Each time old tiles will be deleted from folder. You need to always run [CROP] before ESRGAN, even when you don't really need to crop images.
Click [RUN ESRGAN] button to start ESRGAN script in console window.
When ESRGAN is finished, results will be in "results-path" folder, "results-path/models" or "results-path/images" folders, depending on which output mode you selected earlier.
To merge resulted tiles back click [MERGE] button.
Notice: Don't delete images from input directory before you finished working with them.
- ModuleNotFoundError: No module named 'architecture' - you are using new version of ESRGAN, it's not compatible with old models and this tool. Download older version from the link above.
Maximum tile resolution
MaxTileResolution = TileWidth x TileHeight Currently, to find out how big MaxTileResolution you VGRAM can handle you need to experiment. Default value is for 2Gb VRAM (GTX 750 Ti).
When creating tiles, they will be overlaping between themselves by size in pixels specified by this value. Value must be at least 16 pixels. The bigger value - more time to process tiles with ESRGAN.
If checked, while creating tiles and merging them, alpha channels from input images will be ignored.
Preserve image format
When merging writes image in original format. If unchecked all images will be merged as PNG.
Create image image in input folder
Creates blank black image with max TileWith and TileHeight. It's might be needed because if ESRGAN starts with small image and then tries to process bigger image, it can run in out of memory error.
Delete results after merging
After succesfullyu merging image deletes all of it merged tiles in result folder.
Usefull when you are using tool other than ESRGAN and your processed image have suffix. Just check this option and write it in textbox befote merging tiles.
Use various filter if you want to work only with particular images from input folder. For example you might upscale only images with "(wood)" in filename. Or you want to merge images without alpha as .png and the rest - as .tga etc.
Filters work only when cropping and merging! ESRGAN still process all files from it's LR directory.
- Results: esrgan-path/results
- Merged results: merged-results-path/
Folder for each image
- Results: results-path/images/image-name/
- Merged results: merged-results-path/images/image-name/merged
Folder for each model
- Results: results-path/models/model-name/
- Merged results: merged-results-path/models/model-name/merged