vlad.os/Warlock-Studio-Universal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
90e9ca0b8b8f90a19d076c39a7daca9640083521
Warlock-Studio-Universal/README.md
T
Iván Eduardo Chavez Ayub 4fd2d81c83 Update README.md
2025-07-20 03:52:04 -06:00

16 KiB
Raw Blame History

Warlock-Studio banner

🎭 Warlock-Studio

AI Media Enhancement Suite

Build Status Version License Downloads

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.0 continues this evolution with the addition of SuperResolution-10 model integration, enhanced AI architecture, and improved code stability for even better performance and reliability.

► Download Installer (v4.0) - Now Lightweight

🚀 NEW: Installer size reduced from 1.4GB to ~300MB! AI models (150MB) are automatically downloaded when first launched.

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

Download Warlock-Studio Download from GitHub

Key Features

  • State-of-the-Art AI Models A comprehensive suite including Real-ESRGAN, BSRGAN, IRCNN, GFPGAN, RIFE, and SuperResolution-10 for denoising, resolution enhancement, detail restoration, extreme 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.

  • SuperResolution-10 Model (New in v4.0) Extreme 10x upscaling capabilities specifically designed for very low-resolution images, perfect for bringing old photos back to life with exceptional detail.

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

  • ✅ SuperResolution-10 Model: Added support for the SuperResolution-10 model, providing extreme 10x upscaling capabilities specifically designed for very low-resolution images.
  • ✅ Enhanced AI Architecture: Implemented the missing AI_model_base class with 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.
  • ✅ Complete Model Integration: SuperResolution-10 is fully integrated into the UI, processing pipeline, and information dialogs with proper VRAM management.
  • 🚀 Smart Model Distribution: New lightweight installer (300MB vs 1.4GB) with automatic AI model download system that fetches models on first launch.
  • 📦 Optimized Packaging: Enhanced PyInstaller configuration excludes AI models from executable, significantly reducing download and installation time.

🌐 Smart Model Distribution System

Version 4.0 introduces a revolutionary approach to AI model distribution:

🎯 Lightweight Installation

  • Installer Size: Reduced from 1.4GB to ~300MB (78% size reduction)
  • First Launch: AI models (327MB) 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.0)

Screenshot of Warlock-Studio's main interface

🔹 RIFE Option

Screenshot of Warlock-Studio showing RIFE options

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 Quality Comparison

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

Screenshot of the installer window Screenshot of the installer window part 2

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.0-07.25

Component Status Notes
Upscaling Models (ESRGAN, etc.) 🟢 Stable Fully integrated with dynamic VRAM recovery for enhanced stability.
SuperResolution-10 Model 🟢 New Extreme 10x upscaling for very low-resolution images with robust error handling.
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/
   │
   └──├──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
      └──super-resolution-10.onnx
├──Assets/
   │
   └──├──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/
   │
   └──├──badge-color.png
      ├──Capture.png
      ├──CaptureRIFE.png
      ├──google_drive-logo.png
      ├──WorkflowBSRGAN.png
      ├──WorkflowIRCNN.png
      ├──WorkflowRealESRGAN.png
      ├──WorkflowRIFE.png
      └──Installation_window2.png
├──Manual/
   │
   └──├──Manual_EN.pdf
      ├──Manual_EN.tex
      ├──Manual_ES.pdf
      └──Manual_ES.tex
│
├──CHANGELOG.md
├──CODE_OF_CONDUCT.md
├──CONTRIBUTING.md
├──LICENSE
├──License.txt
├──NOTICE.md
├──README.md                 # This File
├──SECURITY.md
├──Setup.iss
├──Manual_ES.pdf
├──Manual_EN.pdf
├──Warlock-Studio.py         # Main
└──Warlock-Studio.spec

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
Super Resolution 10 MIT ONNX Model Zoo Contributors 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.

Reference in New Issue View Git Blame Copy Permalink