Skip to content
hadooooooukenPublic

About

Fast, lightweight, and beautiful image viewer for Windows. Features high-quality image scaling, real-time AI upscaling (Upscayl), shader color adjustments, 360° spherical panorama, HDR tone-mapping, and native support for AVIF, JXL, HEIF, PSD, DDS, and RAW.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

Wynpix logo

Wynpix

Version Platform C++ Qt CPU GPU AI Upscaling


A fast, Windows-optimized image viewer built for speed, visual fidelity, and modern formats.
Featuring real-time AI upscaling (Upscayl), GPU-accelerated MKS2021 scaling, shader color adjustments,
360° spherical panorama viewing, HDR tone-mapping, ComfyUI workflow inspection, and a multi-threaded batch converter.

Download Latest Release

Wynpix Main Viewer

Key features

  • Simple UI & Fast: Lightweight and highly responsive interface.

  • High-Quality Image Scaling: Every viewer filter runs on the GPU: MKS2021 (Magic Kernel Sharp 2021, the default), FidelityFX CAS, Smart sharpen, Bilinear and Nearest. The batch converter and the resize dialog scale on the CPU with an AVX2-optimized MKS2021.

  • Real-Time AI Upscaling (Upscayl): Real-time AI image upscaling powered by upscayl-ncnn (NCNN/Vulkan & RealESRGAN). Upscales only the visible viewport crop to conserve VRAM, using background threads to keep the UI fully responsive. Includes an optional preloading mechanism to warm up Vulkan shader pipelines and eliminate startup latency.

  • Real-Time Color Adjustments: Instant, lag-free adjustments of Brightness, Contrast, Saturation, Hue, Exposure, Temperature, and Tint calculated on the graphics card via shaders. Features an interactive overlay with a "Compare" button (press and hold to view the original), Apply and Reset buttons, and double-click slider resets.

  • 360-Degree Spherical Panorama View: Interactive drag-and-look viewer for spherical panoramic photos, with the same real-time color adjustments as the regular view.

  • Native Support for Modern Formats: Out-of-the-box support for AVIF, HEIF/HEIC, JPEG XL (JXL), JPEG XR, JPEG 2000 (.jp2, .j2k, .jpf, .jpx, .jpc), HTJ2K (.jph), PSD, XCF, DDS, RAW, KRA, ORA, QOI, DjVu, and images inside ZIP/CBZ, 7z and RAR archives.

  • Modern CPU Optimization: Compiled with AVX2 support for high-speed image processing on modern processors. A separate SSE2 build is available for older PCs (see Installation).

  • Batch Image Converter: Multi-threaded background queue to convert, resize, rename, adjust colors, and AI-upscale multiple images.

  • Image Info Panel: Displays EXIF/metadata for the current image. For PNG files generated by ComfyUI, automatically parses embedded KSampler workflow data and presents generation parameters (model, sampler, steps, CFG scale, seed, positive/negative prompts) in a structured view.

  • Display Color Management: Dynamic source-to-target color mapping that queries the system's primary monitor ICC profile. Supports standard preset spaces (sRGB, Adobe RGB, Display P3, etc.) or custom ICC/ICM files.

  • HDR Tone-Mapping: Built-in tone-mapping pipeline for high-dynamic-range images, including 10-bit/12-bit AVIF HDR with Rec.2100 PQ or HLG transfer, OpenEXR, and Radiance HDR. Supports ITU-R BT.2408, Reinhard-Jodie, ACES Filmic, and Hable (Uncharted 2) operators with configurable target white levels.

  • Fully Configurable: Highly customizable keyboard shortcuts, theme modes (System Auto, Dark, Light), custom accent colors, and background preferences.

  • Basic Image Editing: Quick crop, rotate, and resize operations.

  • Folder View Mode: Seamless grid browsing with support for left mouse button rectangular selection and options to open only selected files (including folders). Features a format-filter dropdown to narrow the file list to a specific image format group (e.g. HEIF/HEIC, RAW, PNG).

  • Quick Copy / Move: Easily categorize or organize your files into configurable folders.

  • Open with: Launch the current image in an external application or custom command.

  • Multilingual UI: Interface available in 9 languages — English, German, French, Spanish, Ukrainian, Russian, Japanese, Turkish, and Simplified Chinese.

Default control scheme

