Iván Eduardo Chavez Ayub
11 KiB
AI Media Enhancement Suite
Transform your media with cutting-edge AI technology
Warlock-Studio is a professional, open-source desktop application for Windows, designed to integrate state-of-the-art AI models for image and video enhancement.
Inspired by Djdefrag tools such as QualityScaler and FluidFrames, Warlock-Studio provides a unified, high-performance platform for upscaling, restoration, denoising, and frame interpolation.
Version 4.1 introduces enhanced GPU utilization, robust ONNX model loading, and multiple stability and compatibility improvements, ensuring a smoother, faster, and more reliable user experience.
📥 Download Installer (v4.1)
Get the latest stable release from multiple sources:
|
|
|
|
✨ 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.
- Modern UI – Redesigned interface in v4.0 for intuitive workflow and streamlined navigation.
- 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, with a modular architecture for contributors and developers.
🆕 What’s New in v4.1
- 🔧 Removed outdated SuperResolution-10 model to streamline resources.
- ✅ Enhanced ONNX loading with better GPU acceleration.
- ✅ Fixed import and type annotation issues for cleaner code execution.
- ✅ Improved error handling with graceful fallback mechanisms.
- 🟢 Optimized GPU resource management for faster processing.
- 🚀 Compatibility fixes for NumPy and OpenCV.
- 📦 Stability and memory usage improvements for longer sessions.
- ✅ Increased startup reliability with enhanced user notifications.
🌐 Smart Model Distribution System (v4.0+)
🎯 Lightweight Installation
- Installer reduced from 1.4GB → 450MB (–68%) for faster downloads.
- Core AI models (~400MB) downloaded automatically on first launch.
- Bandwidth-friendly and modular setup for selective installation.
🛡️ Reliability
- Integrity checks on downloaded model files.
- Graceful degradation in case of missing models.
- Offline support allows manual placement of model files.
🖼️ Interface Previews
Main Window
RIFE Options
🚀 How to Use
- Run Warlock-Studio as Administrator (recommended for full GPU access).
- Load Media – Import images or videos.
- Configure Processing Settings:
- Select AI model (Real-ESRGAN, GFPGAN, etc.)
- Set resolution, format, frame interpolation, and quality.
- Start Processing using "Make Magic".
- Retrieve the processed results from the designated output folder.
🖼️ Quality Comparison
Enhanced image using BSRGANx2:
📊 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 |
⚙️ Installation
- Download installer (see links above).
- Run the setup wizard and follow prompts.
- Launch via Start Menu or Desktop shortcut.
Warlock-Studio is packaged using PyInstaller and deployed with Inno Setup for seamless installation.
Installer Previews
🖥️ System Requirements
- OS: Windows 10 or higher (64-bit)
- RAM: 8GB+ recommended
- GPU: NVIDIA or DirectML-compatible GPU recommended
- Storage: Sufficient free space for input and processed media
📌 Development Status (v4.1-08.01)
| Component | Status | Notes |
|---|---|---|
| Upscaling Models | 🟢 Stable | Includes VRAM recovery integration |
| Optimized Model Suite | 🟢 Enhanced | Streamlined and reliable |
| 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 integrated models |
| GPU Management | 🟢 Enhanced | Robust ONNX handling and fallbacks |
| Code Quality | 🟢 Improved | Refactored, type-safe, maintainable |
| Installer & Packaging | 🟢 Stable | Smooth setup experience |
📂 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/ # Application 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 previews, workflows, and branding resources
│ ├── 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 specification file
├── Setup.iss # Inno Setup installer script
├── README.md # Project overview
├── requirements.txt # Python dependencies
├── CHANGELOG.md # Version history and updates
├── LICENSE # MIT License information
├── License.txt # Additional license info
├── NOTICE.md # Legal notices and attributions
├── CODE_OF_CONDUCT.md # Contributor guidelines
├── CONTRIBUTING.md # Contribution guide
└── SECURITY.md # Security reporting policies
🔗 Integrated Technologies & Licenses Technology License Author Source Real-ESRGAN BSD/Apache Xintao Wang GitHub
GFPGAN Apache 2.0 TencentARC GitHub
RIFE Apache 2.0 hzwer GitHub
BSRGAN Apache 2.0 Kai Zhang GitHub
IRCNN BSD/Mixed Kai Zhang GitHub
Anime4K MIT bloc97 GitHub
ONNX Runtime MIT Microsoft GitHub
PyTorch BSD-3 Meta AI GitHub
FFmpeg LGPL/GPL FFmpeg Team Site
ExifTool Artistic Phil Harvey Site
PyInstaller GPLv2+ Team GitHub
Inno Setup Custom Jordan Russell Site 🤝 Contributions
We welcome contributions from the community:
Fork the repository.
Create a branch for your feature or bug fix.
Submit a Pull Request with detailed description and testing notes.
📧 Contact: negroayub97@gmail.com
📜 License
© 2025 Iván Eduardo Chavez Ayub Licensed under MIT. Additional terms and attributions are provided in NOTICE.md.
This version preserves all content but enhances technical clarity, professional formatting, and structured readability for developers and end-users.