Cool_Tools/upscayl
1
0
Fork 0
mirror of https://github.com/upscayl/upscayl.git synced 2024-11-28 01:10:52 +01:00
Code Releases Wiki Activity
🆙 Upscayl - Free and Open Source AI Image Upscaler for Linux, MacOS and Windows built with Linux-First philosophy.
374 Commits 13 Branches 34 Tags 646 MiB
TypeScript 90%
JavaScript 3.4%
CSS 3.2%
Python 2.7%
Shell 0.7%
cc6b8bae24
Go to file
Danik1601 cc6b8bae24
Lots of small fixes 
Changed:
- Fixed Markdown text for better compatibility according to the [guidelines](https://www.markdownguide.org/)
- Fixed HTML code for slightly better readability
- Centered Linux installation buttons
- Removed temporary Flatpak instructions
2023-05-09 17:25:03 +03:00
.github Update main.yml 2023-05-09 15:11:00 +05:30
build Compress images 2022-10-16 09:49:31 +01:00
electron Added new model and changed logging emoji 2023-05-06 10:47:35 +05:30
flatpak updated flatpak metainfo 2023-05-09 18:43:00 +05:30
main/build Removed js files 2023-04-14 15:42:26 +05:30
models Added scale 2023-04-12 18:55:24 +05:30
renderer Added new model and changed logging emoji 2023-05-06 10:47:35 +05:30
resources Added icons 2023-05-09 13:48:52 +05:30
scripts Compress images 2022-10-16 09:49:31 +01:00
ups Fixed for v1.5 release 2022-09-19 05:24:45 +05:30
.gitignore Removed js files 2023-04-14 15:42:26 +05:30
download.jpg Updated readme 2022-12-22 17:40:23 +05:30
LICENSE Create LICENSE 2022-08-24 10:18:39 +05:30
next.config.js Converted to Typescript 2022-11-12 02:09:28 +05:30
package-lock.json Updated dependencies 2023-04-21 00:09:41 +05:30
package.json Added icons 2023-05-09 13:48:52 +05:30
postcss.config.js next and electron template 2022-08-15 10:23:14 +05:30
README.md Lots of small fixes 2023-05-09 17:25:03 +03:00
Real-ESRGAN_LICENSE.txt Add files via upload 2022-08-24 16:23:22 +05:30
screen1.png Updated readme 2022-12-22 17:40:23 +05:30
tailwind.config.js Added zoom function 2022-12-21 16:02:45 +05:30
to_upscale.jpeg Added upscaling functionality 2022-08-16 07:47:27 +05:30
tsconfig.json Converted to Typescript 2022-11-12 02:09:28 +05:30
upscayl.mp4 Added mp4 2022-08-24 10:25:15 +05:30

README.md

v2.5 is out! Upscayl hits 1 million downloads!

Github All Releases

Upscayl 🆙

Free and Open Source AI Image Upscaler

884shots_so

Upscayl is a cross-platform application built with the Linux-first philosophy. This means that we prioritize Linux builds over others but that doesn't mean we'll break things for other OSes :)

NOTE: You'll need a Vulkan compatible GPU to upscale images. Many CPU and iGPUs do not work but no harm in trying.

Installation 👨‍💻

Linux 🐧

Flatpak

  1. Go to Flathub/Upscayl

  2. Press the "Install" button. This will download the .flatpakref file.

  3. Execute the downloaded .flatpakref file. This will open your disrtibution's software center.

  4. Press the installation button in your disrtibution's software center.

AppImage

  1. Go to releases section

  2. Download the .AppImage file.

  3. Right Click AppImage -> Go to Permissions tab -> Check allow file to execute and then double click the file to run Upscayl.

Please note:

MacOS 🍎

  1. Go to releases section

  2. Download the .dmg file.

  3. Double click dmg, drag Upscayl icon into Applications folder.

If you encounter an error with opening the application, try Ctrl+Clicking/Right-clicking the app and clicking open. In the popup that opens, also click open.

Windows 🐌

  1. Go to releases section

  2. Download the .exe file.

  3. Double click exe file, wait for installation, profit.

Comparisons: https://imgsli.com/MTQzMjI4/0/1

Medium Resolution Images (300-400 pixels wide):

image image

Low Resolution Images (150 pixels wide):

image image

Super Low Resolution Images (75 pixels wide):

UPSCALED TWICE

image

Roadmap 🤫

You can track all the progress here: https://github.com/orgs/upscayl/projects/1

  • Allow custom models
  • Logging
  • Fix bugs
  • Make the whole world use FOSS (WIP 🚧)

Development 🛠

I recommend using Volta: https://volta.sh for using Node.js. Download and install volta, then do: volta install node.

# FOR EVERYONE
git clone https://github.com/upscayl/upscayl
cd upscayl

# INSTALL DEPENDENCIES
npm install

# RUN THE DEVELOPMENT SERVER LOCALLY
## YOUR LOGS WILL NOW APPEAR IN THE TERMINAL
npm run dev

# FOR DEVS
## PACKAGE THE APP
npm run dist

## PUBLISH THE APP, MAKE SURE TO ADD GH_TOKEN= IN SHELL
npm run publish-app

FAQ 🤓

  • How does Upscayl work?
    • Upscayl uses AI models to enhance your images by guessing what the details could be. It uses Real-ESRGAN (and more in the future) model to achieve this.
  • Is there a CLI available?
    • The CLI tool is called real-esrgan-ncnn-vulkan and it's available on the Real-ESRGAN repository.
  • Do I need a GPU for this to work?
    • Yes, unfortunately. NCNN Vulkan requires a Vulkan compatible GPU. Upscayl won't work with most iGPUs or CPUs.
  • Why does batch upscaling output JPGs instead of PNGs?
    • This is an issue with REAL-ERSGAN currently tracked here.
  • How can I contribute?
    • You can fix code, add features by submitting PRs, report issues or donate :)
  • What's the GPU ID for?
    • To find your GPU ID, you first need to launch Upscayl using the commandline and Upscayl an image. In the console output, you can see the GPUs that have been detected: image As you can notice, 0 is the AMD iGPU, 1 is the Nvidia GPU, and 2 is the llvmpipe. If I set my GPU ID to 0, it'll always upscayl images with AMD iGPU (CPU) instead of dedicated GPU.
  • You are not fully open source!!😡
    • We are, we're using completely free and open source tech. We do ship a binary but that's because not including it would kill the entire purpose of the project. If you want to deal with all those PyTorch, NCNN, and Python errors, you're more than welcome to compile your own binary using the code provided by Real-ESRGAN. The binary is pre-compiled for convenience, if you do not trust it, then you can compile your own since everything is free and open source here :)

Upscayl uses Real-ESRGAN-ncnn-vulkan binaries to upscale images. More models and algorithms will come soon.

Donate

Credits ❤

Copyright © 2023 - Upscayl
By Nayam Amarshe and TGS963
Made with 🖱 & ⌨