Iván Eduardo Chavez Ayub
13 KiB
13 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 / Maintainer | Source |
|---|---|---|---|
| Real-ESRGAN | BSD 3-Clause / Apache | Xintao Wang | GitHub |
| GFPGAN | Apache 2.0 | TencentARC / Xintao Wang | 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-Clause | Meta AI | GitHub |
| FFmpeg | LGPL / GPL | FFmpeg Team | Official Site |
| ExifTool | 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 | Jordan Russell | Official 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.