diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 19 |
1 files changed, 17 insertions, 2 deletions
@@ -1,18 +1,33 @@ # upscale-qt -Small PyQt6 app to upscale an image with an ESRGAN model through `sd-cli` (stable-diffusion.cpp). A local vision model suggests which upscaler fits the image, a slider wipe compares before and after, and the result can be saved as a new file or written over the original. +Small PyQt6 app to upscale an image with an ESRGAN model through `sd-cli` (stable-diffusion.cpp). A slider wipe compares before and after, and the result can be saved as a new file or written over the original. ## Requirements - Python 3 - PyQt6 - `sd-cli` from stable-diffusion.cpp, plus one or more ESRGAN upscaler models in a folder -- Optional: `llama-mtmd-cli` from llama.cpp and the imajev model with its mmproj, for upscaler suggestions ## Usage ./upscale-qt [image] +- Open an image (Ctrl+O, or pass it as argument). EXIF rotation is applied. +- Pick a model and Upscale (Ctrl+U). Expect roughly 25 seconds per megapixel of input; the result is 4x in each direction. +- The view shows before left of the divider and after right of it. Drag the divider to wipe, drag elsewhere to pan, mouse wheel to zoom, double-click to fit. +- Save As (Ctrl+Shift+S) writes a new file. Overwrite replaces the original after a confirmation, in the same format. EXIF metadata is not kept. +- Settings holds the upscalers folder. + +### Model descriptions + +Put a `models.txt` next to the models to show what each one is for in the dropdown: + + # filename = what it is for + some_model_x4.pth = Clean photos: people, nature + other_model_x4.pth = Noisy or compressed photos + +Models without a line show their filename. + ## License Copyright (C) 2026 Danilo M. <danix@danix.xyz> |