Files
Warlock-Studio-Universal/README.md
T
Iván Eduardo Chavez Ayub 28edb865c2 Update README.md
2025-06-25 22:07:28 -06:00

241 lines
12 KiB
Markdown

### 🚀Get Warlock-Studio Installer
You can download the .exe file (latest version **2.1**) from any of this platforms:
<table>
<tr>
<td align="center">
<a href="https://sourceforge.net/projects/warlock-studio/files/latest/download">
<img src="https://a.fsdn.com/con/app/sf-download-button" alt="Download from SourceForge" />
</a>
</td>
<td align="center">
<a href="https://ivanayub97.itch.io/warlock-studio">
<img src="rsc/badge-color.png" alt="Download from Itch.io" />
</a>
</td>
<td align="center">
<a href="https://drive.google.com/file/d/1ZSLyaU6zWQErPphXUcdFyxNAfATnb0J7/view?usp=sharing">
<img src="rsc/google_drive-logo.png" alt="Download from Google Drive" />
</a>
</td>
</tr>
</table>
![Warlock-Studio logo](rsc/banner.png)
![Build Status](https://img.shields.io/badge/build-Stable_Release-blue?style=for-the-badge)
![Version](https://img.shields.io/badge/%20Version-2.1-darkred?style=for-the-badge)
![Last Update](https://img.shields.io/badge/Last%20Update-06%2023%202025-purple?style=for-the-badge)
### AI-Powered Media Enhancement & Upscaling Suite 2.1
**Warlock-Studio** is a powerful **open-source desktop application** inspired by the remarkable work of [Djdefrag](https://github.com/Djdefrag), integrating tools like **QualityScaler**, **RealScaler**, and **FluidFrames**. Built with performance and usability in mind, Warlock-Studio brings together the best of these technologies into a unified and user-friendly interface.
---
It features integration with state-of-the-art models for upscaling, restoration, and frame interpolation—all within an intuitive and streamlined user interface. Warlock-Studio delivers **professional-grade media processing** capabilities to everyone.
Version 2.1 introduces major improvements, including:
- Advanced **AI frame interpolation** using **RIFE**
- **Slow-motion video generation**
- Optimized **GPU management**
- A **modular and scalable UI** architecture for better flexibility and performance
---
## 📸 Interface Previews
### 🔹 Main Interface
![Screenshot of Warlock-Studio](rsc/Capture.png)
### 🔹 RIFE (Frame Interpolation) Options
![Screenshot of Warlock-Studio](rsc/CaptureRIFE.png)
### 🔹 Icon App
## ![Screenshot of Warlock-Studio](logo.ico)
## 🛠️ Development Status — v2.1
| Component | Status | Notes |
| ----------------------------------- | ---------------- | -------------------------------------------------------------------- |
| **Upscaling Models (ESRGAN, etc.)** | 🟢 **Stable** | Fully integrated support for key enhancement and restoration models. |
| **Frame Interpolation (RIFE)** | 🟢 **New** | Includes slow-motion and intermediate frame generation capabilities. |
| **Batch Processing** | 🟢 **Stable** | Reliable processing for multiple files at once. |
| **User Interface (UI/UX)** | 🟢 **Improved** | Modular and scalable interface enhanced in version 2.0. |
| **GPU Management** | 🟢 **Optimized** | Refined resource handling and device support. |
| **Installer and Packaging** | 🟢 **Stable** | Easy-to-use installer for Windows platforms. |
---
## ✨ Recent Enhancements (v2.1)
-**Stability Overhaul:** Major improvements in error handling for model loading, frame extraction, and video encoding.
-**Resilient Processing:** Added fallbacks for video encoding and pre-checks for file operations to prevent crashes.
-**Safe Thread Management:** Upgraded to a safe `threading.Event` for stopping background tasks reliably.
-**UI Refinements:** Updated color palette for a new look and feel.
---
## 🗂️ Project Structure
```
Warlock-Studio/
├──AI-onnx/
└──├──BSRGANx2_fp16.onnx
├──BSRGANx4_fp16.onnx
├──IRCNN_Lx1_fp16.onnx
├──IRCNN_Mx1_fp16.onnx
├──RealESR_Animex4_fp16.onnx
├──RealESR_Gx4_fp16.onnx
├──RealESRGANx4_fp16.onnx
├──RealESRNetx4_fp16.onnx
├──RealSRx4_Anime_fp16.onnx
├──RIFE_fp32.onnx
└──RIFE_Lite_fp32.onnx
├──Assets/
└──├──clear_icon.png
├──exiftool.exe
├──ffmpeg.exe
├──info_icon.png
├──logo.ico
├──logo.png
├──stop_icon.png
└──upscale_icon.png
├──rsc/
└──├──banner.png
├──Capture.png
├──CaptureRIFE.png
└──Image_comparison.png
├──CHANGELOG.md
├──CODE_OF_CONDUCT.md
├──CONTRIBUTING.md
├──LICENSE
├──NOTICE.md
├──README.md # This File
├──SECURITY.md
├──Setup.iss
├──Warlock-Studio.py # Main
├──Warlock-Studio.spec
├──Warlock-Studio.py
└──logo.ico
```
## Installation
To get started with Warlock-Studio:
1. **Run the installer** and follow the setup instructions.
2. **Launch the application** by opening `Warlock-Studio.exe`.
3. **Begin enhancing** your images and videos with just a few clicks!
Warlock-Studio uses [PyInstaller](https://www.pyinstaller.org/) and [Inno Setup](http://www.jrsoftware.org/isinfo.php) for a seamless packaging and installation experience.
## Key Features
- **State-of-the-Art AI Models**
Real-ESRGAN, SRGAN, BSRGAN, IRCNN, Waifu2x, Anime4K, **RIFE**, and others for denoising, resolution enhancement, detail restoration, and smooth frame interpolation.
- **AI Frame Interpolation & Slow Motion**
Generate new in-between frames using RIFE to create smooth **2x/4x/8x** motion or dramatic slow-motion effects.
- **Batch Processing**
Simultaneously process multiple images or videos—ideal for large-scale media projects.
- **Customizable Workflows**
Choose your preferred AI model, output resolution, format (PNG, JPEG, MP4, etc.), and quality settings for full creative control.
- **Intuitive Interface**
Designed for both beginners and professionals—simple, clean, and efficient.
- **Open-Source & Extensible**
Licensed under the MIT License. Additional usage terms can be found in the [NOTICE](NOTICE) file.
---
## How to Use
1. **Run as Administrator** (optional but recommended for optimal performance).
2. **Load your media**: select your images and videos into the app.
3. **Configure settings**:
- Select an **AI Model** (e.g., Real-ESRGAN, SRGAN, BSRGAN, IRCNN, Waifu2x, Anime4K, RIFE)
- Set the **output resolution**, **file format**, and toggle features such as **interpolation** or **slow-motion**
4. **Start Processing**: click **Start** to begin enhancement.
5. **Retrieve your files**: processed outputs will be saved in your chosen destination folder.
---
## Quality Comparison
![Quality Comparison](rsc/Image_comparison.png)
---
## System Requirements
- **Operating System:** Windows 10 or later
- **Memory (RAM):** Minimum 4 GB (8 GB or more recommended)
- **Graphics Card:** NVIDIA or DirectML-compatible GPU highly recommended for performance
- **Storage:** Sufficient disk space for input and output media files
---
### Integrated Technologies & Licenses
| Technology | License | Author / Maintainer | Source Code / Homepage |
| ------------- | -------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------- |
| QualityScaler | MIT | [Djdefrag](https://github.com/Djdefrag) | [GitHub](https://github.com/Djdefrag/QualityScaler) |
| RealScaler | MIT | [Djdefrag](https://github.com/Djdefrag) | [GitHub](https://github.com/Djdefrag/RealScaler) |
| FluidFrames | MIT | [Djdefrag](https://github.com/Djdefrag) | [GitHub](https://github.com/Djdefrag/FluidFrames) |
| Real-ESRGAN | BSD 3-Clause / Apache 2.0 | [Xintao Wang](https://github.com/xinntao) | [GitHub](https://github.com/xinntao/Real-ESRGAN) |
| RealESRGAN-G | BSD 3-Clause / Apache 2.0 | [Xintao Wang](https://github.com/xinntao) | [GitHub](https://github.com/xinntao/Real-ESRGAN) |
| RealESR-Anime | BSD 3-Clause / Apache 2.0 | [Xintao Wang](https://github.com/xinntao) | [GitHub](https://github.com/xinntao/Real-ESRGAN) |
| RealESR-Net | BSD 3-Clause / Apache 2.0 | [Xintao Wang](https://github.com/xinntao) | [GitHub](https://github.com/xinntao/Real-ESRGAN) |
| RIFE | Apache 2.0 | [hzwer](https://github.com/hzwer) | [GitHub](https://github.com/megvii-research/ECCV2022-RIFE) |
| SRGAN | CC BY-NC-SA 4.0 (Non-Commercial) | [TensorLayer Community](https://github.com/tensorlayer) | [GitHub](https://github.com/tensorlayer/srgan) |
| BSRGAN | Apache 2.0 | [Kai Zhang](https://github.com/cszn) | [GitHub](https://github.com/cszn/BSRGAN) |
| IRCNN | BSD / Mixed | [Kai Zhang](https://github.com/cszn) | [GitHub](https://github.com/cszn/IRCNN) |
| Anime4K | MIT | [Tianyang Zhang (bloc97)](https://github.com/bloc97) | [GitHub](https://github.com/bloc97/Anime4K) |
| ONNX Runtime | MIT | [Microsoft](https://github.com/microsoft) | [GitHub](https://github.com/microsoft/onnxruntime) |
| PyTorch | BSD 3-Clause | [Meta AI](https://pytorch.org/) | [GitHub](https://github.com/pytorch/pytorch) |
| FFmpeg | LGPL-2.1 / GPL (varies) | [FFmpeg Team](https://ffmpeg.org/) | [Official Site](https://ffmpeg.org) |
| ExifTool | Perl Artistic License 1.0 | [Phil Harvey](https://exiftool.org/) | [Official Site](https://exiftool.org/) |
| DirectML | MIT | [Microsoft](https://github.com/microsoft/) | [GitHub](https://github.com/microsoft/DirectML) |
| Python | Python Software Foundation (PSF) | [Python Software Foundation](https://www.python.org/) | [Official Site](https://www.python.org) |
| PyInstaller | GPLv2+ | [PyInstaller Team](https://github.com/pyinstaller) | [GitHub](https://github.com/pyinstaller/pyinstaller) |
| Inno Setup | Custom Inno License | [Jordan Russell](http://www.jrsoftware.org/) | [Official Site](http://www.jrsoftware.org/isinfo.php) |
---
## Contributions
We warmly welcome community contributions!
1. **Fork** this repository.
2. **Create a branch** for your feature or fix.
3. **Submit a Pull Request** with a detailed explanation of your changes.
For bug reports, feature suggestions, or inquiries, contact us at: **[negroayub97@gmail.com](mailto:negroayub97@gmail.com)**
**Warlock-Studio** merges cutting-edge artificial intelligence with a powerful yet accessible interface—empowering creators to elevate their media effortlessly. 🧙‍♂️
---
## License
© 2025 Iván Eduardo Chavez Ayub
Distributed under the MIT License. Additional terms are available in the [NOTICE](NOTICE.md) file.