1
0
mirror of https://github.com/upscayl/upscayl.git synced 2024-11-28 01:10:52 +01:00
upscayl/README.md

163 lines
9.8 KiB
Markdown
Raw Normal View History

2022-08-24 06:50:30 +02:00
<div align="center">
2023-04-08 09:06:24 +02:00
2023-05-01 12:16:52 +02:00
**v2.5 is releasing soon! [Pre-release version is already out for Linux users](https://github.com/upscayl/upscayl/releases/v2.5.0)**
2023-03-18 18:15:47 +01:00
2022-12-03 01:15:55 +01:00
[![Github All Releases](https://img.shields.io/github/downloads/upscayl/upscayl/total.svg?style=for-the-badge&logo=data:image/png;base64,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&labelColor=fff000&color=82E0AA)]()
2022-12-03 00:55:13 +01:00
2023-04-08 09:06:24 +02:00
<a href="https://github.com/upscayl/upscayl/releases/latest">
2023-04-08 09:08:41 +02:00
<img src="https://user-images.githubusercontent.com/25067102/230708394-75e2d0a6-ed69-45be-ac91-8b8770d1709e.png" width="200px" />
2023-04-08 09:06:24 +02:00
2022-12-23 08:26:21 +01:00
<a href="https://t.me/iamnayam">
2023-04-08 09:06:24 +02:00
<img src="https://user-images.githubusercontent.com/25067102/209297095-a3db856f-b760-40bb-a68e-f3a3086e18c7.png" width="200px" />
</a>
2023-01-29 03:52:06 +01:00
<a href="https://t.me/LinuxChats">
2023-04-08 09:06:24 +02:00
<img src="https://user-images.githubusercontent.com/25067102/215301815-b9922b27-4e65-435a-aa9d-239da0ac61b4.png" width="200px" />
2022-12-22 22:03:03 +01:00
</a>
2022-12-24 10:09:15 +01:00
</a>
2022-08-27 14:13:36 +02:00
2023-04-08 09:06:24 +02:00
# [Upscayl 🆙](https://upscayl.github.io)
2022-08-24 06:50:30 +02:00
#### Free and Open Source AI Image Upscaler
2023-03-13 12:32:45 +01:00
![884shots_so](https://user-images.githubusercontent.com/25067102/224690031-7b52b455-2d42-43f6-966a-3389cb61ae23.png)
2022-08-24 06:55:15 +02:00
2022-08-24 06:50:30 +02:00
**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 :)**
2022-11-17 12:44:38 +01:00
### NOTE: You'll need a Vulkan compatible GPU to upscale images. Many CPU and iGPUs do not work but no harm in trying.
2022-08-24 18:00:50 +02:00
2022-08-24 06:50:30 +02:00
</div>
2022-11-17 12:44:38 +01:00
2022-08-24 06:50:30 +02:00
# Installation 👨‍💻
2022-09-19 01:58:51 +02:00
### Linux 🐧
2022-09-20 08:57:28 +02:00
<a href="https://appimage.github.io/Upscayl/">
2022-09-20 15:28:43 +02:00
<img src="https://user-images.githubusercontent.com/25067102/191270389-9de37c0f-39a8-41f1-a659-8dd4e7b8ac28.png" width="250px"/>
</a>
2022-09-20 08:57:28 +02:00
2022-09-20 15:28:43 +02:00
<a href="https://aur.archlinux.org/packages/upscayl-bin">
<img src="https://user-images.githubusercontent.com/25067102/191269445-87050a77-c304-4284-9ea0-699721309c59.png" width="250px"/>
2022-09-20 08:57:28 +02:00
</a>
2022-08-24 06:50:30 +02:00
1. Go to [releases section](https://github.com/TGS963/upscayl/releases/latest)
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.
You can also download the flatpak version and double click the flatpak file to install via Store but wait for the full release, we'll be pushing it to Flathub for easy access.
2022-08-28 07:43:48 +02:00
### MacOS 🍎
2022-08-24 06:50:30 +02:00
2022-08-27 13:22:01 +02:00
1. Go to [releases section](https://github.com/TGS963/upscayl/releases/latest)
2. Download the `.dmg` file.
2022-08-28 05:33:32 +02:00
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.
2022-08-28 07:43:48 +02:00
### Windows 🐌
2022-08-24 06:50:30 +02:00
2022-08-27 13:22:01 +02:00
1. Go to [releases section](https://github.com/TGS963/upscayl/releases/latest)
2. Download the `.exe` file.
3. Double click exe file, wait for installation, profit.
2022-08-24 06:50:30 +02:00
2022-12-27 08:06:05 +01:00
# Comparisons: https://imgsli.com/MTQzMjI4/0/1
2022-08-28 07:44:02 +02:00
#### Medium Resolution Images (300-400 pixels wide):
2022-08-28 07:42:44 +02:00
![image](https://user-images.githubusercontent.com/25067102/187059440-83f32705-4509-4899-a109-ed2d8248fd2b.png)
![image](https://user-images.githubusercontent.com/25067102/187059369-9bc63f1c-e6c0-4d6a-9089-706db43f171f.png)
2022-08-28 07:44:02 +02:00
#### Low Resolution Images (150 pixels wide):
2022-08-28 07:42:44 +02:00
![image](https://user-images.githubusercontent.com/25067102/187059318-2d01a671-53fe-4ecc-9a74-3a791fd55818.png)
![image](https://user-images.githubusercontent.com/25067102/187059336-8d6e87ec-232f-4591-89c9-ff451692bcf2.png)
2022-08-29 09:59:47 +02:00
#### Super Low Resolution Images (75 pixels wide):
### UPSCALED TWICE
![image](https://user-images.githubusercontent.com/25067102/187153200-8e184622-a791-43ad-8d73-e5580034f2f2.png)
2022-08-27 18:03:37 +02:00
2022-08-28 07:43:48 +02:00
# Roadmap 🤫
2023-03-13 06:55:08 +01:00
You can track all the progress here: https://github.com/orgs/upscayl/projects/1
2023-03-24 03:56:00 +01:00
- Allow custom models
- Logging
2023-03-13 06:55:08 +01:00
- Fix bugs
2023-03-24 03:56:00 +01:00
- Make the whole world use FOSS (WIP 🚧)
2022-08-28 07:43:48 +02:00
2022-08-24 06:50:30 +02:00
# Development 🛠
2023-03-23 09:49:42 +01:00
I recommend using Volta: https://volta.sh for using Node.js.
Download and install volta, then do: `volta install node`.
2023-03-23 09:50:06 +01:00
```bash
2023-03-23 09:49:42 +01:00
# FOR EVERYONE
git clone https://github.com/upscayl/upscayl
2022-08-24 06:50:30 +02:00
cd upscayl
# INSTALL DEPENDENCIES
npm install
# RUN THE DEVELOPMENT SERVER LOCALLY
2023-03-23 09:49:42 +01:00
## YOUR LOGS WILL NOW APPEAR IN THE TERMINAL
npm run dev
2022-08-24 06:50:30 +02:00
2023-03-23 09:49:42 +01:00
# FOR DEVS
## PACKAGE THE APP
2022-08-24 06:50:30 +02:00
npm run dist
2023-03-23 09:49:42 +01:00
## PUBLISH THE APP, MAKE SURE TO ADD GH_TOKEN= IN SHELL
2022-08-24 06:50:30 +02:00
npm run publish-app
```
2022-08-26 06:43:54 +02:00
# 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?
2023-03-13 06:54:14 +01:00
- Yes, unfortunately. NCNN Vulkan requires a Vulkan compatible GPU. Upscayl won't work with **most** iGPUs or CPUs.
2023-04-03 13:19:21 +02:00
- Why does batch upscaling output JPGs instead of PNGs?
2023-04-20 02:31:31 +02:00
- This is an issue with REAL-ERSGAN currently tracked [here](https://github.com/upscayl/upscayl/issues/174).
2022-08-26 06:43:54 +02:00
- How can I contribute?
2023-01-22 05:48:18 +01:00
- 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](https://user-images.githubusercontent.com/25067102/213901080-706071c2-4ad1-43cc-b5c6-70f46d0b547c.png)
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.
2022-08-27 13:26:06 +02:00
- 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 :)
2022-08-26 06:43:54 +02:00
2022-08-25 06:08:57 +02:00
Upscayl uses Real-ESRGAN-ncnn-vulkan binaries to upscale images. More models and algorithms will come soon.
2022-11-10 19:43:52 +01:00
# Donate
<a href="https://www.buymeacoffee.com/fossisthefuture">
2022-11-11 21:42:31 +01:00
<img src="https://user-images.githubusercontent.com/25067102/154570688-9e143f2b-fee3-4b05-a9d2-a7a3013b2b51.png" />
2022-11-10 19:43:52 +01:00
<a/>
2022-08-24 06:50:30 +02:00
# Credits ❤
2022-08-24 10:49:01 +02:00
- Real-ESRGAN for their wonderful research work.\
2022-08-24 10:49:47 +02:00
[Real-ESRGAN: Copyright (c) 2021, Xintao Wang](https://github.com/xinntao/Real-ESRGAN/)
2022-08-24 10:50:09 +02:00
2022-08-24 06:50:30 +02:00
- Microsoft™ for their Fluent Emoji used as our logo.
2022-11-17 07:08:17 +01:00
- @JanDeDinoMan, @xanderfrangos, @Fdawgs, @keturn for their code contributions :)
- @aaronliu0130 for providing community support :)
2023-01-11 16:19:46 +01:00
- Foolhardy for their [Remacri model](https://upscale.wiki/wiki/Model_Database).
- [Kim2091](https://upscale.wiki/wiki/User:Kim2091) for their [Ultrasharp and Ultramix Balanced model](https://upscale.wiki/wiki/Model_Database).
2022-08-24 06:50:30 +02:00
#
<div align="center">
2023-04-15 07:15:58 +02:00
Copyright © 2023 - **Upscayl**\
2022-08-26 15:57:53 +02:00
By Nayam Amarshe and TGS963\
Made with 🖱 &
2022-08-24 06:50:30 +02:00
</div>