Files
Warlock-Studio-Universal/README.md
T
Iván Eduardo Chavez Ayub d28a8d7d20 Update README.md
2025-11-14 03:59:46 -06:00

12 KiB
Raw Blame History

Warlock-Studio banner

Version License

Platform Python

Last Commit Downloads

Inspired by Djdefrag tools such as QualityScaler and FluidFrames, Warlock-Studio provides a unified, high-performance platform for upscaling, restoration, denoising, and frame interpolation.


Fixed missing audio in generated videos.
Corrected dark output issue in GFPGAN face restoration.
Improved overall stability and synchronization.

See CHANGELOG.md for full details.


📥 Download Installer

Choose your preferred source below:

SourceForge Rising Star Badge Download from GitHub
💡 Both sources provide identical installers — choose your preferred platform.

🖼️ Interface Previews

Main interface


🖼️ Quality Comparison

WsvideovsGit.webm

WsvideovsGit2.webm

Comparison


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.

🖥️ 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

📊 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

📂 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
│   ├── ffmprobe.exe
│   ├── ffmplay.exe
│   ├── info_icon.png
│   ├── logo.ico
│   ├── logo.png
│   ├── stop_icon.png
│   ├── upscale_icon.png
│   ├── wizard-image.bmp
│   └── wizard-small.bmp
│
├── rsc/                              # UI previews and branding resources
│   ├── Capture.png
│   ├── image_comparison.png
│   ├── CaptureCONSOLE.png
│   └── GitHub_Logo_WS.png
│
├── Warlock-Studio.py                 # Main application script
├── Warlock-Studio.spec               # PyInstaller specification file
├── Setup.iss                         # Inno Setup installer script
├── README.md                         # Project overview
├── CHANGELOG.md                      # Version history and updates
├── LICENSE                           # MIT License information
├── NOTICE.md                         # Legal notices and attributions
├── CODE_OF_CONDUCT.md                # Contributor guidelines
├── CONTRIBUTING.md                   # Contribution guide
└── SECURITY.md                       # Security reporting policies

🤝 Contributions

We welcome contributions from the community:

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


📜 License

© 2025 Iván Eduardo Chavez Ayub Licensed under MIT. Additional terms and attributions are provided in NOTICE.md.

📊 Integrated Technologies & Licenses

Technology License Author / Maintainer Source
QualityScaler MIT Djdefrag GitHub
FluidFrames MIT Djdefrag GitHub
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
ONNX Runtime MIT Microsoft GitHub
FFmpeg LGPL / GPL FFmpeg Team Official Site
ExifTool Artistic License Phil Harvey Official Site
Python PSF License Python Software Foundation Official Site
PyInstaller GPLv2+ PyInstaller Team GitHub
Inno Setup Custom Jordan Russell Official Site