Action Shortcut
Next image Right arrow / Mouse forward button
Previous image Left arrow / Mouse back button
Goto first image Home
Goto last image End
Zoom in MouseWheel / Ctrl+Up / + / =
Zoom out MouseWheel / Ctrl+Down / -
Zoom at cursor Ctrl+MouseWheel
Zoom (alt. method) Hold right mouse button & move up / down
Next / Previous image (gesture) Hold right mouse button & move left / right
Fit mode: window 1 / Down
Fit mode: width 2
Fit mode: 1:1 (no scaling) 3 / Up / DoubleClick
Fit mode: height 4
Switch fit modes Space
Toggle fullscreen mode F / Enter
Toggle fullscreen info bar Shift+F
Show Image Info panel I
Crop image X
Resize image R
Flip horizontally H
Flip vertically V
Rotate left Ctrl+L
Rotate Right Ctrl+R
Open containing directory Ctrl+D
Slideshow mode ` (backtick)
Shuffle mode Ctrl+`
Quick copy C
Quick move M
Move to trash Delete
Delete file Shift+Delete
Save Ctrl+S
Save As Ctrl+Shift+S
Discard edits Ctrl+Z
Copy image to clipboard Ctrl+C
Copy viewport to clipboard Shift+C
Copy path to clipboard Ctrl+Shift+C
Paste file from clipboard Ctrl+V
Set as wallpaper Ctrl+W
Rename file F2
Reload image F5
Next directory Shift+Right
Previous directory Shift+Left
Folder view Backspace / Esc / MiddleClick
Print / Export PDF Ctrl+P
Toggle scaling filter (nearest / configured) N
Cycle scaling filter Shift+N
Toggle Use Upscayl Alt+I
Cycle upscaler models Alt+Shift+I
Toggle HDR Tone-Mapping Alt+H
Settings P
Exit application Ctrl+Q / Alt+X
Toggle panorama mode Shift+P
Panorama: Look around Click & drag mouse (360° view)
Panorama: Zoom MouseWheel (360° view)
Page Navigation , . (< >)
... and more.

Note: you can configure every shortcut by going to Settings > Controls.

User interface

The idea is to have an uncluttered, simple and easy to use UI. You can see UI elements only when you need them.

There is a pull-down panel with thumbnails, as well as folder view. You can also bring up a context menu via right click.

Wynpix Folder View with Folder Thumbnails

Using quick copy / quick move panels

Bring up the panel with C or M shortcut. You will see 9 destination directories, click on the folder icon to change them.

With panel visible, use 1 - 9 keys to copy/move current image to corresponding directory.

When you are done press C or M again to hide the panel.

Open with

You can open the current image in external applications or run custom commands on it.

Open Settings > Scripts. Press Add. Here you can choose between a command and a script file.

Example of a command (using %file% as a placeholder for the image path):

magick %file% %file%_.pdf

Example of a Windows batch script (.bat or .cmd, where %1 is the image path):

@echo off
"C:\Program Files\GIMP 2\bin\gimp-2.10.exe" "%1"

Note: On Windows, you can use standard batch files (.bat / .cmd) directly. For PowerShell (.ps1) or Python (.py) scripts, you should configure them as a command (e.g. powershell -File C:\script.ps1 %file%).

When you've created your script go to Settings > Controls > Add, then select it and assign a shortcut like for any regular action.

Theme & UI Customization

Wynpix offers modern options to personalize your image viewing experience:

  • Theme Mode Selector: Under Settings > Theme, switch between:

    • System Default (Auto): Follows Windows system light or dark preferences.
    • Dark: Forces a dark appearance.
    • Light: Forces a light appearance.
  • Custom Accent Color: Choose a custom accent color under settings to match your personal setup.

  • Black Background Option: Enable "Use black for background and thumbnail bar" to override the theme colors and keep the focus entirely on the image viewport.

Scaling and Sharpening Filters

The viewer renders every image on the GPU through Qt Quick (Direct3D 11 by default; Direct3D 12 or Vulkan can be selected with the quickGraphicsApi key in the configuration file). All viewer filters run on the GPU; choose one under Settings > View > Scaling quality, toggle between Nearest and the configured filter with N, or cycle through them with Shift+N:

  • Magic Kernel Sharp 2021 (Default): The default high-quality scaling and sharpening filter. While the view moves, the image is shown with trilinear filtering; once it rests, the MKS2021 resampling kernel draws the final frame. When zoomed in, the kernel also runs while the view moves.

  • FidelityFX Contrast Adaptive Sharpening (CAS): Trilinear scaling with AMD's Contrast Adaptive Sharpening.

  • Smart sharpen: Trilinear scaling with an adaptive sharpening pass.

  • Bilinear: Smooth, mipmapped scaling without sharpening.

  • Nearest: Pixel-exact nearest-neighbor scaling.

