From 9074a3072b201ccd2d36da22dc6d4ebc396b1e69 Mon Sep 17 00:00:00 2001 From: Janis Hutz <98422316+simplePCBuilding@users.noreply.github.com> Date: Wed, 10 Jan 2024 08:56:40 +0100 Subject: [PATCH] Add README again --- README.md | 118 +++++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 99 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index a1766e5..2c9d9c8 100755 --- a/README.md +++ b/README.md @@ -1,24 +1,104 @@ -# SimpleMediaUpscalerLite +
+ +

SimpleMediaUpscalerLite

+
-## Project setup -``` -npm install -``` +
+ + + Lines of code + + +
+ GitHub Repo stars + GitHub watchers + + GitHub forks + GitHub commit activity +
+ GitHub all releases + GitHub release (latest by date) + + + +
+smuL (pronounced like "small") is an Electron App that can be used to upscale images and videos using multiple different upscaling engines. -### Compiles and hot-reloads for development -``` -npm run serve -``` +# Ongoing change: +We are abandoning the CLI in favour of tighter integration with the frontend and to provide you with more information on the upscaling process. -### Compiles and minifies for production -``` -npm run build -``` +WE ARE LOOKING TO ALSO SUPPORT MacOS IN THE FUTURE. IF YOU USE OR KNOW SOMEBODY THAT USES MacOS and who'd be willing to run smuL to test, please let us know through an issue or the [contact form on my website](https://janishutz.com/support/contact) -### Lints and fixes files -``` -npm run lint -``` +# Functionality +This app allows you to upscale a single file or (in the future) a full on folder with one of many different engines that can be added as plugins. +- Choose an input & output file from a GUI filemanager. +- Set your own scaling multiplier +- You may upscale Images (currently .png, .jpg and .jpeg) or Videos (currently .mp4 and .mkv) +- Choose from one of many different upscaling algorithms. +- Add plugins to add even more upscaling engines to it (will now have to be written in JS, see wiki for more info) -### Customize configuration -See [Configuration Reference](https://cli.vuejs.org/config/). +## Engines +- AMD Fidelity FX Super Resolution +- Cubic scaling +- High Quality Cubic +- Real-ESGRAN +- more to come! + +# Supported OS +- Windows 10, 11 (officially) +- Windows XP, Vista, 7, 8 might or might not work +- Any modern Linux distro with wine installed + +# Contributing +If you have any suggestions or features you'd like to have implemented, you may either implement the feature yourself and open a pull request, or open an issue on this GitHub page. Both things are appreciated! + +--> Follow the rules layed out in CONTRIBUTING.md +--> We will add a linter that will then run on circleci to ensure code quality is high + +### Current Contributers +- simplePCBuilding (Maintainer) [Docs, Website, Frontend, Linux packages] +- ThatPlasma (Testing) [Testing] + + +# Roadmap +V2.0.0: +- Migrate to Electron app -- ✅ +- Package Windows & Linux Version -- ✅ +- Add packaging script for Linux & Windows version -- ✅ +- Make python app CLI only -- ✅ +- Refactor backend to add plugin support -- ✅ + +V2.1.0: +- Remove CLI and make tighter integration with GUI +- Add more scaling engines (as plugins, currently planning on adding the mpv-player cli) +- Expand Wiki to feature documentation on how to create a plugin and maybe add a project website +- Show progress of scaling + +# Issues +If you encounter any problems with this app, please don't hesitate to open an issue on GitHub. + +## Known issues +- Electron App shows that it is out of date if running in the development version + +# FAQ +**Q: Can you add upscaling engine [upscaling engine here]?** + +A: We can add it most likely, please open an issue that contains a link to the library and please try and upscale an image using it yourself and copy-paste the command into a comment. +Just remember that it might take time to implement it and this is all developed in our free time and we have no obligation to implement it. + +**Q: App no worky on OS XXXX** + +A: Please check [Supported OS](#supported-os) that your OS is actually supported officially. If so, please open an issue and provide command used (if CLI) and error message that the app spat out when running. +If the OS is not officially supported, we may not be able to help you, since we intentionally don't support it officially + +**Q: Why no worky on MacOS? / Can you port to MacOS?** + +A: Wine support on MacOS is still mediocre and most likely cannot run some of the upscalers included by default so we cannot support it. I will be testing it at some point in a VM, but that won't necesarily speak for full functionality. If you find a way to run all upscalers on Mac, feel free to open a PR to add that functionality or just let us know what you did in an issue. + +**Q: Upscaled XXX looks not as great as I want** + +A: Try out different engines (that's why we support so many) and try to use sharpening to improve quality. If it doesn't help, you might want to suggest another engine. + +**Q: How can I support you?** + +A: You may contribute to this project by writing documentation, improving the website, adding plugins, fixing bugs, testing or by donating.