168 lines
8.6 KiB
Markdown
168 lines
8.6 KiB
Markdown

|
||
|
||
<div align="center">
|
||
|
||

|
||

|
||

|
||
|
||
[](https://github.com/Ivan-Ayub97/Warlock-Studio/commits/main)
|
||

|
||
|
||
[](https://github.com/Ivan-Ayub97/Warlock-Studio/releases)
|
||
[](https://sourceforge.net/projects/warlock-studio/)
|
||
|
||
<br>
|
||
|
||
**Warlock Studio** is a unified platform for **upscaling, restoring, denoising, and interpolating frames in videos and images.**
|
||
It is inspired by and based on [Djdefrag](https://github.com/Djdefrag) tools such as **QualityScaler** and **FluidFrames**.
|
||
|
||
---
|
||
|
||
## 📥 <span style="color:#FFD700;">Download Installer</span>
|
||
|
||
<div align="center">
|
||
<p style="color:#ccc; font-size:14px; line-height: 1.6;">
|
||
This installer was built using <b>PyInstaller</b> and <b>Inno Setup</b>.<br>
|
||
By default, it includes <b>DirectML</b> support to ensure maximum compatibility with any graphics card (NVIDIA/AMD/INTEL).
|
||
</p>
|
||
<p style="color:#ccc; font-size:14px; margin-top: 15px;">
|
||
Select your preferred option to download the latest version (Direct Release/SourceForge):
|
||
</p>
|
||
</div>
|
||
|
||
<table style="width:100%; border-collapse:collapse;">
|
||
<tr>
|
||
</td>
|
||
<td align="center" style="vertical-align:top; padding:10px;">
|
||
<a href="https://github.com/Ivan-Ayub97/Warlock-Studio/releases/download/v5.1.1/Warlock-Studio-5.1.1x64.exe">
|
||
<img src="rsc/GitHub_Logo_WS.png" alt="Download from GitHub"
|
||
width="300" style="display:block; margin:auto; margin-bottom:10px;" />
|
||
</a>
|
||
<td align="center" style="vertical-align:top; padding:px;">
|
||
<a href="https://sourceforge.net/projects/warlock-studio/" target="_blank">
|
||
<img src="https://sourceforge.net/cdn/syndication/badge_img/3880091/oss-rising-star-black"
|
||
alt="Warlock-Studio on SourceForge"
|
||
width="190" style="display:block; margin:auto; margin-bottom:1px;" />
|
||
</a>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
---
|
||
|
||
## 🖼️ Interface Capture
|
||
|
||
[Capture.webm](https://github.com/user-attachments/assets/86a679c7-ddf5-454f-9a05-db590cfced09)
|
||
|
||

|
||

|
||

|
||

|
||
|
||
---
|
||
|
||
## 🔍 Quality Comparison
|
||
|
||
[WsvideovsGit3.webm](https://github.com/user-attachments/assets/1326f86a-614e-40ae-b3a9-44ae15f648c6)
|
||
|
||
[WsvideovsGit.webm](https://github.com/user-attachments/assets/c72f389d-827e-49b9-91b7-fd13e5b59f22)
|
||
|
||
[WsvideovsGit2.webm](https://github.com/user-attachments/assets/6695cce2-f42f-4955-8b43-56ec6d7b0bd2)
|
||
|
||
---
|
||
|
||
## ✨ Key Features
|
||
|
||
- **AI Upscaling & Restoration** – Utilize **Real-ESRGAN, BSRGAN, RealESRNet, RealESR_Animex4, and IRCNN** models for denoising, super-resolution, and detail recovery.
|
||
- **Face Restoration (GFPGAN)** – Recover facial details from low-resolution or blurry images and video frames.
|
||
- **Frame Interpolation (RIFE)** – Smooth motion or generate slow-motion content with **2×, 4×, or 8× interpolation**.
|
||
- **Advanced Hardware Acceleration** – Intelligent provider selection prioritizes **CUDA**, falls back to **DirectML**, and finally **CPU** for maximum compatibility.
|
||
- **Batch Processing** – Process multiple media files simultaneously, saving time and effort.
|
||
- **Custom Workflows** – Fine-grained control over models, resolution, output formats, and quality parameters.
|
||
- **Open-Source & Extensible** – Fully MIT licensed, for contributors and developers.
|
||
|
||
---
|
||
|
||
## 🖥️ System Requirements
|
||
|
||
<div align="center">
|
||
|
||
| <span style="color: #FBC02D;">Component</span> | <span style="color: #FBC02D;">Minimum Specification</span> | <span style="color: #FBC02D;">Recommended Specification</span> |
|
||
| :--- | :--- | :--- |
|
||
| **OS** | Windows 10 (64-bit) | Windows 11 (64-bit) |
|
||
| **RAM** | 8 GB | 16 GB+ (Required for 4K & High-FPS Video) |
|
||
| **GPU** | DirectX 12 Compatible (DML) / NVIDIA GTX 10-Series | NVIDIA RTX 3060+ / AMD RX 6000+ |
|
||
| **VRAM** | 4 GB | 8 GB - 12 GB+ (For Stable Diffusion/Video Interpolation) |
|
||
| **Storage** | 2 GB available space | SSD (Critical for RIFE & Temp Video Processing) |
|
||
| **Architecture** | x64 | x64 (Native DirectML Support) |
|
||
|
||
</div>
|
||
|
||
> **Performance Tip:** Given that **Warlock Studio** leverages **DirectML** for hardware acceleration, keeping your GPU drivers updated is essential for maximizing processing speed across NVIDIA, AMD, and Intel hardware.
|
||
|
||
---
|
||
|
||
## 🤝 Contributions
|
||
|
||
We welcome contributions from the community.
|
||
|
||
📧 Contact: **[negroayub97@gmail.com](mailto:negroayub97@gmail.com)**
|
||
|
||
---
|
||
|
||
## 📜 License & Credits
|
||
|
||
© 2025 **Iván Eduardo Chavez Ayub**
|
||
<br>Licensed under **MIT**. Additional terms and attributions are provided in **NOTICE.md**.
|
||
|
||
### 📊 Integrated Technologies & Licenses
|
||
|
||
| Technology / Model | License | Author / Maintainer | Source |
|
||
| :--- | :--- | :--- | :--- |
|
||
| **Real-ESRGAN** | BSD 3-Clause | Xintao Wang | [GitHub](https://github.com/xinntao/Real-ESRGAN) |
|
||
| • RealESRGANx4 | BSD 3-Clause | Xintao Wang | Same as above |
|
||
| • RealESRNetx4 | BSD 3-Clause | Xintao Wang | Same as above |
|
||
| • RealESR_Gx4 | BSD 3-Clause | Xintao / Community | Same as above |
|
||
| • RealESR_Animex4 | BSD 3-Clause | Community | Same as above |
|
||
| **BSRGAN** | Apache 2.0 | Kai Zhang | [GitHub](https://github.com/cszn/BSRGAN) |
|
||
| • BSRGANx4 | Apache 2.0 | Kai Zhang | Same as above |
|
||
| • BSRGANx2 | Apache 2.0 | Kai Zhang | Same as above |
|
||
| **IRCNN** | BSD / Mixed | Kai Zhang | [GitHub](https://github.com/cszn/IRCNN) |
|
||
| • IRCNN_Mx1 | BSD / Mixed | Kai Zhang | Same as above |
|
||
| • IRCNN_Lx1 | BSD / Mixed | Kai Zhang | Same as above |
|
||
| **GFPGAN** | Apache 2.0 | TencentARC | [GitHub](https://github.com/TencentARC/GFPGAN) |
|
||
| **RIFE** | MIT | Hzwer / Megvii | [GitHub](https://github.com/megvii-research/ECCV2022-RIFE) |
|
||
| **QualityScaler** | MIT | Djdefrag | [GitHub](https://github.com/Djdefrag/QualityScaler) |
|
||
| **FluidFrames** | MIT | Djdefrag | [GitHub](https://github.com/Djdefrag/FluidFrames) |
|
||
| **DirectML** | MIT | Microsoft | [GitHub](https://github.com/microsoft/DirectML) |
|
||
| **ONNX Runtime** | MIT | Microsoft | [GitHub](https://github.com/microsoft/onnxruntime) |
|
||
| **CustomTkinter** | MIT | Tom Schimansky | [GitHub](https://github.com/TomSchimansky/CustomTkinter) |
|
||
| **TkinterDnD2** | MIT | pmgagne | [GitHub](https://github.com/pmgagne/tkinterdnd2) |
|
||
| **OpenCV (cv2)** | Apache 2.0 | OpenCV Team | [Official Site](https://opencv.org/) |
|
||
| **NumPy** | BSD 3-Clause | NumPy Developers | [Official Site](https://numpy.org/) |
|
||
| **Pillow (PIL)** | HPND | Python-Pillow Team | [GitHub](https://github.com/python-pillow/Pillow) |
|
||
| **MoviePy** | MIT | Zulko | [GitHub](https://github.com/Zulko/moviepy) |
|
||
| **FFmpeg** | LGPL / GPL | FFmpeg Team | [Official Site](https://ffmpeg.org) |
|
||
| **ExifTool** | Artistic | Phil Harvey | [Official Site](https://exiftool.org/) |
|
||
| **Psutil** | BSD 3-Clause | Giampaolo Rodola | [GitHub](https://github.com/giampaolo/psutil) |
|
||
| **WMI** | MIT | Tim Golden | [GitHub](https://github.com/tjguk/wmi) |
|
||
| **GPUtil** | MIT | Anders Krogh | [GitHub](https://github.com/anderskm/gputil) |
|
||
| **Requests** | Apache 2.0 | Kenneth Reitz | [GitHub](https://github.com/psf/requests) |
|
||
| **Packaging** | Apache 2.0 | PyPA | [GitHub](https://github.com/pypa/packaging) |
|
||
| **Natsort** | MIT | Seth M. Morton | [GitHub](https://github.com/SethMMorton/natsort) |
|
||
| **Python** | PSF License | Python Software Foundation | [Official Site](https://www.python.org) |
|
||
| **PyInstaller** | GPLv2+ | PyInstaller Team | [GitHub](https://github.com/pyinstaller/pyinstaller) |
|
||
| **Inno Setup** | Custom | Jordan Russell | [Official Site](http://www.jrsoftware.org/isinfo.php) |
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|