vlad.os/Warlock-Studio-Universal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Release version v4.2.1 — improvements and fixes

Browse Source
This commit is contained in:
Iván Eduardo Chavez Ayub
2025-10-27 18:04:35 -06:00
parent 8040dd379f
commit df54c7097b
21 changed files with 429 additions and 215 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+94 -101
View File
@@ -5,7 +5,7 @@
### _AI Media Enhancement Suite_
[![Build Status](https://img.shields.io/badge/Build-Stable_Release-0A192F?style=for-the-badge&logo=github&logoColor=FFD700)](https://github.com/Ivan-Ayub97/Warlock-Studio/releases)
[![Version](https://img.shields.io/badge/Version-4.2-FF8C00?style=for-the-badge&logo=git&logoColor=white)](https://github.com/Ivan-Ayub97/Warlock-Studio/releases/tag/4.2)
[![Version](https://img.shields.io/badge/Version-4.2.1-FF4500?style=for-the-badge&logo=git&logoColor=white)](https://github.com/Ivan-Ayub97/Warlock-Studio/releases/tag/4.2.1)
[![License](https://img.shields.io/badge/License-MIT-6A0DAD?style=for-the-badge&logo=open-source-initiative&logoColor=white)](LICENSE)
[![Downloads](https://img.shields.io/github/downloads/Ivan-Ayub97/Warlock-Studio/total?style=for-the-badge&color=FFD700&logo=download&logoColor=black)](https://github.com/Ivan-Ayub97/Warlock-Studio/releases)
@@ -14,19 +14,17 @@
[![Issues](https://img.shields.io/github/issues/Ivan-Ayub97/Warlock-Studio?style=for-the-badge&color=FF4500&logo=github&logoColor=white)](https://github.com/Ivan-Ayub97/Warlock-Studio/issues)
[![Last Commit](https://img.shields.io/github/last-commit/Ivan-Ayub97/Warlock-Studio?style=for-the-badge&color=2E8B57&logo=git&logoColor=white)](https://github.com/Ivan-Ayub97/Warlock-Studio/commits/main)
_Transform your media with cutting-edge AI technology_
---
**Warlock-Studio** is an open-source desktop application for **Windows**, designed to integrate state-of-the-art AI models for **image and video enhancement**.
**Warlock-Studio** is an open-source desktop application for **Windows**, engineered to integrate state-of-the-art AI models for **image and video enhancement**.
Inspired by [Djdefrag](https://github.com/Djdefrag) tools such as **QualityScaler** and **FluidFrames**, Warlock-Studio provides a unified, high-performance platform for **upscaling, restoration, denoising, and frame interpolation**.
Version **4.2** introduces a **full offline installer**, an **advanced ONNX Runtime engine** with DirectML & CUDA support, and significant **packaging optimizations**, ensuring the most reliable and performant experience yet.
Version **4.2.1** delivers critical stability fixes, including the resolution of a major audio failure bug, and introduces a comprehensive Redesign for a modern, high-contrast visual experience.
---
## 📥 Download Installer (v4.2)
## 📥 Download Installer (v4.2.1)
Get the latest stable release from:
@@ -38,7 +36,7 @@ Get the latest stable release from:
</a>
</td>
<td align="center">
<a href="https://github.com/Ivan-Ayub97/Warlock-Studio/releases/download/v4.2/Warlock-Studio-v4.2-Setup.exe">
<a href="https://github.com/Ivan-Ayub97/Warlock-Studio/releases/download/v4.2.1/Warlock-Studio-v4.2.1-Setup.exe">
<img src="rsc/GitHub_Logo_WS.png" alt="Download from GitHub" width="200" />
</a>
</td>
@@ -68,24 +66,32 @@ We highly recommend consulting the official user manual. The documentation provi
## ✨ Key Features
- **AI Upscaling & Restoration** – Utilize **Real-ESRGAN, BSRGAN, 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 and performance.
- **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.
- **AI Upscaling & Restoration** – Utilize **Real-ESRGAN, BSRGAN, 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 and performance.
- **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.
---
## 🆕 What’s New in v4.2
## 🆕 What's New in v4.2.1
- 📦 **Full Offline Installer**: The application is now distributed as a single, self-contained offline installer. All AI models are included, eliminating the need for an internet connection during setup and ensuring a reliable installation.
- 🚀 **Advanced ONNX Runtime Engine**: The model loading architecture was re-engineered to intelligently prioritize hardware acceleration providers (**CUDA** > **DirectML** > **CPU**), maximizing performance on capable hardware and ensuring stability via a robust fallback mechanism.
- ⚙️ **Aggressive Packaging Optimization**: The final application size has been drastically reduced by aggressively pruning unnecessary dependencies from the PyInstaller build, resulting in a lighter and more efficient package.
- 🐛 **Enhanced Runtime Stability**: Added crucial hidden imports to the build process, preventing `ModuleNotFoundError` crashes and ensuring all components of `onnxruntime` and other libraries load correctly.
- 🖥️ **Improved Debugging Experience**: The application now runs with an attached console window, providing real-time logs and error messages for easier troubleshooting.
- ✨ **Professional Splash Screen**: A new startup splash screen provides immediate visual feedback while the application initializes, improving the user experience.
This maintenance release focuses on critical stability, usability, and a significant visual overhaul.
### Stability & Usability Fixes
- **✅ Critical Audio Fix:** Resolved a major bug that caused all generated videos to be encoded without an audio track. The missing `ffprobe.exe` binary has been restored, ensuring proper audio stream detection and passthrough/re-encoding.
- **✅ UI State Resilience:** Fixed an issue where conflicting AI model settings (e.g., blending and frame interpolation options) could persist incorrectly when switching between model types, preventing invalid setting combinations.
- **✅ Robust Thumbnails:** Reworked the file thumbnail generation process (`FileWidget.extract_file_icon`) to be more robust, preventing potential crashes related to `Pillow`/`numpy` compatibility issues during image conversion.
- **✅ Fixed Window Size:** The main application window is now non-resizable (`window.resizable(False, False)`) to ensure a stable and predictable UI layout, preventing widget placement errors.
- **✅ Dialog Behavior:** Removed the aggressive "always-on-top" flag (`-topmost`) from dialog windows, ensuring they behave as standard application-modal windows.
### Visual & Thematic Redesign
- **🔥 "DarkRed" Theme:** Introduced a significant visual overhaul with a high-contrast, dark-mode palette. The theme uses a deep red background (`#480B0B`) with bright yellow (`#FFE32C`) and white text for enhanced readability and a distinct, technical aesthetic.
- **💻 Monospaced Font:** Changed the global font from `"Segoe UI"` to `"Consola"` for a uniform, technical look across all UI elements, enhancing readability for file names and status messages.
---
@@ -101,13 +107,13 @@ We highly recommend consulting the official user manual. The documentation provi
## 🚀 How to Use
1. Run Warlock-Studio as **Administrator** (recommended for full GPU access).
2. **Load Media** – Import images or videos.
3. **Configure Processing Settings**:
- Select AI model (Real-ESRGAN, GFPGAN, etc.)
- Set resolution, format, frame interpolation, and quality.
4. **Start Processing** using **"Make Magic"**.
5. Retrieve the processed results from the designated output folder.
1. Run Warlock-Studio as **Administrator** (recommended for full GPU access).
2. **Load Media** – Import images or videos.
3. **Configure Processing Settings**:
- Select AI model (Real-ESRGAN, GFPGAN, RIFE, etc.)
- Set resolution, format, frame interpolation, and quality.
4. **Start Processing** using **"Make Magic"**.
5. Retrieve the processed results from the designated output folder.
---
@@ -116,30 +122,34 @@ We highly recommend consulting the official user manual. The documentation provi
Enhanced image using **BSRGANx2**:
![Comparison](rsc/image_comparison.png)
AI-Driven Visual Transformation: Before & After (**Click on the image to open the video on YouTube**)
[![Watch the video](https://img.youtube.com/vi/kJOcctTM32c/hqdefault.jpg)](https://youtu.be/kJOcctTM32c)
---
## 📊 Model Comparison
| Model File | Use Case | Speed | Quality | Notes |
| -------------------------- | ------------------------------ | --------- | --------- | ----------------------------------- |
| **GFPGANv1.4** | Face restoration | High | High | Optimal for portraits |
| **BSRGANx2** | 2× upscale + denoising | Medium | Very High | Suitable for lightly degraded media |
| **BSRGANx4** | 4× upscale + denoising | Low | Very High | For heavily degraded content |
| **RIFE** | Frame interpolation | High | High | Smooth motion, slow-motion support |
| **RIFE-Lite** | Lightweight interpolation | Very High | Medium | Faster, lower resource usage |
| **RealESRGANx4** | General 4× upscaling | Medium | High | Balanced performance |
| **RealESRNetx4** | Subtle restoration | Medium | High | Preserves natural image texture |
| **RealSRx4_Anime** | Anime / line-art enhancement | Medium | High | Sharp edges for 2D art |
| **IRCNN_L** | Light denoising | High | Medium | Mild artifact removal |
| **IRCNN_M** | Medium denoising | High | Medium | Stronger artifact cleanup |
| Model File | Use Case | Speed | Quality | Notes |
| :----------------- | :--------------------------- | :-------- | :-------- | :---------------------------------- |
| **GFPGANv1.4** | Face restoration | High | High | Optimal for portraits |
| **BSRGANx2** | 2× upscale + denoising | Medium | Very High | Suitable for lightly degraded media |
| **BSRGANx4** | 4× upscale + denoising | Low | Very High | For heavily degraded content |
| **RIFE** | Frame interpolation | High | High | Smooth motion, slow-motion support |
| **RIFE-Lite** | Lightweight interpolation | Very High | Medium | Faster, lower resource usage |
| **RealESRGANx4** | General 4× upscaling | Medium | High | Balanced performance |
| **RealESRNetx4** | Subtle restoration | Medium | High | Preserves natural image texture |
| **RealSRx4_Anime** | Anime / line-art enhancement | Medium | High | Sharp edges for 2D art |
| **IRCNN_L** | Light denoising | High | Medium | Mild artifact removal |
| **IRCNN_M** | Medium denoising | High | Medium | Stronger artifact cleanup |
---
## ⚙️ Installation
1. **Download the Full Offline Installer** (see links above).
2. Run the **setup wizard** and follow the prompts.
3. Launch via Start Menu or Desktop shortcut.
1. **Download the Full Offline Installer** (see links above).
2. Run the **setup wizard** and follow the prompts.
3. Launch via Start Menu or Desktop shortcut.
> Warlock-Studio is packaged using **PyInstaller** and deployed with **Inno Setup** for a seamless, self-contained installation experience.
@@ -147,29 +157,31 @@ Enhanced image using **BSRGANx2**:
## 🖥️ System Requirements
- **OS:** Windows 11 or higher (64-bit)
- **RAM:** 8GB+ recommended
- **GPU:** NVIDIA (for CUDA), AMD, or Intel GPU with up-to-date drivers recommended
- **Storage:** Sufficient free space for input and processed media
- **OS:** Windows 11 or higher (64-bit)
- **RAM:** 8GB+ recommended
- **GPU:** NVIDIA (for CUDA), AMD, or Intel GPU with up-to-date drivers recommended
- **Storage:** Sufficient free space for input and processed media
---
## 📌 Development Status (v4.2)
## 📌 Development Status (v4.2.1)
| Component | Status | Notes |
| ---------------------------- | ----------- | -------------------------------------------------------- |
| ONNX Runtime Engine | 🟢 Enhanced | Prioritizes CUDA > DirectML > CPU with automatic fallback. |
| Installer & Packaging | 🟢 Overhauled | Full offline installer; heavily optimized package size. |
| Upscaling Models | 🟢 Stable | Includes VRAM recovery integration. |
| Face Restoration (GFPGAN) | 🟢 Stable | High-quality face reconstruction. |
| Frame Interpolation (RIFE) | 🟢 Stable | Smooth motion and slow-motion support. |
| Batch Processing | 🟢 Stable | Improved error handling and logging. |
| User Interface (UI/UX) | 🟢 Refined | Clean, modern design with splash screen. |
| Code Quality | 🟢 Improved | Refactored, modular, and more maintainable. |
| Component | Status | Notes |
| :-------------------------- | :------------ | :---------------------------------------------------------------- |
| ONNX Runtime Engine | 🟢 Enhanced | Prioritizes CUDA > DirectML > CPU with automatic fallback. |
| Installer & Packaging | 🟢 Overhauled | Full offline installer; heavily optimized package size. |
| **Video Audio Passthrough** | **✅ Fixed** | **Resolved critical failure to include audio in encoded videos.** |
| **UI State Persistence** | **✅ Fixed** | **Settings no longer conflict when switching AI models.** |
| Upscaling Models | 🟢 Stable | Includes VRAM recovery integration. |
| Face Restoration (GFPGAN) | 🟢 Stable | High-quality face reconstruction. |
| Frame Interpolation (RIFE) | 🟢 Stable | Smooth motion and slow-motion support. |
| User Interface (UI/UX) | 🟢 Redesigned | **New high-contrast "Inferno" theme.** |
| Code Quality | 🟢 Improved | Refactored, modular, and more maintainable. |
---
## 📂 Project Structure
</div>
```
@@ -193,6 +205,8 @@ Warlock-Studio/
│ ├── clear_icon.png
│ ├── exiftool.exe
│ ├── ffmpeg.exe
│ ├── ffmprobe.exe
│ ├── ffmplay.exe
│ ├── info_icon.png
│ ├── logo.ico
│ ├── logo.png
@@ -218,27 +232,28 @@ Warlock-Studio/
├── CONTRIBUTING.md # Contribution guide
└── SECURITY.md # Security reporting policies
```
<div align="center">
---
## 📊 Integrated Technologies & Licenses
| Technology | License | Author / Maintainer | Source |
| --------------- | ------------------- | ---------------------------------------- | ------------------------------------------------------------ |
| QualityScaler | MIT | [Djdefrag](https://github.com/Djdefrag) | [GitHub](https://github.com/Djdefrag/QualityScaler) |
| FluidFrames | MIT | [Djdefrag](https://github.com/Djdefrag) | [GitHub](https://github.com/Djdefrag/FluidFrames) |
| Real-ESRGAN | BSD 3-Clause / Apache | Xintao Wang | [GitHub](https://github.com/xinntao/Real-ESRGAN) |
| GFPGAN | Apache 2.0 | TencentARC / Xintao Wang | [GitHub](https://github.com/TencentARC/GFPGAN) |
| RIFE | Apache 2.0 | hzwer | [GitHub](https://github.com/megvii-research/ECCV2022-RIFE) |
| BSRGAN | Apache 2.0 | Kai Zhang | [GitHub](https://github.com/cszn/BSRGAN) |
| IRCNN | BSD / Mixed | Kai Zhang | [GitHub](https://github.com/cszn/IRCNN) |
| ONNX Runtime | MIT | Microsoft | [GitHub](https://github.com/microsoft/onnxruntime) |
| FFmpeg | LGPL / GPL | FFmpeg Team | [Official Site](https://ffmpeg.org) |
| ExifTool | Artistic License | Phil Harvey | [Official Site](https://exiftool.org/) |
| 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) |
| Technology | License | Author / Maintainer | Source |
| ------------- | --------------------- | --------------------------------------- | ---------------------------------------------------------- |
| QualityScaler | MIT | [Djdefrag](https://github.com/Djdefrag) | [GitHub](https://github.com/Djdefrag/QualityScaler) |
| FluidFrames | MIT | [Djdefrag](https://github.com/Djdefrag) | [GitHub](https://github.com/Djdefrag/FluidFrames) |
| Real-ESRGAN | BSD 3-Clause / Apache | Xintao Wang | [GitHub](https://github.com/xinntao/Real-ESRGAN) |
| GFPGAN | Apache 2.0 | TencentARC / Xintao Wang | [GitHub](https://github.com/TencentARC/GFPGAN) |
| RIFE | Apache 2.0 | hzwer | [GitHub](https://github.com/megvii-research/ECCV2022-RIFE) |
| BSRGAN | Apache 2.0 | Kai Zhang | [GitHub](https://github.com/cszn/BSRGAN) |
| IRCNN | BSD / Mixed | Kai Zhang | [GitHub](https://github.com/cszn/IRCNN) |
| ONNX Runtime | MIT | Microsoft | [GitHub](https://github.com/microsoft/onnxruntime) |
| FFmpeg | LGPL / GPL | FFmpeg Team | [Official Site](https://ffmpeg.org) |
| ExifTool | Artistic License | Phil Harvey | [Official Site](https://exiftool.org/) |
| 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) |
---
@@ -246,9 +261,11 @@ Warlock-Studio/
We welcome contributions from the community:
1. **Fork** the repository.
2. **Create a branch** for your feature or bug fix.
3. **Submit a Pull Request** with a detailed description and testing notes.
**Fork** the repository.
**Create a branch** for your feature or bug fix.
**Submit a Pull Request** with a detailed description and testing notes.
📧 Contact: **[negroayub97@gmail.com](mailto:negroayub97@gmail.com)**
@@ -260,27 +277,3 @@ We welcome contributions from the community:
Licensed under **MIT**. Additional terms and attributions are provided in `NOTICE.md`.
</div>