Warlock-Studio

AI Media Enhancement Suite

Transform your media with cutting-edge AI technology

---

Warlock-Studio is a powerful, open-source desktop application for Windows that integrates state-of-the-art AI models for video and image enhancement. Inspired by the work of Djdefrag on tools like QualityScaler and FluidFrames, this suite provides a unified, high-performance interface for upscaling, restoration, and frame interpolation.

Version 4.1 builds on previous improvements with enhanced GPU utilization, comprehensive compatibility fixes, and optimization of model loading processes to provide a robust, reliable, and high-performance AI media enhancement experience.

---

► Download Installer (v4.1)

Get the latest stable release from any of the following platforms:

---

Key Features

• State-of-the-Art AI Models A comprehensive suite including Real-ESRGAN, BSRGAN, IRCNN, GFPGAN, and RIFE for denoising, resolution enhancement, detail restoration, upscaling, and smooth frame interpolation.

• AI Face Restoration Restore and enhance faces in old, blurry, or low-quality photos and videos with the integrated GFPGAN model, bringing cherished memories back to life.

• High-Quality Upscaling Models Real-ESRGAN and BSRGAN models provide excellent upscaling capabilities for various image types, from anime to photorealistic content.

• AI Frame Interpolation & Slow Motion Generate new in-between frames using RIFE to create ultra-smooth 2x, 4x, or 8x motion or dramatic slow-motion effects.

• Modern & Intuitive Interface Completely redesigned and refined in v4.0 for a clean, efficient, and user-friendly experience for both beginners and professionals.

• 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.

• Open-Source & Extensible Licensed under the MIT License. Contributions are welcome! Additional usage terms can be found in the NOTICE.md file.

---

What's New in Version 4.1

• 🔧 Model Optimization: Removed SuperResolution-10 model to improve overall performance and reduce complexity. For extreme upscaling needs, we recommend using Real-ESRGAN or BSRGAN models which provide excellent results.
• ✅ Enhanced AI Architecture: Implemented robust ONNX model loading, GPU acceleration support, and comprehensive error handling.
• ✅ Code Quality Improvements: Fixed critical import errors, consolidated duplicate code sections, and improved type annotations for better maintainability.
• ✅ Improved Error Handling: Added graceful degradation mechanisms that prevent crashes and provide meaningful error messages during processing.
• ✅ Streamlined Model Integration: Optimized model integration in the UI and processing pipeline for better performance.
• 🟢 Enhanced GPU Utilization: Improved provider selection logic for better model execution efficiency across different hardware configurations.
• 🚀 Compatibility Fixes: Addressed critical module compatibility by ensuring consistent runtime environment for NumPy and OpenCV libraries.
• 📦 Performance and Stability: Refined memory and resource management, with enhanced error messaging and fallback strategies to ensure robust application performance under varying conditions.
• ✅ User Experience Enhancements: Improved startup reliability and user notifications for smooth interaction and feedback.

---

🌐 Smart Model Distribution System

Version 4.0 introduces a revolutionary approach to AI model distribution:

🎯 Lightweight Installation

• Installer Size: Reduced from 1.4GB to ~450MB (68% size reduction)
• First Launch: AI models (~400MB) download automatically with progress tracking
• Bandwidth Friendly: Users with limited internet can get started faster

🛡️ Reliability Features

• Integrity Validation: Downloaded models are verified for completeness
• Graceful Degradation: Application provides clear feedback if models aren't available
• Offline Mode: Users can manually place model files if needed

---

Interface Previews

🔹 Main View (v4.1)

🔹 RIFE Option

---

How to Use

1. Run as Administrator (optional but recommended for optimal performance).

2. Load Your Media: Select your images and videos to import them into the app.

3. Configure Settings:

   • Select an AI Model (e.g., Real-ESRGAN, BSRGAN, GFPGAN, RIFE).
   • Set the input/output resolution, file format, and toggle features like interpolation or blending.

4. Start Processing: Click "Make Magic" to begin the enhancement.

5. Retrieve Your Files: Processed outputs will be saved in your chosen destination folder.

---

Quality Comparison

Comparison of an enhanced image using the BSRGANx2 model

---

Installation

To get started with Warlock-Studio:

1. Download the installer from the links at the top of this document.
2. Run the installer and follow the setup instructions.
3. Launch the application from the Start Menu or desktop shortcut.

Warlock-Studio uses PyInstaller and Inno Setup for a seamless packaging and installation experience.

Installation Window Previews

---

System Requirements

