Introduction - Musfiq0/enhanced-screens-comparison GitHub Wiki

📖 Introduction

What is Enhanced Screenshot Comparison Tool?

Enhanced Screenshot Comparison Tool is a powerful, cross-platform application designed to automate the process of comparing video quality across multiple sources. Whether you're comparing different video releases, evaluating encoding quality, or analyzing source material, this tool streamlines the entire workflow from screenshot generation to sharing results.

Now supporting Windows, macOS, Linux, and Docker containers - making high-quality video comparison accessible to everyone, everywhere! 🌍

🎯 Purpose

TL;DR: Load videos → Get comparison screenshots → Automatic upload → Share with friends! 📈

The tool was created to solve a common problem in the video enthusiast community: manually creating comparison screenshots is time-consuming and tedious. Instead of writing VapourSynth/AviSynth scripts for each comparison, this tool automates the entire process and even uploads the results to slow.pics automatically!

Now with three powerful interfaces: Modern GUI for visual users, Interactive CLI for guided workflows, and Professional CLI for automation - all working seamlessly across every major platform! 🎭

🌟 Core Concept

The application takes multiple video files as input and generates high-quality comparison screenshots at specified timestamps. These screenshots can then be automatically uploaded to comparison hosting services, making it easy to share and analyze video quality differences.

🎭 Who Is This For?

  • Video Enthusiasts: Compare different releases of movies/anime across any platform
  • Encoders: Validate encoding quality against source material with professional tools
  • Content Creators: Analyze video quality for production workflows
  • Quality Assurance: Compare streaming vs physical media with automated processing
  • DevOps/CI-CD Teams: Automate quality testing in containerized environments
  • Cross-Platform Users: Work seamlessly on Windows, macOS, Linux, or Docker
  • Anyone: Who needs efficient, professional video quality comparison

🚀 Key Benefits

⏱️ Time Saving

  • Automates screenshot generation across multiple videos
  • Eliminates manual script writing
  • Advanced CLI for batch processing and automation
  • One-click upload and sharing
  • Docker containerization for deployment automation

🎨 Quality Focused

  • Multiple processing backends (VapourSynth, OpenCV, PIL)
  • Smart cropping to remove letterboxes and logos
  • Intelligent resizing with aspect ratio preservation
  • High-quality PNG output
  • Professional video processing capabilities

👥 User Friendly

  • Three Interface Options: GUI, Interactive CLI, and Professional CLI
  • Cross-platform native experience on all operating systems
  • Drag & drop support for quick file addition
  • Comprehensive crop presets for common scenarios
  • Intuitive workflow with progress tracking
  • Automatic platform detection and setup

🔧 Flexible & Portable

  • True Cross-Platform: Windows, macOS, Linux, Docker
  • Supports virtually all video formats
  • Configurable frame selection (intervals or custom timestamps)
  • Customizable output resolutions
  • Optional automatic upload integration
  • Professional automation with configuration files
  • Container-ready for scalable deployments

🛠️ Technical Foundation

The tool is built on Python with a robust, cross-platform architecture supporting multiple video processing backends:

🎬 Video Processing Backends

  • VapourSynth: High-quality professional video processing (optional)
  • OpenCV: Reliable computer vision library (default)
  • PIL: Basic image processing (fallback)

🖥️ Platform Support

  • Windows: Native GUI with .exe building capabilities
  • macOS: Native .app bundles with Cocoa integration
  • Linux: AppImage/binary distribution with X11 GUI support
  • Docker: Containerized deployment with X11 forwarding for GUI

🎭 Multiple Interfaces

  • GUI Mode: Modern drag & drop interface with visual feedback
  • Interactive CLI: Guided command-line with step-by-step prompts
  • Professional CLI: Full automation support with configuration files

This multi-backend, cross-platform approach ensures compatibility across different systems while providing optimal quality when advanced libraries are available.

📈 Evolution

Enhanced Screenshot Comparison Tool has evolved from a simple screenshot utility to a comprehensive, cross-platform video comparison suite featuring:

Version History

  • v1.0: Foundation release with basic VapourSynth support
  • v1.5: Dynamic fallback system with OpenCV and PIL backends
  • v2.0: Modern GUI renaissance with drag & drop functionality
  • v3.2: Professional CLI with automation and configuration support
  • v3.3: Cross-platform revolution with universal compatibility

Current Capabilities

  • Cross-Platform Native Support: Windows, macOS, Linux, Docker
  • Three Professional Interfaces: GUI, Interactive CLI, Professional CLI
  • Advanced Video Processing: Multi-backend architecture with intelligent fallbacks
  • Professional Automation: Configuration files, batch processing, CI/CD integration
  • Container Deployment: Full Docker support with GUI capabilities
  • Build System: Platform-specific executable/app bundle creation
  • Intelligent Setup: Automatic platform detection and configuration

🎯 Getting Started

Ready to dive in? Check out:

Installation Guides

Feature & Usage Guides

Interface Guides

The tool that makes video comparison actually enjoyable! ✨