The batch converter and the resize dialog scale on the CPU (Nearest, Bilinear, Smart sharpen and an AVX2-optimized MKS2021, the default).

Real-Time AI Upscaling

Wynpix integrates upscayl-ncnn (NCNN/Vulkan & RealESRGAN) for real-time AI image upscaling:

  • Viewport Crop Upscaling: Conserves GPU resources and VRAM by upscaling only the currently visible region of the image.

  • Vulkan GPU Acceleration: Heavy lifting is performed on background GPU threads, ensuring the main user interface remains smooth and interactive.

  • Model Options:

    • 4xLSDIRCompactC3 (Default): Included by default. Optimized for JPEG artifacts and general image restoration.
    • Custom Models Support: The application dynamically scans the models/ directory. You can easily add more compatible models (e.g. from the Upscayl Custom Models repository) by placing their .param and .bin files into the models/ folder. They will be automatically detected and made available in the settings menu.
  • VRAM Safety & Limits: Auto-tile detection and input limits prevent out-of-memory errors on a wide range of GPUs.

  • Vulkan Preloading: The optional "Load engine at startup and keep ready in video memory" setting pre-warms the engine at startup to pre-allocate memory and eliminate initial rendering lag.

  • Zoom Threshold: Upscaling can be limited to zoom levels above a configurable value.

  • Settings & Hotkeys: Configure everything under Settings > AI Upscale. Press Alt + I to instantly toggle AI upscaling and Alt + Shift + I to cycle through the installed models.

Real-Time AI Upscaling

Real-Time Color Adjustments

Wynpix provides instant, lag-free adjustments calculated directly on the graphics card using GPU shaders:

  • Interactive HUD Overlay: Adjust Brightness, Contrast, Saturation, Hue, Exposure, Temperature, and Tint on the fly.
  • Instant A/B Comparison: Press and hold the Compare button to instantly see the original unadjusted image.
  • Fast Reset & Apply: Apply adjustments directly to your viewing session or double-click any slider to reset it to default.

Real-Time Shader Color Adjustments

360-Degree Spherical Panorama View

Interactive drag-and-look viewer for equirectangular 360° panoramic photographs:

  • Smooth Navigation: Click and drag to look around in full spherical 360° space; zoom with the mouse wheel.
  • GPU-Accelerated: Fluid real-time projection rendering, fully compatible with shader-based color adjustments.
  • Hotkeys: Press Shift + P to instantly enter or exit panorama mode.

360-Degree Spherical Panorama View

Batch Image Converter

Multi-threaded background queue processor:

  • Interactive Selection: Includes filename, thumbnail, original format, and size info with checkboxes to filter the queue. Access this by selecting multiple files in Folder View and clicking Batch convert.

  • Output Options: Target path selection, filename pattern templates (e.g. {name}), optional timestamped subdirectories (Batch_YYYY-MM-DD_HH-MM-SS), and file overwrite settings.

  • Formats: Converts to JPEG, PNG (with 0-9 compression level slider; uses libdeflate for significantly faster export when deflate.dll is present), WebP, JPEG-XL (JXL), AVIF, BMP, TIFF, and QOI with custom quality sliders.

  • Resizing: Scaling by percentage or custom resolution, presets, aspect ratio lock, and quick enforcers ("Fit Desktop" / "Fill Desktop").

  • Scaling Filters: Supports CPU filters (Nearest, Bilinear, Smart sharpen, and MKS2021, the default) and Vulkan-accelerated AI Upscaling (Upscayl) using customizable models such as 4xLSDIRCompactC3.

  • Color Correction: Applies Exposure, Contrast, Brightness, Saturation, Hue, Temperature, and Tint adjustments. Includes a one-click reset button to clear all sliders.

Batch Image Converter

Image Info & ComfyUI Workflow Inspector

Press I to open the comprehensive image information panel:

  • Metadata & EXIF: Inspect image dimensions, format, bit depth, color profile, and full camera EXIF attributes (lens, focal length, ISO, exposure time, aperture).
  • ComfyUI Generation Data: For PNG images generated with ComfyUI, Wynpix automatically detects embedded KSampler workflow metadata and displays model checkpoints, CLIP/VAE models, samplers, schedulers, seeds, steps, CFG scale, denoise settings, and full positive/negative prompt text in a clean structured view.

Image Info and ComfyUI Workflow Inspector

Display Color Management