• Operating System: Windows 10 or later (64-bit)
• Memory (RAM): 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

---

Development Status — v4.1-08.01

Component	Status	Notes
Upscaling Models (ESRGAN, etc.)	🟢 Stable	Fully integrated with dynamic VRAM recovery for enhanced stability.
Optimized Model Suite	🟢 Enhanced	Streamlined AI models for optimal performance and reliability.
Face Restoration (GFPGAN)	🟢 Stable	High-quality face enhancement and restoration capabilities.
Frame Interpolation (RIFE)	🟢 Stable	Includes slow-motion and intermediate frame generation capabilities.
Batch Processing	🟢 Stable	Reliable processing with improved error handling and resource management.
User Interface (UI/UX)	🟢 Refined	Enhanced interface with complete model integration and improved information dialogs.
GPU Management	🟢 Enhanced	Improved AI architecture with robust model loading and graceful degradation.
Code Quality	🟢 Improved	Fixed import errors, consolidated code structure, and enhanced type annotations.
Installer and Packaging	🟢 Stable	Easy-to-use installer for Windows platforms.

---

Project Structure

Warlock-Studio/
├── AI-onnx/                          # Pre-trained ONNX models for AI processing
│   ├── BSRGANx2_fp16.onnx
│   ├── BSRGANx4_fp16.onnx
│   ├── GFPGANv1.4.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/                           # App assets and third-party binaries
│   ├── banner.png
│   ├── clear_icon.png
│   ├── exiftool.exe
│   ├── ffmpeg.exe
│   ├── info_icon.png
│   ├── logo.ico
│   ├── logo.png
│   ├── stop_icon.png
│   ├── upscale_icon.png
│   ├── wizard-image.bmp
│   └── wizard-small.bmp
│
├── rsc/                              # UI images, workflows, and branding
│   ├── badge-color.png
│   ├── Capture.png
│   ├── CaptureRIFE.png
│   ├── google_drive-logo.png
│   ├── WorkflowBSRGAN.png
│   ├── WorkflowIRCNN.png
│   ├── WorkflowRealESRGAN.png
│   ├── WorkflowRIFE.png
│   └── Installation_window2.png
│
├── Manual/                           # LaTeX sources and generated manuals
│   ├── Manual_EN.tex
│   ├── Manual_ES.tex
│   ├── Manual_EN.pdf
│   └── Manual_ES.pdf
│
├── Warlock-Studio.py                 # Main application script
├── Warlock-Studio.spec              # PyInstaller spec file
├── Setup.iss                         # Inno Setup installer script
│
├── README.md                         # Project overview (this file)
├── requirements.txt                  # (Si aplica: dependencias de Python)
├── CHANGELOG.md                      # Version history
├── LICENSE                           # License info (standard)
├── License.txt                       # Additional license details (if needed)
├── NOTICE.md                         # Notices and attributions
├── CODE_OF_CONDUCT.md               # Contributor behavior guidelines
├── CONTRIBUTING.md                  # Contribution guide
└── SECURITY.md                      # Security reporting policies

---

Integrated Technologies & Licenses

Technology	License	Author / Maintainer	Source Code / Homepage
QualityScaler	MIT	Djdefrag	GitHub
RealScaler	MIT	Djdefrag	GitHub
FluidFrames	MIT	Djdefrag	GitHub
Real-ESRGAN	BSD 3-Clause / Apache 2.0	Xintao Wang	GitHub
GFPGAN	Apache 2.0	TencentARC / Xintao Wang	GitHub
RIFE	Apache 2.0	hzwer	GitHub
SRGAN	CC BY-NC-SA 4.0	TensorLayer Community	GitHub
BSRGAN	Apache 2.0	Kai Zhang	GitHub
IRCNN	BSD / Mixed	Kai Zhang	GitHub
Anime4K	MIT	Tianyang Zhang (bloc97)	GitHub
ONNX Runtime	MIT	Microsoft	GitHub
PyTorch	BSD 3-Clause	Meta AI	GitHub
FFmpeg	LGPL / GPL (varies)	FFmpeg Team	Official Site
ExifTool	Perl Artistic License	Phil Harvey	Official Site
DirectML	MIT	Microsoft	GitHub
Python	PSF License	Python Software Foundation	Official Site
PyInstaller	GPLv2+	PyInstaller Team	GitHub
Inno Setup	Custom License	Jordan Russell	Official Site

---

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

---

License

© 2025 Iván Eduardo Chavez Ayub Distributed under the MIT License. Additional terms are available in the NOTICE.md file.