Color space translation between source image and active display:

  • Activation: Toggle via Settings > View > Color Management.

  • Display Profiles:

    • System / Auto (Recommended): Queries the primary monitor's system ICC profile.
    • Preset spaces: sRGB, Display P3, Adobe RGB, Rec. 2020, ProPhoto RGB, and Linear sRGB.
    • Custom target: Browse and load custom .icc or .icm files from disk.
  • Mapping: Reads embedded source ICC profile and converts it to the display space. Images without an embedded profile are assumed to be standard sRGB.

HDR Tone-Mapping

Advanced tone-mapping pipeline to accurately view High Dynamic Range (HDR) content on SDR displays:

  • Activation: Toggle in Settings > View > HDR Tone-Mapping or instantly via hotkey (Alt + H).

  • Supported Formats & Profiles: Detects and decodes HDR metadata across formats, including AVIF HDR (10-bit / 12-bit Rec.2100 PQ / HDR10, BT.2100 HLG, Display P3 PQ/HLG, MaxCLL / MaxPALL), OpenEXR (EXR), and Radiance HDR (.hdr).

  • Tone-Mapping Operators:

    • ITU-R BT.2408 (Default / Recommended): Broadcast-standard tone mapping providing accurate color and luminance reproduction.
    • Reinhard-Jodie: Luminance-preserving Reinhard variant retaining highlight details without oversaturating bright areas.
    • ACES Filmic: Academy Color Encoding System filmic curve delivering cinematic contrast and highlight roll-off.
    • Hable (Uncharted 2): Popular game industry filmic operator offering smooth highlight rolloff and rich shadows.
  • Target White Level: Adjustable reference white luminance tailored to your viewing environment:

    • 203 nits — ITU-R BT.2408 default
    • 100 nits — standard sRGB
    • 80 nits — dim room
    • 300 nits — bright room
  • High Performance: Multi-threaded chunked processing with precomputed 16-bit EOTF LUTs and gamut compression for fast rendering.

Supported Image Formats

Wynpix natively supports standard formats as well as modern and professional image files out of the box without requiring external plugin installations:

  • Modern formats: JPEG XL (JXL), AVIF, HEIF / HEIC, JPEG XR (JXR / HDP), JPEG 2000 (.jp2, .j2k, .jpf, .jpx, .jpc), HTJ2K (.jph).
  • Game Textures & Formats: DDS (DirectDraw Surface), TGA (Targa), QOI (Quite OK Image Format).
  • Digital Art & Projects: PSD (Photoshop), XCF (GIMP), AI (Adobe Illustrator), PDF, KRA (Krita), ORA (OpenRaster).
  • Documents & Archives: DjVu, and images inside ZIP/CBZ, 7z and RAR archives.
  • Legacy & Niche formats: PCX, IFF/ILBM, SGI RGB, Sun Raster, PIC, PXR, SCT, PFM, farbfeld, PSX TIM, and animated ANI cursors.
  • Professional & HDR: OpenEXR (EXR), Radiance HDR (HDR).
  • Camera RAW: RAW (including CR2, NEF, ARW, DNG, RAF, etc. powered by LibRaw).
  • Web & Standard formats: WebP, APNG, ICO (Icons with smart size-matching frame selection), JPEG, PNG, GIF, BMP, SVG.

Installation

Wynpix is optimized exclusively for Windows (64-bit) to deliver maximum performance.

  • Installer (.exe): Run the installer to automatically set up the application, configure file associations, and create shortcuts.
  • Portable Version: Download the portable ZIP archive to run the application from any folder (all configuration is stored in the app folder).
  • SSE2 Version for Older PCs: The standard build requires a processor with AVX2 (Intel Haswell / AMD Excavator, 2013–2015 or newer), and its installer refuses to run without it. For older processors, download the files with the -sse2 suffix (for example, wynpix-setup-sse2.exe) from the same release. The SSE2 build needs at least an Intel Core 2 or an AMD FX (SSSE3); earlier AMD processors such as Athlon 64 and Phenom are not supported.

Grab the latest version from the latest release or browse the releases page.

Building from Source

If you want to compile Wynpix yourself, see the Building from Source guide for full instructions, including dependency setup, build order, and path configuration.

Donate

If you wish to give me a few bucks, please consider donating to the Ukrainian Army instead:

https://savelife.in.ua/en/donate-en/#donate-army-card-once

https://u24.gov.ua/

This directly increases the chances of me being able to work on this in future.

About

Fast, lightweight, and beautiful image viewer for Windows. Features high-quality image scaling, real-time AI upscaling (Upscayl), shader color adjustments, 360° spherical panorama, HDR tone-mapping, and native support for AVIF, JXL, HEIF, PSD, DDS, and RAW.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages